text表单字段类型在前台显示一个单行输入框。如果该字段保存了一个值,则在首次加载页面时将显示此值。如果不是,则选择默认值(如果有的话)
表现形式
字段配置参数
- type (必填) 必须为 texta.
- name (必填) 能代表该字段的唯一的名称.
- label (选填) (支持多语言机制) 字段的标题
- description (选填) (支持多语言机制) 该字段的描述信息。当鼠标移动到标签上面的时候,会以tooltip的形式显示出来.
- default (选填) (不支持多语言机制) 默认值
- class (选填) 表单字段的css类名。如果省略,默认为'text_area'.
- required (选填l) 是否必须填写内容,用于在提交表单是进行校验. ( "true", "1", "readonly"这些都表示true)
- hint 显示在html占位符元素中的文本,通常是在空白字段内显示的浅色提示
- filer (选填l) 保存数据的过滤设置。设置为"raw"则表示不进行过滤,存储原始数据 。
- size (optional) 输入框的宽度,字符为单位. 如果省略则由浏览器决定.
- maxlength (选填) 限制输入字符的最大长度.
- readonly (选填l) 是否只读,字段的值不能编辑. ("true", "1", "readonly" 这些都表示true)
- disabled (选填) 是否禁用字段。如果为true,那么这个字段的值不能填写,只能展示 - 并且这个值不会在表单中提交. (可设置的值: "true", "1", "readonly" 这些都表示true)
- inputtype (选填) 设置 HTML5 input类型
- message (选填) 当输入错误时的提示信息.
- pattern (选填) 用于校验数据的正则表达式.
使用方法
<field name="mytextvalue" type="text" default="Some text" label="Enter some text" description="" size="10" />
使用原始过滤器可确保在处理表单时保留html代码
<field name="myhtmlvalue" type="text" default="" label="Enter some text" description="Enter some description" filter="raw" />
备注
- Text字段可以增加子节点元素(option),这些值会以输入建议的形式显示.
作者:张敏
原文:http://www.joomlachina.cn/shouce/doc/1916?article_id=1915