AUI 使用说明
AUI 标签使用说明
姓名:
李春雨
网名:
Hojave
QQ:
邮件:
76988599
bigsnow@126.com
任职单位: 昆明能讯科技
编撰日期:
2011-08-30
作者信息
作者说明:
本文档是根据网络的一些资料翻译的,只能作为参考,
实际应用以实际使用效果为准。
同时欢迎各位同仁共同交流,并希望把在该文档中发
现的问题及时反馈给我,以此共同进步!
1
AUI 使用说明
Alloy UI 标签使用
Alloy UI 标签是 Liferay6.0 版本引入的一组帮助开发者提供快速表单元素创建的 UI 集合。
使用 Alloy UI 主要有如下优势:
有更好的用户体验
统一的样式风格,所有的表单组件都是一样的风险,且在这个地方便能控制展现
动态属性:在 HTML 标签的任何属性都能使用。例如,在 aui:form,aui:select, aui:input
标签上都可以使用 onClick,onChange,onSubmit,title。
在插件工程中要使用 Alloy UI 标签时,只需要在 JSP 中加入下列语句的引用即可:
<%@ taglib uri="http://liferay.com/tld/aui" prefix="aui" %>
Alloy UI 详细内容参见:http://alloy.liferay.com/deploy/api/
1
Form 标签
标签属性:
action:与 HTML 标签中的 action 属性一样。但该属性是自动转码的(如针对&符号进
行转码),如果需要该 URL 的自动转码,则需要设置 escapedXml 为 False。
escapeXml: 默认为 True 。如果不需要设置 URL 自动转码,则设置为 false。注意:在
alloy 0.1a 版本中无效。
cssClass:自定义支持的 CSS 类。设置了该值后,原有的 class 属性无效。
inlineLabel: 如果希望该表单中的所有控件与表单域形成内联,则设置该值为 True。
name:表单名称
示例:
2
AUI 使用说明
2
Fieldset 标签
使用 Fieldset 标签把一些同一类型的表单域形成一个分组。
属性:
cssClass: 自定义支持的 CSS 类。设置了该值后,原有的 class 属性无效。
column: 如果你希望该 fieldset 显示为一列而不是一行,则把该值设置为 true。这样就能够
在一个表单中产生多个 field 列。
示例:
3
Button 标签
属性:
cssClass:自定义支持的 CSS 类。设置了该值后,原有的 class 属性无效。
disabled:设置为 true 则表示该按钮不能点击。
first:如果该元素是表单的第一个元素,则设置该值为 True(主要是为 Alloy UI 样式渲染使
用)
last:如果该元素是表单的最后一个元素,则设置该值为 True(主要是为 Alloy UI 样式渲染
使用)
type: 按钮类型,默认值为 button。允许值范围为:submit、cancel、image。
name:按钮 ID。
value: 按钮显示的内容。如果为空,则 submit 类型按钮显示为:save,Cancel 类型按钮显示
为 cancel。
onClick: 当该按钮点击时所触发的 javascript 代码。如果该值以 http://开始,则按照超连接
的方式处理。
示例:
4
Button Row 标签
放置按钮行的样式。
3
AUI 使用说明
属性:
cssClass:自定义支持的 CSS 类。设置了该值后,原有的 class 属性无效。
示例:
5 Model Context 标签
用为设置表单中能够访问的 JavaBean 对象。
属性:
bean: 能够访问的 JavaBean 对象名称
model: JavaBean 对象的类名
示例:
6
Input 标签
属性:
cssClass:自定义支持的 CSS 类。设置了该值后,原有的 class 属性无效。
Disabled:设置为 true 后,该输入框不能输入。
first:如果该元素是表单的第一个元素,则设置该值为 True(主要是为 Alloy UI 样式渲染使
用)
last:如果该元素是表单的最后一个元素,则设置该值为 True(主要是为 Alloy UI 样式渲染
使用)
helpMessage:当设置了该标签时,表单标签显示时会出现一个帮助图标,用户鼠标移动到
该帮助图标上时,该显示该属性设置的值。
Id: 该输入框的 ID。如果该值为空,则 ID 与 name 定义的一样。
label: 输入框的显示标签(自动国际化)。如果使用了该属性,则没有设置任何值,则不显
示任何标签。如果没有使用该属性,则使用 name 属性作为标签显示(但会自动格式化,如
4
AUI 使用说明
name 属性值为: ThisIsAName 则转化为 this-is-a-name)。
inlineField:如果希望该标签与下一标签内联,则设置该值为 True。
inlineLabel: 如果希望该标签与输入域与左边的标签内联,则把值设置为 left。同样,如果设
置为 right,则表示与输入域右边的标签内联。
checked: 如果希望该标签默认是选中的,则设置为 true(只有当 type=radio 时有效)。
type: 输入域的类型。这些类型主要有:
text
hidden:当设置为该类型时,该输入域的值将会自动转码
password
assetCategories:显示分类,分类的定义见 liferay-ui:asset-categories-selector 标签
checkbox
assetTags:显示标签,标签的定义见 liferay-ui:asset-tags-selector
timeZone:显示时区,时区的定义见 see liferay-ui:input-time-zone
empty:如果希望从表单设置的 JavaBean 中获取类型,则设置为空。如果设置了类
型,则将不能多表单中获取。
Suffix:显示在输入域右边的提示信息。
prefix:显示在输入域左边的提示信息。
该字段可以通过 model Context 自动设置(这些 type 属性必须是设置为空的),JavaBean
在设置时使用 name 来读取内容。
Bean:能够直接获取信息的 JavaBean 对象。
Model:JavaBena 对象的类名
示例:
Examples about the label attribute:
―――― 此时,该输入域的标签显示为:title-normal
―――― 此时,该输入域的标签显示
5
为:another-title
――――此时,该输入域没标签显示
AUI 使用说明
7
Select 标签
属性:
Bean:这个能够被访问 JavaBean(只有当使用 listType 时有效)。
listType: listType 的名称。(可通过 ListTypeImpl.java 获得),使用该属性,将自动生成所有的
Option,并且标识出该 JavaBean 中选中的 Option。该 JavaBean 通过 model context 标签定义。
showEmptyOption:在该下拉框最上面加入一个空值的 Option。
Disabled:设置为 true 时,该下拉框不能操作。
cssClass:自定义支持的 CSS 类。设置了该值后,原有的 class 属性无效。
first:如果该元素是表单的第一个元素,则设置该值为 True(主要是为 Alloy UI 样式渲染使
用)
last:如果该元素是表单的最后一个元素,则设置该值为 True(主要是为 Alloy UI 样式渲染
使用)
helpMessage: 当设置了该标签时,表单标签显示时会出现一个帮助图标,用户鼠标移动到
该帮助图标上时,该显示该属性设置的值。
name: 该下拉框的名称
id:该下拉框的 ID(如果为空,则使用 name 作为 ID。
Label:输入框的显示标签(自动国际化)。如果使用了该属性,则没有设置任何值,则不显
示任何标签。如果没有使用该属性,则使用 name 属性作为标签显示(但会自动格式化,如
name 属性值为: ThisIsAName 则转化为 this-is-a-name)。
inlineField:如果希望该标签与下一标签内联,则设置该值为 True。
inlineLabel: 如果希望该标签与输入域与左边的标签内联,则把值设置为 left。同样,如果设
置为 right,则表示与输入域右边的标签内联。
suffix: 显示在输入域右边的提示信息。
示例:
">
6
AUI 使用说明
"
value="dynamic">
"
value="manual">
8 Option 标签
属性:
cssClass:自定义支持的 CSS 类。设置了该值后,原有的 class 属性无效。
label::Option 的显示内容(自动国际化)。
value: Option 的值。如果该值为空,标签将作为值使用。
Selected:如果该选项是选中的,则设置为 true。
示例:
"
value="manual">
下面 4 种用法是等价的:
AUI 使用说明
10 Field Wrapper 标签
使用该标签对表单上的任何元素进行包装。
属性:
cssClass:自定义支持的 CSS 类。设置了该值后,原有的 class 属性无效。
first:如果该元素是表单的第一个元素,则设置该值为 True(主要是为 Alloy UI 样式渲染使
用)
last:如果该元素是表单的最后一个元素,则设置该值为 True(主要是为 Alloy UI 样式渲染
使用)
helpMessage:当设置了该标签时,表单标签显示时会出现一个帮助图标,用户鼠标移动到
该帮助图标上时,该显示该属性设置的值。
name: 输入域名称
label:输入框的显示标签(自动国际化)。如果使用了该属性,则没有设置任何值,则不显
示任何标签。如果没有使用该属性,则使用 name 属性作为标签显示(但会自动格式化,如
name 属性值为: ThisIsAName 则转化为 this-is-a-name)。
inlineField:如果希望该标签与下一标签内联,则设置该值为 True。
inlineLabel: 如果希望该标签与输入域与左边的标签内联,则把值设置为 left。同样,如果设
置为 right,则表示与输入域右边的标签内联。
示例:
11 Legend 标签
使用该标签为 fieldset 设置显示标签。
属性:
cssClass:自定义支持的 CSS 类。设置了该值后,原有的 class 属性无效。
label: Label to display. (automatically translated)
示例:
8