字段类型
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 2.3,现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
字段类型
的百分比
Type呈现输入文本字段,专门处理百分比数据。如果您的百分比数据存储为十进制(例如。.95
),您可以开箱即用地使用此字段。如果您将数据存储为数字(例如:95
),则应设置类型
选项整数
.
这个字段增加了一个百分号。%
输入框后。
呈现为 | 输入 文本 场 |
选项 | |
覆盖选项 | |
继承的选项 | |
父类型 | 形式 |
类 | PercentType |
场的选择
类型
类型:字符串
默认的:分数
这将控制数据如何存储在对象上。例如,对应于“55%”的百分比可能存储为55
或55
在你的物体上。这两个“类型”处理以下两种情况:
分数
如果您的数据存储为十进制(例如。55
),使用此类型。数据将乘以One hundred.
在显示给用户之前(例如:55
).提交的数据将被One hundred.
,以便存储十进制值(55
);整数
如果您的数据存储为整数(例如55),则使用此选项。原始值(55
)显示给用户并存储在对象上。注意,这只适用于整数值。
继承的选项
方法继承了这些选项形式类型:
数据
类型:混合
默认的:默认为基础对象的字段(如果有的话)
创建表单时,每个字段最初显示表单域对象的相应属性的值(如果对象绑定到表单)。如果你想覆盖表单的初始值或只是一个单独的字段,你可以在data选项中设置它:
1 2 3
$构建器->add (“令牌”,“隐藏”,数组(“数据”= >“六边形abcdef”));
请注意
表单字段的默认值直接取自底层数据结构(例如,实体或数组)。的数据
选项将覆盖此默认值。
empty_data
类型:混合
- . .该文件应该只包含“开始后”或“结束前”
- 设置为此占位符值。它的目的是让我们只包含该文件的一部分。
DEFAULT_PLACEHOLDER
此选项决定了当提交的值为空时字段将返回什么值。
但是您可以根据自己的需要定制它。例如,如果你想要性别
要显式设置的选择字段零
当没有选择值时,你可以这样做:
1 2 3 4 5 6 7 8 9
$构建器->add (“性别”,“选择”,数组(“选择”= >数组(“米”= >“男”,“f”= >“女”),“要求”= >假,“empty_value”= >“选择性别”,“empty_data”= >零));
默认值为”
(空字符串)。
empty_data
类型:混合
- . .该文件应该只包含“开始后”或“结束前”
- 设置为此占位符值。它的目的是让我们只包含该文件的一部分。
DEFAULT_PLACEHOLDER
此选项决定了当提交的值为空时字段将返回什么值。
但是您可以根据自己的需要定制它。例如,如果你想要性别
要显式设置的选择字段零
当没有选择值时,你可以这样做:
1 2 3 4 5 6 7 8 9
$构建器->add (“性别”,“选择”,数组(“选择”= >数组(“米”= >“男”,“f”= >“女”),“要求”= >假,“empty_value”= >“选择性别”,“empty_data”= >零));
error_bubbling
类型:布尔
默认的:假
除非表格是复合
如果真正的
,此字段的任何错误都将传递给父字段或表单。例如,如果设置为真正的
对于普通字段,该字段的任何错误都将附加到主表单,而不是特定的字段。
error_mapping
2.1
的error_mapping
选项在Symfony 2.1中引入。ob娱乐下载
类型:数组
默认的:数组()
此选项允许您修改验证错误的目标。
假设您有一个名为matchingCityAndZipCode
这将验证城市和邮政编码是否匹配。不幸的是,您的表单中没有“matchingCityAndZipCode”字段,因此Symfony所能做的就是在表单顶部显示错误。ob娱乐下载
使用自定义错误映射,你可以做得更好:将错误映射到城市字段,这样它就会显示在它上面:
1 2 3 4 5 6 7 8
公共函数setDefaultOptions(OptionsResolverInterface$解析器){$解析器->setDefaults (数组(“error_mapping”= >数组(“matchingCityAndZipCode”= >“城市”,),));}
下面是映射左侧和右侧的规则:
- 左侧包含属性路径;
- 如果违反是在类的属性或方法上生成的,则其路径简单
propertyName
; - 类的项上生成的违例
数组
或ArrayAccess
对象时,属性路径为(indexName)
; - 您可以通过连接它们来构造嵌套的属性路径,用圆点分隔属性。例如:
地址[工作].matchingCityAndZipCode
; - 右侧仅包含表单中字段的名称。
默认情况下,任何未映射的属性的错误都会冒泡到父表单。你可以用点(.
),将所有未映射属性的错误映射到特定字段。例如,将所有这些错误映射到城市
字段中,使用:
1 2 3 4 5
$解析器->setDefaults (数组(“error_mapping”= >数组(“。”= >“城市”,),));
invalid_message
类型:字符串
默认的:此值无效
这是验证错误消息,如果输入到该字段的数据没有意义(即验证失败),将使用该消息。
例如,如果用户将无意义的字符串输入到时间字段不能转换为实时的,或者如果用户输入字符串(例如。苹果
)转换为数字字段。
正常(业务逻辑)验证(例如在设置字段的最小长度时)应该使用验证消息和验证规则(参考).
invalid_message_parameters
类型:数组
默认的:数组()
当设置invalid_message
选项时,您可能需要在字符串中包含一些变量。这可以通过在该选项中添加占位符并包括该选项中的变量来实现:
1 2 3 4 5
$构建器->add (“some_field”,“some_type”,数组(/ /……“invalid_message”= >'您输入的值无效,它应该包含%num%字母',“invalid_message_parameters”= >数组(“% num %”= >6)));
标签
类型:字符串
默认的:从字段名“猜测”标签
设置呈现字段时将使用的标签。设置为false将屏蔽标签。标签也可以直接在模板内设置:
- 嫩枝
- PHP
1
{{form_label(form.name, '你的名字')}}
1 2 3 4
回声$视图[“形式”]->标签($形式[“名字”),“你的名字”);
label_attr
类型:数组
默认的:数组()
属性的HTML属性<标识>
元素,它将在呈现字段的标签时使用。它是一个以HTML属性为键的关联数组。这些属性也可以直接在模板中设置:
- 嫩枝
- PHP
1 2 3
{{form_label(form.name, '您的名字',{' label_attr': {'class': 'CUSTOM_LABEL_CLASS'}})}}
1 2 3 4 5
回声$视图[“形式”]->标签($形式[“名字”),“你的名字”,数组(“label_attr”= >数组(“类”= >“CUSTOM_LABEL_CLASS”)));
要求
类型:布尔
默认的:真正的
如果为,则HTML5所需属性将被渲染。相应的标签
还会渲染一个要求
类。
这是肤浅的,独立于验证。如果您让Symfony猜测您的字段类型,ob娱乐下载那么这个选项的值将从您的验证信息中猜测出来。
请注意
必选选项还影响如何处理每个字段的空数据。有关详细信息,请参见empty_data选择。