category表单字段类型显示指定组件的分类列表。
表现形式
字段配置参数
专属属性:
- type (必填) 必须为 category.
- extension (必填) 组件的名称,该组件的分类将会被显示出来. 比如, 需要列出文章组件的所有扩展,就是用组件的名称 'com_content'.
- scope (选填) 组件的别名.
- show_root (选填) 是否将显示代表根类别的选择.
- published (选填) (1/0/2/-2) 安装状态过滤 。已经发布的分类(1), 未发布的分类 (0), 存档的分类 (2) 或者 放入回收站的分类 (-2) . 支持同时选择多种状态,使用逗号风格 (如. "0,2,-2").
- multiple (选填) (true/false) 是否允许多选
通用属性:
- name (必填) 能代表该字段的唯一的名称.
- label (选填) (支持多语言机制) 字段的标题
- description (选填) (支持多语言机制) 该字段的描述信息。当鼠标移动到标签上面的时候,会以tooltip的形式显示出来.
- default (选填) (不支持多语言机制) 默认值
- class (选填) 表单字段的css类名。如果省略,默认为'text_area'.
- required (选填l) 是否必须填写内容,用于在提交表单是进行校验. ( "true", "1", "readonly"这些都表示true)
- hint 显示在html占位符元素中的文本,通常是在空白字段内显示的浅色提示
- readonly (选填l) 是否只读,字段的值不能编辑. ("true", "1", "readonly" 这些都表示true)
- disabled (选填) 是否禁用字段。如果为true,那么这个字段的值不能填写,只能展示 - 并且这个值不会在表单中提交. (可设置的值: "true", "1", "readonly" 这些都表示true)
使用方法
<field name="mycategory" type="category" extension="com_content" label="Select a category" description="" />
备注
作者:张敏
原文:http://www.joomlachina.cn/shouce/doc/1916?article_id=1916