选择类型字段(选择下拉列表,单选按钮和复选框)
编辑本页选择类型字段(选择下拉列表,单选按钮和复选框)
一个多用途的字段,用于允许用户“选择”一个或多个选项。它可以被渲染为选择
标签、单选按钮或复选框。
要使用此字段,必须指定要么选择
或choice_loader
选择。
呈现为道明><道明>可以是各种标签(见下文)道明> |
类道明><道明>ChoiceType |
提示
这个表单类型定义和继承的完整选项列表可以在你的应用程序中运行这个命令:
1 2
将'FooType'替换为你的表单类型的类名$php bin/console debug:form FooType . php
示例使用
使用此字段的最简单方法是定义选择
选项,将选项指定为关联数组,其中键是显示给最终用户的标签,数组值是表单字段中使用的内部值:
1 2 3 4 5 6 7 8 9 10
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“isAttending”, ChoiceType::类,“选择”= > [“也许”= >零,“是的”= >真正的,“不”= >假,],]);
这将创建一个选择
下拉菜单如下:
如果用户选择没有
时,表单将返回假
对于这个领域。类似地,如果此字段的起始数据为真正的
,然后是的
将自动选择。换句话说,选择每个项的值是您想在PHP代码中获取/设置的值,而关键是标签这将显示给用户。
高级示例(带对象!)
这个领域有一个很多选项和大多数控件控制字段的显示方式。在本例中,底层数据是一些类别
对象,该对象具有getName ()
方法:
12 34 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”),),// "name"是一个属性路径,意味着Symfony将寻找一个publicob娱乐下载//属性或公共方法(如"getName()")来定义输入//由表单提交的字符串值“choice_value”= >“名字”,//一个回调函数返回给定选项的标签//如果使用占位符,它的空值(null)可以被传递但是//它的标签是由它自己的"placeholder"选项定义的“choice_label”= >函数(?类别$类别){返回$类别?strtoupper ($类别->getName ()):”;},//返回每个选项输入的HTML属性(可以是单选/复选框)“choice_attr”= >函数(?类别$类别){返回$类别?[“类”= >“category_”.strtolower ($类别->getName())]: [];},//每个选项可以使用字符串属性路径或任何可调用的get//传递每个选项作为参数,但可能不需要“group_by”= >函数(){//随机把东西分成两组返回兰特(0,1) = =1?“组”:B组的;},//返回一个类别是否为首选的回调函数“preferred_choices”= >函数(?类别$类别){返回$类别& &One hundred.<$类别->getArticleCounts ();}));
还可以自定义choice_name每一种选择。您可以在下面的部分中了解更多关于所有这些选项的信息。
谨慎
的占位符是一个特定字段,当选项为可选时,列表中的第一项必须为空,以便用户可以取消选择。一定要处理空的选择零
当使用回调时。
选择标签、复选框或单选按钮
该字段可以呈现为多个HTML字段之一,具体取决于扩大
而且多个
选项:
元素类型 | 扩大 | 多个 |
---|---|---|
选择标记道明><道明>假 |
假 |
|
选择标签(使用多个 属性)道明><道明>假 |
真正的 |
|
单选按钮道明><道明>真正的 |
假 |
|
复选框道明><道明>真正的 |
真正的 |
自定义每个选项的文本(标签)
数组中每个项的数组键选择
选项用作显示给用户的文本。但是这完全可以通过choice_label选择。查看更多细节。
分组选项
您可以将<选项>
a的要素<选择>
成< optgroup >
通过传递多维度选择
数组:
12 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娱乐下载置选项。
选择
类型:数组
默认的:[]
这是指定该字段应使用的选项的最基本方法。的选择
Option是一个数组,其中数组键是项目的标签,数组值是项目的值:
1 2 3 4 5 6 7 8 9
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (的有现货的, ChoiceType::类,“选择”= > [“库存”= >真正的,“缺货”= >假,],]);
如果选择值不是标量,或者字符串化表示不是唯一的,Symfony将使用递增整数作为值。ob娱乐下载当表单被提交时,具有正确类型的正确值将被分配给模型。
choice_attr
类型:数组
,可调用的
,字符串
或PropertyPath默认的:[]
使用它可以为每个选项添加额外的HTML属性。这可以是一个关联数组,其中键与选择键匹配,值是每个选项的属性,一个可调用的或一个属性路径(就像choice_label).
的键值选择
Array必须用作键:
12 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)此选项允许您定义一个可调用对象,该对象将每个选项作为唯一参数,并且必须返回真正的
保留它还是假
丢弃:
12 34 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
可以是a的一个元素CollectionType
你应该使用ChoiceList类helper来启用缓存:
12 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
选项可让您获得更多的控制权:
12 3 4 5 6 7 8 9 10 11 12 13 14 16 17 18 19 20 21
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“参加”, ChoiceType::类,“选择”= > [“是的”= >真正的,“不”= >假,“也许”= >零),“choice_label”= >函数($选择,$关键,$价值){如果(真正的= = =$选择) {返回“当然!”;}返回strtoupper ($关键);//如果你想翻译一些键/ /返回form.choice。。美元的关键;//返回新的TranslatableMessage($key, false === $choice ?[]: ['%status%' => $value], 'store');}));
5.2
支持TranslatableMessage
对象choice_label
在Symfony 5.2中引入。ob娱乐下载
此方法被调用每一个选择,传递给你选择美元
而且美元的关键
从选项数组(附加美元的价值
与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静态方法来包装加载器,并使选择列表可缓存以获得更好的性能:
12 34 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{公共函数getParent():字符串{返回ChoiceType::类;}公共函数configureOptions(OptionsResolver$解析器){$解析器->setDefaults ([//下面的例子将从可调用对象创建一个CallbackChoiceLoader“choice_loader”= > ChoiceList::懒惰($这,函数(){返回StaticClass::getConstants ();}),//你也可以传递你自己的加载器,这取决于其他选项“some_key”= >零,“choice_loader”= >函数(选项$选项){返回ChoiceList::加载程序(//传递类型或类型扩展的实例//当前配置选择列表作为第一个参数$这,//将另一个选项传递给加载器新CustomChoiceLoader ($选项[“some_key”]),//确保该类型每个键存储一个加载器//通过使用特殊的第三个参数"$vary"//一个数组,包含任何“改变”加载器[$选项[“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
类型:字符串
,布尔
或零
默认的:真正的
此选项决定是否应该翻译所选值以及在哪个翻译域中翻译。
的值choice_translation_domain
选项可以是真正的
(重用当前翻译域),假
(禁用翻译),零
(使用父翻译域或默认域)或表示要使用的确切翻译域的字符串。
choice_translation_parameters
类型:数组
,可调用的
,字符串
或PropertyPath默认的:[]
选择值在显示之前被转换,因此它可以包含翻译占位符.此选项定义用于替换这些占位符的值。这可以是一个关联数组,其中键与选择键匹配,值是每个选项的属性,一个可调用的或一个属性路径(就像choice_label).
考虑到以下翻译信息:
- YAML
- XML
- PHP
1 2 3
#翻译/ messages.en.yamlform.order.yes:“我确认我的订单到公司%公司%”form.order.no:“我取消订单”
12 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源><目标>我向公司%company%确认我的订单目标>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”= >“我取消订单”,);
可以按照如下方式指定占位符值:
12 3 4 5 6 7 8 9 10 11 12 13
$构建器->add (“id”,零, [“选择”= > [“form.order.yes”= >真正的,“form.order.no”= >假),“choice_translation_parameters”= >函数($选择,$关键,$价值){如果(假= = =$选择) {返回[];}返回[%公司%的= >“ACME公司”。];}));
的键值选择
Array必须用作键:
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默认的:零
为每个选项返回字符串“value”,在所有选项中必须是唯一的。这用于价值
属性,并在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默认的:零
您可以将<选项>
a的要素<选择>
成< optgroup >
通过将多维数组传递给选择
.看到分组选项部分。
的group_by
Option是分组选择的另一种方式,它给了你更多的灵活性。
举个例子:
12 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。
添加一个空值,文本为“Choose an option”:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“州”, ChoiceType::类,“占位符”= >“选择一个选项”]);
确保没有“空”值选项显示:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“州”, ChoiceType::类,“占位符”= >假]);
如果你离开占位符
选项未设置时,则当且仅当要求
选项为false:
1 2 3 4 5 6 7
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……//添加一个空白(无文本)选项$构建器->add (“州”, ChoiceType::类,“要求”= >假]);
preferred_choices
类型:数组
,可调用的
,字符串
或PropertyPath默认的:[]
此选项允许您在列表顶部显示某些选项,并在它们与完整选项列表之间使用可视分隔符。如果你有一种语言,你可以在上面列出最流行的语言,比如Bork和Pirate:
12 3 4 5 6 7 8 9 10 11 12
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“语言”, ChoiceType::类,“选择”= > [“英语”= >“en”,“西班牙”= >“西文”,“博克”= >“布偶”,“海盗”= >“加勒比海盗”),“preferred_choices”= > [“布偶”,“加勒比海盗”)));
该选项也可以是回调函数,以提供更大的灵活性。如果你的值是对象,这可能特别有用:
12 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, {'separator': '====='})}}
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
价值。这意味着将转换为空字符串零
.如果显式地希望返回空字符串,则使用自定义数据转换器。
invalid_message
类型:字符串
默认的:此值无效
这是验证错误消息,如果输入到该字段的数据没有意义(即验证失败),将使用该消息。
例如,如果用户将无意义的字符串输入到TimeType字段不能转换为实时的,或者如果用户输入字符串(例如。苹果
)转换为数字字段。
正常(业务逻辑)验证(例如在设置字段的最小长度时)应该使用验证消息和验证规则(参考).
继承的选项
方法继承了这些选项FormType:
attr
类型:数组
默认的:[]
属性,可以向HTML字段表示形式添加额外属性attr
选择。它是一个以HTML属性为键的关联数组。当你需要为某个小部件设置自定义类时,这可能很有用:
1 2 3
$构建器->add (“身体”, TextareaType::类,“attr”= > [“类”= >“tinymce”)));
另请参阅
使用row_attr
属性中添加这些属性表单类型行元素。
by_reference
类型:布尔
默认的:真正的
在大多数情况下,如果你有作者
场,然后你期望setAuthor ()
在底层对象上调用。然而,在某些情况下,setAuthor ()
五月不被称为。设置by_reference
来假
确保在所有情况下都调用setter。
为了进一步解释这一点,这里有一个简单的例子:
12 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字段,其中您的底层收集数据是一个对象(就像Doctrine的ArrayCollection
),然后by_reference
必须设置为假
如果你需要加法器和移除器(例如。addAuthor ()
而且removeAuthor ()
)被称为。
数据
类型:混合
默认的:默认为底层结构的字段。
当你创建一个表单时,每个字段最初都会显示表单域数据的对应属性的值(例如,如果你将一个对象绑定到表单)。如果你想覆盖表单或单个字段的初始值,你可以在data选项中设置它:
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”= > [“。”= >“城市”,],]);
帮助
类型:字符串
或TranslatableMessage
默认的:零
允许您为表单字段定义帮助消息,默认情况下呈现在字段下面:
12 3 4 5 6 7 8 9 10 11 12 13
使用ob娱乐下载\组件\翻译\TranslatableMessage;$构建器->add (“zipCode”,零, [“帮助”= >“您信用卡账单地址的邮政编码。”,)/ /……->add (“状态”,零, [“帮助”= >新TranslatableMessage (“order.status”, [“% order_id %”= >$订单->getId ()),“存储”),]);
5.4
支持传递TranslatableMessage
对象是在Symfony 5.4中引入的。ob娱乐下载
help_attr
类型:数组
默认的:[]
为用于显示表单字段的帮助消息的元素设置HTML属性。它的值是一个以HTML属性名作为键的关联数组。这些属性也可以在模板中设置:
1 2 3
{{form_help (form.name,“你的名字”,{help_attr:{‘类’:‘CUSTOM_LABEL_CLASS}})}}
inherit_data
类型:布尔
默认的:假
此选项决定表单是否从其父表单继承数据。如果您有一组跨多个表单重复的字段,这可能很有用。看到如何使用"inherit_data"减少代码重复.
谨慎
字段具有inherit_data
选项集时,它按原样使用父表单的数据。这意味着数据变形金刚不会被应用到那个领域。
标签
类型:字符串
或TranslatableMessage
默认的:从字段名“猜测”标签
设置呈现字段时将使用的标签。设置为假
将压制标签:
1 2 3 4 5 6 7 8
使用ob娱乐下载\组件\翻译\TranslatableMessage;$构建器->add (“zipCode”,零, [“标签”= >“邮政编码”,//你可以选择使用TranslatableMessage对象作为标签内容“标签”= >新TranslatableMessage (“address.zipCode”, [%的国家%的= >$国家],“地址”),)
5.2
支持TranslatableMessage
对象标签
在Symfony 5.2中引入。ob娱乐下载
标签也可以在模板中设置:
- 嫩枝
- 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”]]);
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
关键字信息。
label格式有两个变量:
-
% 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:%company%订单的标识符
可以按照如下方式指定占位符值:
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:'输入订单的唯一标识符%company%'form.order.id.title:'这将是与%company%通信时的引用'
可以按照如下方式指定占位符值:
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:'这将是与%company%通信时的引用'
可以按照如下方式指定占位符值:
1 2 3 4 5 6
$构建器->add (“id”,零, [“帮助”= >“form.order.id.help”,“help_translation_parameters”= > [%公司%的= >“ACME公司”。,],]);
的help_translation_parameters
子字段的选项与父字段的相同选项合并,因此子字段可以重用和/或覆盖任何父字段占位符。
场变量
变量 | 类型 | 使用 |
---|---|---|
多个道明><道明>布尔 |
的值多个选择。道明> | |
的值扩大选择。道明> | ||
对象的嵌套数组ChoiceView 应该优先呈现给用户的选择对象。道明> | ||
对象的嵌套数组ChoiceView 其余选项的对象。道明> | ||
选择组之间使用的分隔符。道明> | ||
如果不在列表中,则为空值,否则为空值零 .道明> | ||
布尔 ,零 或字符串 来确定是否应该转换该值。道明> | ||
一个需要A的可调用对象ChoiceView 和所选值,并返回所选值是否在所选值中。道明> | ||
空值是否在选择列表中。道明> |
提示
在树枝模板,而不是使用is_selected ()
时,使用selectedchoice测试。
访问表单选择数据
的form.vars
每个选项项的变量保存了诸如是否选择该选项等数据。如果需要获得选项数据和值的完整列表,请使用选择
变量从选择项的父表单(即ChoiceType
本身)form.parent.vars.choices
:
1 2 3 4 5 6 7 8
{# ' true '或' false ',当前选项是选择为单选还是复选框#}{{form.vars.data}}{#当前选择值(即当" choice_value' => 'name' ' #}时的类别名称){{form.vars.value}}{#由选择值或组名索引的' ChoiceView '或' ChoiceGroupView '实例的映射#}{{形式。父.vars。选择s }}
按照上面相同的高级示例(其中选项值是实体),类别
对象在内部form.parent.vars.choices[主要]. data
:
1 2 3 4 5 6 7 8 9 10 11
{%块_form_categories_entry_widget %}{%集实体=形式。父.vars.choices [form.vars.value]。数据%}<tr><道明>{{form_widget(form)}}道明><道明>{{form.vars.label}}道明><道明>{{entity.name}}|{{实体。集团}}道明>tr>{%endblock%}