DOC 表单字段Form field

说明

在一个HTML表单字段<form>。新的供应大量的表格形式的jform类方便、灵活的创建。每个表单字段类型是jformfield子类。

除了作为一种灵活的网页制作工具，jformfields使用Joomla！允许管理员配置文件！或扩展不改变基本的代码。在Joomla！1.5，这是由现在废弃处理jparameter和jelement分类

在一个扩展的配置定义表单字段，你必须在他们指定的字段集，如 <fieldset name="basic"> ，这是在 <fields name="params"> 部分的 <config> 元在你XML清单文件

表单验证

Joomla有客户端和服务器端的形式验证的能力。
服务器端验证是最小的因为一切之前，可以在用户侧重写。但客户端是最友好的，所以使用的不是一个坏主意（尤其是后者而不会给问题或问题禁用javascript客户端浏览器）。

客户端验证

..是通过JavaScript在用户填写表单字段。
它使用HTML分类必修的和XXX—[验证]（与[XXX]是Joomla或自定义规则；如验证数字）

更多的在这里：客户端的形式验证

服务器端验证

..在提交表单后，通常会返回到表单的时候不进行一些额外的信息。
它使用HTML属性必修的（“真”或“要求”）和验证(with value being a joomla or custom rule; e.g. validate="email")

更多的在这里：服务器端的形式验证

标准的表单字段类型

Type	Description
accesslevel	提供查看访问级别的下拉列表
cachehandler	提供了一个可用的缓存处理选项的列表
calendar	提供一个可输入或选择的日期
captcha	提供了一个验证码的插件
category	提供了一个下拉列表式的分类选项
checkbox	提供一个复选框被选中或未被选中
checkboxes	提供了无限量的复选框,可以用于同时选中
Chrome Style	提供了一个模板选项分组chrome风格模板的列表
color	提供了一个颜色选择器输入框
Content Language	提供了一个内容语言列表
Content Type	提供了一个内容类型列表
combo	提供了一个组合框
componentlayout	提供了一个分组的核心和模板替代布局列表组件
contentlanguage	提供了一个列表的内容语言安装使用与语言切换器插件
Database Connection	提供了一个可用的数据库连接列表,选择限制到一个给定的列表中。
editor	提供了一个编辑器
editors	提供了一个下拉列表中可用的WYSIWYG编辑器
email	提供了一个email输入字段
file	提供了一个文件选择字段
filelist	提供了一个下拉列表式的某一个文件夹下的文件列表
folderlist	供了一个下拉列表式的某一个目录下的文件夹列表
groupedlist	供了一个下拉列表分组
header tag	提供了一个下拉列表的标题标签(h1-h6)
helpsite	提供了一个下拉列表式的网站帮助
hidden	提供了一个隐藏字段
imagelist	提供了一个下拉列表的图像文件在指定的目录中
integer	提供了一个下拉列表一个最小值和最大值之间的整数。
language	提供了一个下拉列表的前端或后端安装语言。
list	提供了一个自定义项的下拉列表。
media	提供一个选择媒体项和上传项的媒体管理器
menu	提供了一个下拉列表式的可用菜单项
Menu Item	提供了一个下拉列表式的可用菜单项
meter	提供了一个限制范围的组件
Module Layout	提供了选择模块布局的下拉列表
Module Order	提供了选择模块排序的下拉列表
Module Position	提供了选择模块位置的下拉列表
Module Tag	提供了一个列表的html5元素(用于包装模块)。
note	支持一个一行的文本字段
number	提供了一个选择数字的字段
password	提供了一个密码输入框
plugins	提供了一个给定插件文件夹的列表
predefinedlist	表单字段来加载一个预定义的值列表
radio	提供了单选按钮来选择不同的选项
range	提供了一个水平滚动条来指定一个值范围
repeatable	允许表单字段,用户可以拥有尽可能多的选择
rules	提供了一个矩阵组织的选项来管理访问控制。显示取决于上下文
sessionhandler	提供了一个选择会话控制器的下拉列表
spacer	提供了一个可视化的表单字段之间的分隔符
sql	提供了一个sql查询字段，第一个查询返回的结果列提供下拉框的值
tag	为标签提供了一个入口点(AJAX或嵌套)。
tel	提供一个电话号码的输入字段
templatestyle	提供了一个下拉列表的模板样式
text	一个文本框字段
textarea	多行的文本框字段
timezone	提供了一个下拉列表的时区选择
URL	提供了一个URL文本输入字段。
user	从模态框中显示一个用户列表并选择某一个用户
useractive	从一个下拉列表中选择活动用户可用的状态
usergroup	提供了一个用户组的下拉列表。编辑注：建议使用usergrouplist
usergrouplist	提供了一个用户组的下拉列表，取代了usergroup
userstate	这个字段加载一个可用的用户状态

自定义表单字段类型

一个扩展可以定义自己的表单域类型，然后可以用自己的方式或形式的另一个扩展创建。看到创建一个自定义的表单域类型说明

模态窗体字段类型

如果你有很多的价值观，不适合选择框有一个领域，你总是可以使一个模态窗体域，将允许用户选择一个项目从一个模态页，过滤选项，等（就像任何管理员表，例如“文章”）。看到创建一个模态窗体域

常见的属性

labelclass

添加属性labelclass添加一个CSS类表单字段的标签。来源http://joomlacode.org/gf/project/joomla/tracker/?action=TrackerItemEdit&tracker_item_id=28450

译文

添加属性showon允许隐藏基于价值的领域（S）的另一个领域。

语法要显示的字段酒吧只有当Foo设置为“1”巴兹设置为“1”：

<field
    name="foo"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option></field><field
    name="bar"
    type="text"
    showon="foo:1"/>

匹配多个值可以提供一个逗号分隔的值列表。喜欢showon="foo:1,2"

将多个字段可以使用[AND]。喜欢showon="foo:1[AND]bar:1"

语法要显示的字段“棒”，只有当“foo”设置为“1”和“巴兹”设置为“1”：

<field
    name="foo"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option></field><field
    name="baz"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option></field><field
    name="bar"
    type="text"
    showon="foo:1[AND]baz:1"/>

创建多个领域可以选择使用[问题]。喜欢showon="foo:1[OR]bar:1"

语法要显示的字段“棒”，只有当“foo”设置为“1”或“巴兹”设置为“1”：

<field
    name="foo"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option></field><field
    name="baz"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option></field><field
    name="bar"
    type="text"
    showon="foo:1[OR]baz:1"/>

这是介绍PullRequest： https://github.com/joomla/joomla-cms/pull/3379，与Joomla 3.2.4始。