groupedlist表单字段类型提供了一个下拉列表或一个自定义条目的列表框,它们可以显示分组数据
表现形式
字段配置参数
专属属性:
通用属性:
- name (必填) 能代表该字段的唯一的名称.
- label (选填) (支持多语言机制) 字段的标题
- description (选填) (支持多语言机制) 该字段的描述信息。当鼠标移动到标签上面的时候,会以tooltip的形式显示出来.
- default (选填) (不支持多语言机制) 默认值
- class (选填) 表单字段的css类名。如果省略,默认为'text_area'.
- required (选填l) 是否必须填写内容,用于在提交表单是进行校验. ( "true", "1", "readonly"这些都表示true)
- hint 显示在html占位符元素中的文本,通常是在空白字段内显示的浅色提示
- readonly (选填l) 是否只读,字段的值不能编辑. ("true", "1", "readonly" 这些都表示true)
- multiple (选填) 是否允许多选(仅对下拉类型有效) (true or false).
- useglobal (选填) 是否显示使用全局参数(仅对支持全局参数的类型有效) (true or false).
- validate (选填) 数据的校验规则.
- disabled (选填) 是否禁用字段。如果为true,那么这个字段的值不能填写,只能展示 - 并且这个值不会在表单中提交. (可设置的值: "true", "1", "readonly" 这些都表示true)
- showon (选填) 允许隐藏这个字段基于其他字段的设置值
使用方法
<field name="mylistvalue" type="groupedlist" default="" label="用户" description="选择用户">
<group label="开发部">
<option value="0">李华</option>
<option value="1">张健</option>
</group>
<group label="售后部">
<option value="3">小程</option>
</group>
<option value="6">张敏</option>
</field>
备注
- <field>元素必须包含至少一个<option>元素。
- <option>元素中的文本是支持多语言翻译的,option元素有一个value属性,用来指定选项的值。
- <group>元素可以将<option>进行分钟,group元素的label属性就是分组的名称
作者:张敏
原文:http://www.joomlachina.cn/shouce/doc/1916?article_id=1933