选择

类型：数组默认的：数组()

这是指定该字段应使用的选项的最基本方法。的选择Option是一个数组，其中数组键是项目的标签，数组值是项目的值:

1 2 3 4 5 6

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (的有现货的, ChoiceType：：类,数组（“选择”= >数组（“库存”= >真正的，“缺货”= >假)));

choice_attr

类型：数组，可调用的或字符串默认的：数组()

使用它可以为每个选项添加额外的HTML属性。这可以是一个属性数组(如果每个选项的属性都相同)，一个可调用对象或一个属性路径(就像choice_label)．

的键值选择Array必须用作键:

12 3 4 5 6 7 8 9 10 11 12 13 14

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“参加”, ChoiceType：：类,数组（“选择”= >数组（“是的”= >真正的，“不”= >假，“也许”= >零),“choice_attr”= >函数（＄瓦尔，＄关键，＄指数）｛//添加一个类，如attending_yes, attending_no等返回［“类”= >“attending_”.strtolower (＄关键));}));

choice_label

类型：字符串，可调用的或假默认的：零

数组中每个项的数组键选择选项用作显示给用户的文本。的choice_label选项可让您获得更多的控制权:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“参加”, ChoiceType：：类,数组（“选择”= >数组（“是的”= >真正的，“不”= >假，“也许”= >零),“choice_label”= >函数（＄价值，＄关键，＄指数）｛如果（＄价值= =真正的){返回“当然!”；｝返回strtoupper (＄关键）;//如果你想翻译一些键/ /返回form.choice。。美元的关键;}));

此方法被调用每一个选择，传递给你选择美元的价值和美元的关键从选项数组(美元指数与choice_value)．这将给你:

如果选择的值是对象，那么choice_label也可以是属性路径．想象一下你有一些状态类的getDisplayName ()方法:

1 2 3 4 5 6 7 8 9 10 11

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“参加”, ChoiceType：：类,数组（“选择”= >数组（新状态(状态：：是的),新状态(状态：：没有),新状态(状态：：也许),),“choice_label”= >“displayName的”));

如果设置为假，所有的标签标签将被丢弃的无线电或复选框输入。你也可以返回假从可调用到丢弃某些标签。

choice_loader

类型：ChoiceLoaderInterface

的choice_loader可用于在不需要完全加载列表的情况下仅部分加载选项。这只在高级病例中需要，并将取代选择选择。

choice_name

类型：可调用的或字符串默认的：零

控制选择的内部字段名。你通常不关心这个，但在一些高级情况下，你可能会关心。例如，这个“name”成为模板中选择视图的索引。

这可以是一个可调用路径或属性路径。看到choice_label类似用法。如果零时，则使用递增整数作为名称。

choice_translation_domain

类型：字符串，布尔或零

此选项决定是否应该翻译所选值以及在哪个翻译域中翻译。

的值choice_translation_domain选项可以是真正的(重用当前翻译域)，假(禁用翻译),零(使用父翻译域或默认域)或表示要使用的确切翻译域的字符串。

choice_value

类型：可调用的或字符串默认的：零

为每个选项返回字符串“value”。这用于价值属性，并在POST/PUT请求中提交。您通常不需要担心这一点，但在处理API请求时可能很方便(因为您可以配置将在API请求中发送的值)。

这可以是一个可调用路径或属性路径。看到choice_label类似用法。如果零时，则使用递增整数作为名称。

choices_as_values

此选项已弃用，您应该将其从您的3。X项目(删除它将有没有效果)。为了它的目的2。X，请参见2.7文档。欧宝体育电话

扩大

类型：布尔默认的：假

如果设置为true，则将呈现单选按钮或复选框(取决于多个值)。如果为false，将呈现一个select元素。

group_by

类型：数组，可调用的或字符串默认的：零

您可以简单地通过传递多维数组来“分组”选择中的选项选择．看到分组选项部分。

的group_byOption是分组选择的另一种方式，它给了你更多的灵活性。

举个例子:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“publishAt”, ChoiceType：：类,数组（“选择”= >数组（“现在”= >新\ DateTime (“现在”)，“明天”= >新\ DateTime (“+ 1天”)，“1周”= >新\ DateTime (“+ 1周”)，“一个月”= >新\ DateTime (“+ 1月”)),“group_by”= >函数（＄瓦尔，＄关键，＄指数）｛如果（＄瓦尔< =新\ DateTime (+ 3天的)) {返回“很快”；｝其他的｛返回“后来”；}}，));

这将3天以内的日期分组为“Soon”，其他所有日期分组为“Later”:

如果你回来零，该选项将不会被分组。您还可以传递一个字符串“属性路径”，它将被调用来获取组。看到choice_label属性路径的详细信息。

多个

类型：布尔默认的：假

如果为真，用户将能够选择多个选项(而不是只选择一个选项)。的值扩大选项，如果为真，将呈现一个选择标签或复选框，如果为假，将呈现一个选择标签或单选按钮。返回值将是一个数组。

占位符

类型：字符串或布尔

这个选项决定了一个特殊的“空”选项(例如:“选择一个选项”)将出现在选择小部件的顶部。此选项仅适用于多个选项设置为false。

• 添加一个空值，文本为“Choose an option”:

  1 2 3 4 5 6

  使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“州”, ChoiceType：：类,数组（“占位符”= >“选择一个选项”));

• 确保没有“空”值选项显示:

  1 2 3 4 5 6

  使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“州”, ChoiceType：：类,数组（“占位符”= >假));

如果你离开占位符选项未设置时，则当且仅当要求选项为false:

1 2 3 4 5 6 7

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……//添加一个空白(无文本)选项＄构建器->add (“州”, ChoiceType：：类,数组（“要求”= >假));

preferred_choices

类型：数组，可调用的或字符串默认的：数组()

此选项允许您将某些选项移动到列表的顶部，并在它们与其他选项之间使用可视分隔符。如果你有一种语言，你可以在上面列出最流行的语言，比如Bork Bork和Pirate:

12 3 4 5 6 7 8 9 10 11 12

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“语言”, ChoiceType：：类,数组（“选择”= >数组（“英语”= >“en”，“西班牙”= >“西文”，“博克”= >“布偶”，“海盗”= >“加勒比海盗”)，“preferred_choices”= >数组（“布偶”，“加勒比海盗”)));

该选项也可以是回调函数，以提供更大的灵活性。如果你的值是对象，这可能特别有用:

12 3 4 5 6 7 8 9 10 11 12 13 14 15

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“publishAt”, ChoiceType：：类,数组（“选择”= >数组（“现在”= >新\ DateTime (“现在”)，“明天”= >新\ DateTime (“+ 1天”)，“1周”= >新\ DateTime (“+ 1周”)，“一个月”= >新\ DateTime (“+ 1月”)),“preferred_choices”= >函数（＄瓦尔，＄关键）｛//首选3天内的选项返回＄瓦尔< =新\ DateTime (+ 3天的）;}));

这将“偏爱”“现在”和“明天”的选择:

最后，如果您的值是对象，您还可以在对象上指定属性路径字符串，该字符串将返回true或false。

类时，首选选项才有意义选择元素(即。扩大假)。首选选项和普通选项在视觉上由一组虚线分隔开。-------------------)．这可以在呈现字段时自定义:

1

{{form_widget(形式。publishAt， {'separator': '====='})}}

1 2 3

<？php回声＄视图［“形式”］->小部件(＄形式［“publishAt”),数组（“分隔符”= >“= = = = =”）)? >

复合

类型：布尔默认的:与扩大选项

此选项指定表单是否为复合表单。的值默认覆盖该值扩大选择。

empty_data

类型：混合

．．该文件应该只包含“开始后”或“结束前”

设置为此占位符值。它的目的是让我们只包含该文件的一部分。

DEFAULT_PLACEHOLDER

此选项决定了当提交的值为空时字段将返回什么值。

但是您可以根据自己的需要定制它。例如，如果你想要性别要显式设置的选择字段零当没有选择值时，你可以这样做:

12 3 4 5 6 7 8 9 10 11 12

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“性别”, ChoiceType：：类,数组（“选择”= >数组（“米”= >“男”，“f”= >“女”)，“要求”= >假，“占位符”= >“选择性别”，“empty_data”= >零));

该选项的实际默认值取决于其他字段选项:

• 如果多个是假而且扩大是假,然后”(空字符串);
• 否则数组()(空数组)。

empty_data

类型：混合

．．该文件应该只包含“开始后”或“结束前”

设置为此占位符值。它的目的是让我们只包含该文件的一部分。

DEFAULT_PLACEHOLDER

此选项决定了当提交的值为空时字段将返回什么值。

但是您可以根据自己的需要定制它。例如，如果你想要性别要显式设置的选择字段零当没有选择值时，你可以这样做:

12 3 4 5 6 7 8 9 10 11 12

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼ChoiceType；/ /……＄构建器->add (“性别”, ChoiceType：：类,数组（“选择”= >数组（“米”= >“男”，“f”= >“女”)，“要求”= >假，“占位符”= >“选择性别”，“empty_data”= >零));

error_bubbling

类型：布尔默认的：假

设置此字段上的错误必须附加到该字段，而不是父字段(大多数情况下为表单)。

by_reference

类型：布尔默认的：真正的

在大多数情况下，如果你有的名字场，然后你期望setName ()在底层对象上调用。然而，在某些情况下，setName ()五月不被称为。设置by_reference确保在所有情况下都调用setter。

为了进一步解释这一点，这里有一个简单的例子:

12 3 4 5 6 7 8 9 10 11 12 13

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼TextType；使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼EmailType；使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼FormType；/ /……＄构建器＝＄这->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

使用欧宝娱乐app下载地址＼组件＼形式＼扩展＼核心＼类型＼HiddenType；/ /……＄构建器->add (“令牌”, HiddenType：：类,数组（“数据”= >“六边形abcdef”));

禁用

类型：布尔默认的：假

如果不希望用户修改字段的值，可以将禁用选项设置为true。任何提交的值都将被忽略。

error_mapping

类型：数组默认的：数组()

此选项允许您修改验证错误的目标。

假设您有一个名为matchingCityAndZipCode这将验证城市和邮政编码是否匹配。不幸的是，您的表单中没有“matchingCityAndZipCode”字段，因此Symfony所能做的就是在表单顶部显示错误。欧宝娱乐app下载地址

使用自定义错误映射，你可以做得更好:将错误映射到城市字段，这样它就会显示在它上面:

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”= >数组（“。”= >“城市”，)，));

inherit_data

类型：布尔默认的：假

此选项决定表单是否从其父表单继承数据。如果您有一组跨多个表单重复的字段，这可能很有用。看到如何使用"inherit_data"减少代码重复．

标签

类型：字符串默认的:从字段名“猜测”标签

设置呈现字段时将使用的标签。设置为false将屏蔽标签。标签也可以直接在模板内设置:

1

{{form_label(form.name， '你的名字')}}

1 2 3 4

回声＄视图［“形式”］->标签(＄形式［“名字”),“你的名字”）;

label_attr

类型：数组默认的：数组()

属性的HTML属性<标识>元素，它将在呈现字段的标签时使用。它是一个以HTML属性为键的关联数组。这些属性也可以直接在模板中设置:

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）;

%的名字%

字段名(例如:街)．

默认值(零)的结果是“人性化”版本字段名的。

映射

类型：布尔默认的：真正的

如果希望在读取或写入对象时忽略该字段，则可以设置映射选项假．

要求

类型：布尔默认的：真正的

如果为，则HTML5所需属性将被渲染。相应的标签还会渲染一个要求类。

这是肤浅的，独立于验证。如果您让Symfony猜测您的字段类型，欧宝娱乐app下载地址那么这个选项的值将从您的验证信息中猜测出来。

translation_domain

类型：字符串默认的：消息

以防choice_translation_domain设置为真正的或零，这将配置将用于此字段呈现的任何标签或选项的确切翻译域