字段类型
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 2.5,现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
字段类型
的语言
类型的子集ChoiceType
这允许用户从大量的语言列表中进行选择。作为额外的奖励,语言名称将以用户的语言显示。
每种语言的“值”是Unicode语言标识符用于Unicode国际组件(如。fr
或zh_Hant
).
请注意
您的用户的地区是猜测使用地区:getDefault ()
不像选择
类型,您不需要指定选择
或choice_list
选项作为字段类型自动使用大量语言列表。你可以手动指定这些选项中的任何一个,但然后应该使用选择
直接输入。
呈现为 | 可以是各种标签(看到了吗选择字段类型) |
覆盖选项 | |
继承的选项 | 从选择类型,empty_value-error_bubbling-error_mapping-扩大-多个-preferred_choices从形式类型,数据-禁用-empty_data-标签-label_attr-映射-read_only-要求 |
父类型 | 选择 |
类 | LanguageType |
覆盖选项
选择
默认的:ob娱乐下载Symfony \组件\ Intl \ Intl: getLanguageBundle()——> getLanguageNames ()
.
选项选项默认为所有语言。默认区域设置用于翻译语言名称。
继承的选项
方法继承了这些选项选择类型:
empty_value
2.3
从Symfoob娱乐下载ny 2.3开始,如果扩大
选项设置为true。
类型:字符串
或布尔
这个选项决定了一个特殊的“空”选项(例如:“选择一个选项”)将出现在选择小部件的顶部。此选项仅适用于多个
选项设置为false。
添加一个空值,文本为“Choose an option”:
1 2 3
$构建器->add (“州”,“选择”,数组(“empty_value”=>“选择一个选项”));
确保没有“空”值选项显示:
1 2 3
$构建器->add (“州”,“选择”,数组(“empty_value”=>假));
如果你离开empty_value
选项未设置时,则当且仅当要求
选项为false:
1 2 3 4
//添加一个空白(无文本)选项$构建器->add (“州”,“选择”,数组(“要求”=>假));
error_bubbling
类型:布尔
默认的:假
除非表格是复合
如果真正的
,此字段的任何错误都将传递给父字段或表单。例如,如果设置为真正的
对于普通字段,该字段的任何错误都将附加到主表单,而不是特定的字段。
error_mapping
类型:数组
默认的:空
此选项允许您修改验证错误的目标。
假设您有一个名为matchingCityAndZipCode
这将验证城市和邮政编码是否匹配。不幸的是,您的表单中没有“matchingCityAndZipCode”字段,因此Symfony所能做的就是在表单顶部显示错误。ob娱乐下载
使用自定义错误映射,你可以做得更好:将错误映射到城市字段,这样它就会显示在它上面:
1 2 3 4 5 6 7 8
公共函数setDefaultOptions(OptionsResolverInterface$解析器){$解析器->setDefaults (数组(“error_mapping”=>数组(“matchingCityAndZipCode”=>“城市”,),));}
下面是映射左侧和右侧的规则:
- 左侧包含属性路径;
- 如果违反是在类的属性或方法上生成的,则其路径简单
propertyName
; - 类的项上生成的违例
数组
或ArrayAccess
对象时,属性路径为(indexName)
; - 您可以通过连接它们来构造嵌套的属性路径,用圆点分隔属性。例如:
地址[工作].matchingCityAndZipCode
; - 错误映射的左侧也接受一个点
.
,它指的是字段本身。这意味着添加到字段中的任何错误都会添加到给定的嵌套字段中; - 右侧仅包含表单中字段的名称。
preferred_choices
类型:数组
默认的:数组()
如果指定了此选项,则所有选项的子集将被移动到选择菜单的顶部。下面将“Baz”选项移动到顶部,并在它和其他选项之间使用可视分隔符:
1 2 3 4
$构建器->add (“foo_choices”,“选择”,数组(“选择”=>数组(“foo”=>“Foo”,“酒吧”=>“酒吧”,“记者”=>“记者”),“preferred_choices”=>数组(“记者”)));
注意,首选选项仅在呈现为对象时才有意义选择
元素(即。扩大
是假的)。首选选项和普通选项在视觉上由一组虚线分隔开。-------------------
).这可以在呈现字段时自定义:
- 嫩枝
- PHP
1
{{form_widget(形式。Foo_choices, {'separator': '====='})}}
1
<?php回声$视图[“形式”]->小部件($形式[“foo_choices”),数组(“分隔符”=>“= = = = =”))? >
方法继承了这些选项形式类型:
数据
类型:混合默认的:默认为基础对象的字段(如果有的话)
创建表单时,每个字段最初显示表单域对象的相应属性的值(如果对象绑定到表单)。如果你想覆盖表单的初始值或只是一个单独的字段,你可以在data选项中设置它:
1 2 3
$构建器->add (“令牌”,“隐藏”,数组(“数据”=>“六边形abcdef”));
请注意
表单字段的默认值直接取自底层数据结构(例如,实体或数组)。的数据
选项将覆盖此默认值。
empty_data
类型:混合
- . .该文件应该只包含在设置为start-after或end-before时
- 这个占位符值。它的目的是让我们只包含该文件的一部分。
DEFAULT_PLACEHOLDER
此选项决定了当提交的值为空时字段将返回什么值。
但是您可以根据自己的需要定制它。例如,如果你想要性别
要显式设置的选择字段零
当没有选择值时,你可以这样做:
1 2 3 4 5 6 7 8 9
$构建器->add (“性别”,“选择”,数组(“选择”=>数组(“米”=>“男”,“f”=>“女”),“要求”=>假,“empty_value”=>“选择性别”,“empty_data”=>零));
该选项的实际默认值取决于其他字段选项:
- 如果
多个
是假
而且扩大
是假
,然后”
(空字符串); - 否则
数组()
(空数组)。
empty_data
类型:混合
- . .该文件应该只包含在设置为start-after或end-before时
- 这个占位符值。它的目的是让我们只包含该文件的一部分。
DEFAULT_PLACEHOLDER
此选项决定了当提交的值为空时字段将返回什么值。
但是您可以根据自己的需要定制它。例如,如果你想要性别
要显式设置的选择字段零
当没有选择值时,你可以这样做:
1 2 3 4 5 6 7 8 9
$构建器->add (“性别”,“选择”,数组(“选择”=>数组(“米”=>“男”,“f”=>“女”),“要求”=>假,“empty_value”=>“选择性别”,“empty_data”=>零));
标签
类型:字符串
默认的:从字段名“猜测”标签
设置呈现字段时将使用的标签。设置为false将屏蔽标签。标签也可以直接在模板内设置:
- 嫩枝
- PHP
1
{{form_label(form.name, '你的名字')}}
1 2 3 4
回声$视图[“形式”]->标签($形式[“名字”),“你的名字”);
label_attr
类型:数组
默认的:数组()
属性的HTML属性<标识>
元素,它将在呈现字段的标签时使用。它是一个以HTML属性为键的关联数组。这些属性也可以直接在模板中设置:
- 嫩枝
- PHP
1
{{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选择。