ChoiceType领域(可以选择下拉框、单选按钮和复选框)
编辑该页面警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 5.3,不再维护。
读这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。
ChoiceType领域(可以选择下拉框、单选按钮和复选框)
多用字段用来允许用户“选择”一个或多个选项。它可以呈现为一个选择
标签、单选按钮或复选框。
使用这个字段,您必须指定要么选择
或choice_loader
选择。
呈现为 | 可以各种标记(见下文) |
默认的无效信息 | 选择的选择是无效的。 |
遗留无效的信息 | {{value}}的值是无效的。 |
父类型 | FormType |
类 | ChoiceType |
提示
选项的完整列表和继承了这种类型定义在你的应用可以运行这个命令:
1 2
#替换“FooType”的表单类型的类名美元php bin /控制台调试:FooType形式
示例使用
最简单的方法是定义使用此字段选择
选项指定的选择作为一个关联数组的键是标签显示给最终用户和内部数组值值用于表单字段:
1 2 3 4 5 6 7 8 9 10
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“isAttending”,ChoiceType::类,“选择”= > [“也许”= >零,“是的”= >真正的,“不”= >假、]]);
这将创建一个选择
下拉是这样的:
如果用户选择没有
,将返回假
这一领域。类似地,如果起始数据字段真正的
,然后是的
将自动选择。换句话说,选择每一项的值你想获取/设置在PHP代码中,虽然关键是标签将显示给用户。
先进的例子(对象)
这个领域有一个很多的选择和最控制如何显示的字段。在这个例子中,一些底层数据类别
对象,有getName ()
方法:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34 35 36
使用应用程序\实体\类别;使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“类别”,ChoiceType::类,“选择”= > [新类别(“Cat1”),新类别(“Cat2”),新类别(“Cat3”),新类别(“Cat4”),),/ /“名称”是一个属性路径,Symfony将寻找一个公共意义ob娱乐下载/ /属性或一个公共方法如“getName()定义的输入/ /字符串值将提交的表单“choice_value”= >“名字”,/ /回调返回标签对于一个给定的选择/ /如果使用一个占位符,它空(null)可能会通过但价值/ /标签是由其自己的“占位符”选项“choice_label”= >函数(?类别美元类别){返回美元类别吗?strtoupper (美元类别- >getName ()):”;},/ /返回的html属性为每个选项输入(可能是无线电/复选框)“choice_attr”= >函数(?类别美元类别){返回美元类别吗?(“类”= >“category_”.strtolower (美元类别- >getName ())): [];},/ /每一个选项可以使用一个字符串属性路径或任何可调用的/ /每个选择作为参数传递,但它可能不是必要的“group_by”= >函数(){/ /随机分配事情分成2组返回兰特(0,1)= =1吗?“组”:B组的;},/ /回调返回一个类别是否优先“preferred_choices”= >函数(?类别美元类别){返回美元类别& &One hundred.<美元类别- >getArticleCounts ();}));
你也可以定制choice_name每一个选择。您可以了解更多关于所有这些选项下面的部分。
谨慎
的占位符是一个特定的领域,当选择是可选列表中的第一项必须是空的,所以用户可以取消选择。一定要经常处理空的选择零
当使用回调。
选择标签,复选框或单选按钮
这一领域可能呈现为HTML字段之一,根据扩大
和多个
选项:
元素类型 | 扩大 | 多个 |
---|---|---|
选择标记 | 假 |
假 |
选择标签(多个 属性) |
假 |
真正的 |
单选按钮 | 真正的 |
假 |
复选框 | 真正的 |
真正的 |
自定义每个选项的文本(标签)
通常情况下,数组中的每一项的关键选择
选择是作为文本的显示给用户。但是,可以完全定制的通过choice_label选择。检查出来的更多细节。
分组选项
你可以组<选项>
的元素<选择>
成< optgroup >
通过一个多维选择
数组:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“stockStatus”,ChoiceType::类,“选择”= > [“主要状态”= > [“是的”= >“stock_yes”,“不”= >“stock_no”),“缺货状态”= > [“缺货”= >“stock_backordered”,“停止”= >“stock_discontinued”,]]]);
更漂亮,使用group_by选项。
场的选择
5.1
的ChoiceList类是在Symfony 5.1中引入的,帮助配置选ob娱乐下载择选项。
选择
类型:数组
默认的:[]
这是最基本的方法来指定应该使用的选择。的选择
选择是一个数组,数组的键是物品的标签和值是数组项的值:
1 2 3 4 5 6 7 8 9
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (的有现货的,ChoiceType::类,“选择”= > [“库存”= >真正的,“缺货”= >假、]]);
如果有选择的值不是标量或stringified表示并不是唯一的Symfony将使用整数递增值。ob娱乐下载当表单被提交正确的价值观与正确的类型将被分配到模型中。
choice_attr
类型:数组
,可调用的
,字符串
或PropertyPath默认的:[]
使用这个来添加额外的HTML属性选择。这可以成为一个关联数组的键匹配选择键和值的属性对于每一个选择,一个可调用或路径(就像一个属性choice_label)。
如果一个数组的键选择
数组必须用作键:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27日28
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“水果”,ChoiceType::类,“选择”= > [“苹果”= >1,“香蕉”= >2,“榴莲”= >3),“choice_attr”= > [“苹果”= > [“data-color”= >“红色”),“香蕉”= > [“data-color”= >“黄色”),“榴莲”= > [“data-color”= >“绿色”]]]);/ /或使用一个可调用美元构建器- >add (“参加”,ChoiceType::类,“选择”= > [“是的”= >真正的,“不”= >假,“也许”= >零),“choice_attr”= >函数(美元选择,美元关键,美元价值){/ /添加一个类像attending_yes attending_no等等返回(“类”= >“attending_”.strtolower (美元关键));}));
提示
定义一个自定义类型时,您应该使用ChoiceList类辅助:
1 2 3 4 5 6 7 8 9
使用应用程序\实体\类别;使用ob娱乐下载\组件\形式\ChoiceList\ChoiceList;/ /……美元构建器- >add (“选择”,ChoiceType::类,“choice_attr”= > ChoiceList::attr (美元这,函数(?类别美元类别){返回美元类别吗?(“data-uuid”= >美元类别- >getUuid ()]: [];}));
choice_filter
类型:可调用的
,字符串
或PropertyPath默认的:零
5.1
的choice_filter
选择已经在Symfony 5.1中引入的。ob娱乐下载
当使用预定义的选择类型(即从Symfony核心或供应商库。ob娱乐下载CountryType)这个选项允许您定义一个可调用的每个选择作为唯一的参数,必须返回真正的
保持它或假
抛弃它:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34 35 36
/ / src /形式/类型/ AddressType.php名称空间应用程序\形式\类型;使用ob娱乐下载\组件\形式\AbstractType;使用ob娱乐下载\组件\形式\扩展\核心\类型\CountryType;使用ob娱乐下载\组件\形式\FormBuilderInterface;使用ob娱乐下载\组件\OptionsResolver\OptionsResolver;类AddressType扩展AbstractType{公共函数configureOptions(OptionsResolver美元解析器){美元解析器- >setDefaults ([/ /启用这种接受一组有限的国家“allowed_countries”= >零]);}公共函数buildForm(FormBuilderInterface美元构建器数组,美元选项){美元allowedCountries=美元选项(“allowed_countries”];美元构建器/ /……- >add (“国家”,CountryType::类,/ /如果AddressType传递“allowed_countries”选项,/ /使用它来创建一个过滤器“choice_filter”= >美元allowedCountries吗?函数(美元countryCode)使用(美元allowedCountries){返回in_array (美元countryCode,美元allowedCountries,真正的);}:零]);}
选择时可以一个可调用或一个属性路径选择对象:
1 2 3 4 5 6 7
/ /……美元构建器- >add (“类别”,ChoiceType::类,/ /……“choice_filter”= >“isSelectable”]);
提示
考虑到这AddressType
可能是一个条目的吗CollectionType
你应该使用ChoiceList类辅助启用高速缓存:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
/ / src /形式/类型/ AddressType.php/ /……使用ob娱乐下载\组件\形式\ChoiceList\ChoiceList;/ /……“choice_filter”= >美元allowedCountries吗?ChoiceList::过滤器(/ /通过类型作为第一个参数美元这,函数(美元countryCode)使用(美元allowedCountries){返回in_array (美元countryCode,美元allowedCountries,真正的);},/ /通过选项,使过滤“变化”来计算一个独特的散列美元allowedCountries):零,/ /……
choice_label
类型:字符串
,可调用的
,假
或PropertyPath默认的:零
默认情况下,数组中的每一项的关键选择
选择是作为文本的显示给用户。的choice_label
选项允许你采取更多的控制:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“参加”,ChoiceType::类,“选择”= > [“是的”= >真正的,“不”= >假,“也许”= >零),“choice_label”= >函数(美元选择,美元关键,美元价值){如果(真正的= = =美元选择){返回“当然!”;}返回strtoupper (美元关键);/ /或如果你想把一些关键/ /返回form.choice。。美元的关键;}));
调用此方法每一个选择,通过你选择美元
和美元的关键
从数组(额外的选择美元的价值
有关choice_value)。这将给你:
如果你选择值对象choice_label
也可以是属性路径。想象你有状态
类getDisplayName ()
方法:
1 2 3 4 5 6 7 8 9 10 11
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“参加”,ChoiceType::类,“选择”= > [新状态(状态::是的),新状态(状态::没有),新状态(状态::也许),),“choice_label”= >“displayName的”]);
如果设置为假
,所有的标签标签将被丢弃广播或复选框输入。您也可以返回假
可赎回抛弃某些标签。
提示
定义一个自定义类型时,您应该使用ChoiceList类辅助:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\ChoiceList\ChoiceList;/ /……美元构建器- >add (“选择”,ChoiceType::类,“choice_label”= > ChoiceList::标签(美元这,“displayName的”)));
choice_loader
的choice_loader
选项可以用来代替选择
选择。它允许创建一个列表懒洋洋地或部分抓取时只选择一组提交的值(即查询搜索引擎ElasticSearch
可以是一个沉重的过程)。
您可以使用的一个实例CallbackChoiceLoader如果你想利用延迟加载:
1 2 3 4 5 6 7 8 9 10
使用应用程序\StaticClass;使用ob娱乐下载\组件\形式\ChoiceList\加载程序\CallbackChoiceLoader;使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“loaded_choices”,ChoiceType::类,“choice_loader”= >新CallbackChoiceLoader (函数(){返回StaticClass::getConstants ();}));
这将会导致的召唤StaticClass: getConstants ()
如果请求重定向和不发生如果没有预先设置或提交数据。否则选择选项将需要解决从而触发回调。
当你定义一个自定义选择类型可能被重用在许多领域(如集合的条目)或在多种形式中重用,你应该使用ChoiceList静态方法来包装装载机为更好的性能和做出选择列表缓存:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34 35 36 37 38 39 40 41
使用应用程序\形式\ChoiceList\CustomChoiceLoader;使用应用程序\StaticClass;使用ob娱乐下载\组件\形式\AbstractType;使用ob娱乐下载\组件\形式\ChoiceList\ChoiceList;使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;使用ob娱乐下载\组件\OptionsResolver\选项;使用ob娱乐下载\组件\OptionsResolver\OptionsResolver;类ConstantsType扩展AbstractType{公共静态函数getExtendedTypes():iterable{返回[ChoiceType::类);}公共函数configureOptions(OptionsResolver美元解析器){美元解析器- >setDefaults ([/ /下面的例子将创建一个CallbackChoiceLoader可调用的“choice_loader”= > ChoiceList::懒惰(美元这,函数(){返回StaticClass::getConstants ();}),/ /你能通过自己的装载机,取决于其他选项“some_key”= >零,“choice_loader”= >函数(选项美元选项){返回ChoiceList::加载程序(/ /通过实例的类型或类型扩展/ /当前配置的选择列表作为第一个参数美元这,/ /通过装载机的其他选择新CustomChoiceLoader (美元选项(“some_key”]),/ /确保存储加载程序每个键类型/ /通过使用特殊的第三个参数“美元有所不同”/ /数组包含任何“变化”加载程序(美元选项(“some_key”]]);}));}}
choice_name
类型:可调用的
,字符串
或PropertyPath默认的:零
控制的内部字段名称的选择。你通常不关心这个,但是在一些先进的情况下,您可能。例如,这个“name”成为选择的索引视图模板中使用的字段名称属性。
这是一个可调用或一个属性路径。看到choice_label类似的用法。默认情况下,选择键或一个递增整数可以使用(起价0
)。
提示
定义一个自定义类型时,您应该使用ChoiceList类辅助:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\ChoiceList\ChoiceList;/ /……美元构建器- >add (“选择”,ChoiceType::类,“choice_name”= > ChoiceList::字段名(美元这,“名字”)));
谨慎
配置的值必须是一个有效的表单名称。确保使用一个可调用时只返回有效的名称。有效的表单名称必须是由字母,数字,下划线,破折号和冒号,不得从少量开始或冒号。
choice_translation_domain
DEFAULT_VALUE
这个选项决定了如果选择值应该翻译和翻译领域。
的值choice_translation_domain
选项可以真正的
(重用当前翻译域),假
(禁用翻译),零
(使用翻译父域或默认域)或一个字符串代表确切的翻译领域使用。
:目的:DEFAULT_VALUE
类型:字符串
,布尔
或零
默认的:真正的
choice_translation_domain
DEFAULT_VALUE
这个选项决定了如果选择值应该翻译和翻译领域。
的值choice_translation_domain
选项可以真正的
(重用当前翻译域),假
(禁用翻译),零
(使用翻译父域或默认域)或一个字符串代表确切的翻译领域使用。
:开始追赶:DEFAULT_VALUE
choice_translation_parameters
类型:数组
,可调用的
,字符串
或PropertyPath默认的:[]
选择值是在显示之前翻译的,所以它可以包含翻译占位符。这个选项定义了用于替换这些占位符的值。这可以成为一个关联数组的键匹配选择键和值的属性对于每一个选择,一个可调用或路径(就像一个属性choice_label)。
鉴于这种翻译的信息:
- YAML
- XML
- PHP
1 2 3
#翻译/ messages.en.yamlform.order.yes:我确认我的订单公司% %的form.order.no:我取消我的订单
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
< !——/ messages.en翻译。xlf - - >< ?xml version = " 1.0 " ? ><xliff版本=“1.2”xmlns=“urn: oasis:名称:tc: xliff文档:1.2”><文件通过读=“en”数据类型=“明文”原始=“file.ext”><身体><trans-unitid=“form.order.yes”><源>form.order.yes< /源><目标>我确认我公司% %< /目标>< /trans-unit><trans-unitid=“form.order.no”><源>form.order.no< /源><目标>我取消我的订单< /目标>< /trans-unit>< /身体>< /文件>< /xliff>
1 2 3 4 5
/ /翻译/ messages.fr.php返回(“form.order.yes”= >“我确认我的订单公司% %”,“form.order.no”= >“我取消我的订单,);
您可以指定占位符的值如下:
1 2 3 4 5 6 7 8 9 10 11 12 13
美元构建器- >add (“id”,零,(“选择”= > [“form.order.yes”= >真正的,“form.order.no”= >假),“choice_translation_parameters”= >函数(美元选择,美元关键,美元价值){如果(假= = =美元选择){返回[];}返回(%公司%的= >“ACME公司”。]}]);
如果一个数组的键选择
数组必须用作键:
1 2 3 4 5 6 7 8 9 10
美元构建器- >add (“id”,零,(“选择”= > [“form.order.yes”= >真正的,“form.order.no”= >假),“choice_translation_parameters”= > [“form.order.yes”= > [%公司%的= >“ACME公司”。),“form.order.no”= > []]]);
孩子的翻译参数字段合并相同的选择他们的父母,这样孩子们就可以重用和/或覆盖的任何父占位符。
choice_value
类型:可调用的
,字符串
或PropertyPath默认的:零
返回字符串的“价值”对于每一个选择,这在所有的选择必须是唯一的。这是使用的价值
属性在HTML和提交POST或PUT请求。你通常不需要担心这个,但它可能是方便的在处理一个API请求(因为您可以配置的值将被发送在API请求)。
这是一个可调用或一个属性路径。默认情况下,如果他们使用的选择是可以转化的字符串。否则一个递增(开始使用整数0
)。
如果你通过一个可调用,它将接收一个参数:选择本身。当使用EntityType领域,参数将为每一个选择或实体对象零
在使用一个占位符,你需要处理:
1 2 3
“choice_value”= >函数(? MyOptionEntity美元实体){返回美元实体吗?美元实体- >getId ():”;},
提示
定义一个自定义类型时,您应该使用ChoiceList类辅助:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\ChoiceList\ChoiceList;/ /……美元构建器- >add (“选择”,ChoiceType::类,“choice_value”= > ChoiceList::值(美元这,“uuid”)));
group_by
类型:字符串
,可调用的
或PropertyPath默认的:零
你可以组<选项>
的元素<选择>
成< optgroup >
通过一个多维数组选择
。看到分组选项部分。
的group_by
选择另一种方法是集团的选择,给你更多的灵活性。
下面的例子:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“publishAt”,ChoiceType::类,“选择”= > [“现在”= >新\ DateTime (“现在”),“明天”= >新\ DateTime (“+ 1天”),“1周”= >新\ DateTime (“+ 1周”),“一个月”= >新\ DateTime (“+ 1月”),),“group_by”= >函数(美元选择,美元关键,美元价值){如果(美元选择< =新\ DateTime (+ 3天的)){返回“很快”;}返回“后来”;}));
这组日期3天内到“很快”和其他“后来”< optgroup >
:
如果你返回零
,选择不会分组。你还可以通过一个字符串”属性路径”,被称为组。看到choice_label使用一个属性路径的详细信息。
提示
定义一个自定义类型时,您应该使用ChoiceList类辅助:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\ChoiceList\ChoiceList;/ /……美元构建器- >add (“选择”,ChoiceType::类,“group_by”= > ChoiceList::groupBy (美元这,“类别”)));
占位符
类型:字符串
或布尔
这个选项决定是否一个特殊的“空”选项(如。“选择一个选项”)将出现在顶部的选择小部件。此选项仅适用于如果多个
选项设置为false。
添加一个空值与“选择一个选项”:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“州”,ChoiceType::类,“占位符”= >选择一个选项的]);
保证没有“空”的价值选择是显示:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“州”,ChoiceType::类,“占位符”= >假]);
如果你离开占位符
选项设置,然后一个空白(无文本)选项将自动添加当且仅当要求
选项是错误的:
1 2 3 4 5 6 7
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……/ /一个空白(没有文本)选项将被添加美元构建器- >add (“州”,ChoiceType::类,“要求”= >假]);
preferred_choices
类型:数组
,可调用的
,字符串
或PropertyPath默认的:[]
这个选项允许您显示特定的选择列表的顶部与视觉之间的分隔符和选项的完整列表。如果你有一种语言,你可以列出最受欢迎的顶部,如博克和海盗:
1 2 3 4 5 6 7 8 9 10 11 12
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“语言”,ChoiceType::类,“选择”= > [“英语”= >“en”,“西班牙”= >“西文”,“博克”= >“布偶”,“海盗”= >“加勒比海盗”),“preferred_choices”= > [“布偶”,“加勒比海盗”)));
这个选项也可以一个回调函数给你更多的灵活性。这可能是特别有用如果你值对象:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……美元构建器- >add (“publishAt”,ChoiceType::类,“选择”= > [“现在”= >新\ DateTime (“现在”),“明天”= >新\ DateTime (“+ 1天”),“1周”= >新\ DateTime (“+ 1周”),“一个月”= >新\ DateTime (“+ 1月”),),“preferred_choices”= >函数(美元选择,美元关键,美元价值){/ /选择选项3天内返回美元选择< =新\ DateTime (+ 3天的);}));
这将“喜欢”“现在”和“明天”的选择只有:
最后,如果你的价值观是对象,您还可以指定属性路径字符串对象,它将返回true或false。
首选的选择呈现时才有其意义选择
元素(即。扩大
假)。优先选择和正常的选择是由一组分离视觉虚线(即。- - - - - - - - - - - - - - - - - - -
)。这可以定制在呈现字段:
- 嫩枝
- PHP
1
{{form_widget(形式。publishAt,{“分离器”:“= = = = = '})}}
1 2 3
< ?=美元视图(“形式”]- >小部件(美元形式(“publishAt”]、[“分隔符”= >“= = = = =”,)吗?>
提示
定义一个自定义类型时,您应该使用ChoiceList类辅助:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\ChoiceList\ChoiceList;/ /……美元构建器- >add (“选择”,ChoiceType::类,“preferred_choices”= > ChoiceList::优先(美元这,“taggedAsFavorite”)));
覆盖选项
empty_data
类型:混合
这个选项的默认值取决于其他字段选项:
- 如果
多个
是假
和扩大
是假
,然后”
(空字符串); - 否则
[]
(空数组)。
这个选项决定了价值领域返回当提交的值为空(或失踪)。它没有设置一个初始值时如果没有提供一个视图的形式呈现。
这意味着它可以帮助您处理表单提交空白的领域。例如,如果你想要的的名字
字段被显式地设置John Doe
当选择没有价值,你可以这样做:
1 2 3 4
美元构建器- >add (“名字”,零,(“要求”= >假,“empty_data”= >“John Doe”]);
这仍将呈现一个空的文本框,但在提交John Doe
值将被设置。使用数据
或占位符
选项来显示这个初始值呈现形式。
如果一种复合,可以设置empty_data
作为数组、对象或关闭。看到如何配置空数据形式类文章关于这些选项的更多细节。
请注意
如果你想设置empty_data
选择整个表格类,看到如何配置空数据形式类篇文章。
谨慎
表单数据变形金刚仍将被应用到吗empty_data
价值。这意味着将把一个空的string零
。使用自定义数据变压器如果你明确想返回一个空字符串。
invalid_message
类型:字符串
默认的:这个值是无效的
这是验证错误消息,如果数据使用进入这个领域没有意义(即未验证)。
这可能发生,例如,如果用户输入一个无意义的字符串TimeType字段不能被转换成实时或如果用户输入一个字符串(例如苹果
)进入很多领域。
正常(业务逻辑)验证(例如当设置一个最小长度字段)应设置使用验证消息的验证规则(参考)。
继承的选项
这些选项的继承FormType:
attr
类型:数组
默认的:[]
如果你想添加额外的属性可以使用HTML字段表示attr
选择。这是一个与HTML属性关联数组的键。这可能是有用的,当你需要设置一个自定义类部件:
1 2 3
美元构建器- >add (“身体”,TextareaType::类,“attr”= > [“类”= >“tinymce”)));
另请参阅
使用row_attr
选择如果你想将这些属性添加到表单类型行元素。
by_reference
类型:布尔
默认的:真正的
在大多数情况下,如果你有一个作者
场,然后你期望setAuthor ()
被称为底层对象。然而,在某些情况下,setAuthor ()
可能不被称为。设置by_reference
来假
在所有情况下确保调用setter。
进一步解释这个,这里有一个简单的例子:
1 2 3 4 5 6 7 8 9 10 11 12 13
使用ob娱乐下载\组件\形式\扩展\核心\类型\EmailType;使用ob娱乐下载\组件\形式\扩展\核心\类型\FormType;使用ob娱乐下载\组件\形式\扩展\核心\类型\TextType;/ /……美元构建器=美元这- >createFormBuilder (美元文章);美元构建器- >add (“标题”,TextType::类)- >add (美元构建器- >创建(“作者”,FormType::类,“by_reference”= > ?)- >add (“名字”,TextType::类)- >add (“电子邮件”,EmailType::类))
如果by_reference
是真的,以下发生在幕后当你打电话吗提交()
(或handleRequest ()
)形式:
1 2 3
美元文章- >setTitle (“……”);美元文章- >getAuthor ()- >setName (“……”);美元文章- >getAuthor ()- >setEmail (“……”);
请注意,setAuthor ()
不叫。作者通过引用修改。
如果你设置by_reference
为false,提交看起来像这样:
1 2 3 4 5
美元文章- >setTitle (“……”);美元作者=克隆美元文章- >getAuthor ();美元作者- >setName (“……”);美元作者- >setEmail (“……”);美元文章- >setAuthor (美元作者);
所以,所有的by_reference = false
真的是它克隆对象,执行框架调用setter父对象。
类似地,如果您正在使用CollectionType领域潜在的收集数据是一个对象(如与学说ArrayCollection
),然后by_reference
必须设置为假
如果你需要加法器和剂(如。addAuthor ()
和removeAuthor ()
)被称为。
数据
类型:混合
默认的:默认字段的底层结构。
当你创建一个表单,最初显示每个字段的值对应的表单的域数据的属性(例如,如果您将对象绑定到表单)。如果你想覆盖这个表单或单个字段的初始值,你可以设置它在数据选项:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\HiddenType;/ /……美元构建器- >add (“令牌”,HiddenType::类,“数据”= >“六边形abcdef”]);
谨慎
的数据
选项总是覆盖的值从域数据(对象)呈现。这意味着对象的值也覆盖当表单编辑已经持久化的对象,使其在表单提交时失去保存价值。
error_mapping
类型:数组
默认的:[]
这个选项允许您修改验证错误的目标。
想象你有一个自定义的命名方法matchingCityAndZipCode ()
验证城市和邮编是否匹配。不幸的是,没有matchingCityAndZipCode
在表单字段,所以Symfony所能做的一切是显示错误的形式。ob娱乐下载
自定义错误映射,你可以做得更好:误差映射到城市字段以便它上面显示:
1 2 3 4 5 6 7 8
公共函数configureOptions(OptionsResolver美元解析器){美元解析器- >setDefaults ([“error_mapping”= > [“matchingCityAndZipCode”= >“城市”、]]);}
这里的规则是左边和右边的映射:
- 左侧包含属性的路径;
- 如果违反上生成一个类的属性或方法,它的路径
propertyName
; - 如果违反上生成一个条目的
数组
或ArrayAccess
对象,属性路径(indexName)
; - 您可以构建嵌套属性路径通过连接,分离属性点。例如:
地址[工作].matchingCityAndZipCode
; - 右侧包含表单中字段的名称。
默认情况下,没有任何属性映射错误将泡沫到父窗体。您可以使用点(。
)左边错误的所有地图上未标明的属性映射到一个特定的领域。例如,所有这些错误的地图城市
字段中,使用:
1 2 3 4 5
美元解析器- >setDefaults ([“error_mapping”= > [“。”= >“城市”、]]);
帮助
类型:字符串
默认的:零
允许您定义一个表单字段的帮助信息,默认情况下是呈现以下字段:
1 2 3
美元构建器- >add (“zipCode”,零,(“帮助”= >你的信用卡的邮政编码\ ' s帐单地址。]);
help_attr
类型:数组
默认的:[]
设置元素的HTML属性用于显示帮助信息的表单字段。它的值是一个关联数组与HTML属性名称作为键。这些属性也可以在模板设置:
1 2 3
{{form_help (form.name,“你的名字”,{help_attr:{‘类’:‘CUSTOM_LABEL_CLASS}})}}
inherit_data
类型:布尔
默认的:假
这个选项决定了如果表单将继承其父的数据形式。这可能是有用的,如果你有一组字段复制到多个形式。看到如何减少代码重复“inherit_data”。
谨慎
当一个字段inherit_data
选项设置,它使用父窗体的数据。这意味着数据变形金刚不会被应用到这一领域。
标签
类型:字符串
默认的:标签是“猜”字段名称
设置标签时,将使用渲染。设置为假
将抑制标签。标签也可以在模板设置:
- 嫩枝
- PHP
1
{{了form_label (form.name '你的名字')}}
1 2 3 4
回声美元视图(“形式”]- >标签(美元形式(“名字”),“你的名字”);
label_attr
类型:数组
默认的:[]
集的HTML属性<标识>
元素,它将使用时呈现字段的标签。这是一个关联数组与HTML属性作为一个关键。这个属性也可以直接设置在模板:
- 嫩枝
- PHP
1 2 3
{{了form_label (form.name,“你的名字”,{label_attr:{‘类’:‘CUSTOM_LABEL_CLASS}})}}
1 2 3 4 5
回声美元视图(“形式”]- >标签(美元形式(“名字”),“你的名字”,(“label_attr”= > [“类”= >“CUSTOM_LABEL_CLASS”]]);
label_format
类型:字符串
默认的:零
配置字段的字符串作为标签,以防标签
选择是没有设置,这是有用的在使用关键字翻译的消息。
如果你使用关键字翻译信息标签,你经常有多个关键字信息相同的标签(如。profile_address_street
,invoice_address_street
)。这是因为每个“路径”的标签是建立一个字段。为了避免重复的关键字信息,您可以配置标签格式一个静态值,如:
1 2 3 4 5 6 7 8
/ /……美元profileFormBuilder- >add (“地址”,AddressType::类,“label_format”= >“form.address. %名称%”]);美元invoiceFormBuilder- >add (“发票”,AddressType::类,“label_format”= >“form.address. %名称%”]);
这个选项是遗传的子类型。上面的代码的标签街
两种形式将使用领域form.address.street
关键字信息。
两个变量标签格式是可用的:
-
% id %
-
字段的惟一标识符,包括完整的路径字段和字段名(如。
profile_address_street
); -
%的名字%
-
字段名(如。
街
)。
默认值(零
)的结果“人性化”版本的字段名。
请注意
的label_format
选择是评估形式的主题。如果你一定要更新您的模板定制的形式主题。
要求
类型:布尔
默认的:真正的
如果这是真的,一个HTML5必需属性将会呈现。相应的标签
还将呈现的要求
类。
这是肤浅的和独立的验证。在最好的情况下,如果你让Symfony猜ob娱乐下载你的字段类型,那么这个选项的值将从你的猜测验证信息。
请注意
所需的选择也会影响每个字段是空的数据如何处理。更多细节,请参阅empty_data选择。
row_attr
类型:数组
默认的:[]
一个关联数组的HTML属性添加到元素用于呈现表单类型行:
1 2 3
美元构建器- >add (“身体”,TextareaType::类,“row_attr”= > [“类”= >“文本编辑器”,“id”= >“……”)));
另请参阅
使用attr
选择如果你想将这些属性添加到表单类型小部件元素。
label_translation_parameters
类型:数组
默认的:[]
的内容标签选择是在显示之前翻译,所以它可以包含翻译占位符。这个选项定义了用于替换这些占位符的值。
鉴于这种翻译的信息:
1 2
#翻译/ messages.en.yamlform.order.id:的标识符以%公司%的
您可以指定占位符的值如下:
1 2 3 4 5 6
美元构建器- >add (“id”,零,(“标签”= >“form.order.id”,“label_translation_parameters”= > [%公司%的= >“ACME公司”。、]]);
的label_translation_parameters
选择儿童字段合并相同的选择他们的父母,这样孩子们就可以重用和/或覆盖的任何父占位符。
attr_translation_parameters
类型:数组
默认的:[]
的内容标题
和占位符
中定义的值attr选择是在显示之前翻译,所以它可以包含翻译占位符。这个选项定义了用于替换这些占位符的值。
鉴于这种翻译的信息:
1 2 3
#翻译/ messages.en.yamlform.order.id.placeholder:“输入惟一标识符以%公司%的form.order.id.title:这将在通信参考%公司%的
您可以指定占位符的值如下:
1 2 3 4 5 6 7 8 9
美元构建器- >add (“id”,零,(“attr”= > [“占位符”= >“form.order.id.placeholder”,“标题”= >“form.order.id.title”),“attr_translation_parameters”= > [%公司%的= >“ACME公司”。、]]);
的attr_translation_parameters
选择儿童字段合并相同的选择他们的父母,这样孩子们就可以重用和/或覆盖的任何父占位符。
help_translation_parameters
类型:数组
默认的:[]
的内容帮助选择是在显示之前翻译,所以它可以包含翻译占位符。这个选项定义了用于替换这些占位符的值。
鉴于这种翻译的信息:
1 2
#翻译/ messages.en.yamlform.order.id.help:这将在通信参考%公司%的
您可以指定占位符的值如下:
1 2 3 4 5 6
美元构建器- >add (“id”,零,(“帮助”= >“form.order.id.help”,“help_translation_parameters”= > [%公司%的= >“ACME公司”。、]]);
的help_translation_parameters
选择儿童字段合并相同的选择他们的父母,这样孩子们就可以重用和/或覆盖的任何父占位符。
场变量
变量 | 类型 | 使用 |
---|---|---|
多个 | 布尔 |
的值多个选择。 |
扩大 | 布尔 |
的值扩大选择。 |
preferred_choices | 数组 |
一个嵌套数组包含ChoiceView 对象的选择应该呈现给用户提供优先级。 |
选择 | 数组 |
一个嵌套数组包含ChoiceView 对象的选择。 |
分隔符 | 字符串 |
选择组之间的分隔符使用。 |
占位符 | 混合 |
空值,如果未在列表中,否则零 。 |
choice_translation_domain | 混合 |
布尔 ,零 或字符串 是否应该翻译价值。 |
is_selected | 可调用的 |
一个需要一个可调用的ChoiceView 和所选值(s),并返回的选择是是否选中的值(s)。 |
placeholder_in_choices | 布尔 |
空值是否在选择列表中。 |
提示
这是明显更快的使用如何自定义形式呈现相反,当使用树枝进行测试。