选择

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

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

1 2 3

＄构建器->add (“性别”，“选择”，数组（“选择”= >数组（“米”= >“男”，“f”= >“女”)));

choice_list

类型：ob娱乐下载\组件\形式\扩展\核心\ ChoiceList\ ChoiceListInterface

这是指定该字段使用的选项的一种方法。的choice_list选项的实例ChoiceListInterface．对于更高级的情况，可以创建实现接口的自定义类来提供选项。

多个

类型：布尔默认的：假

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

扩大

类型：布尔默认的：假

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

preferred_choices

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

如果指定了此选项，则所有选项的子集将被移动到选择菜单的顶部。下面将“Baz”选项移动到顶部，并在它和其他选项之间使用可视分隔符:

1 2 3 4

＄构建器->add (“foo_choices”，“选择”，数组（“选择”= >数组（“foo”= >“Foo”，“酒吧”= >“酒吧”，“记者”= >“记者”)，“preferred_choices”= >数组（“记者”)));

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

1

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

1

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

empty_value

类型：字符串或布尔

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

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

  1 2 3

  ＄构建器->add (“州”，“选择”，数组（“empty_value”= >“选择一个选项”));

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

  1 2 3

  ＄构建器->add (“州”，“选择”，数组（“empty_value”= >假));

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

1 2 3 4

//添加一个空白(无文本)选项＄构建器->add (“州”，“选择”，数组（“要求”= >假));

要求

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

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

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

标签

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

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

1

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

read_only

类型：布尔默认的：假

如果此选项为true，则该字段将使用只读的属性，使字段不可编辑。

禁用

类型：布尔默认的：假

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

error_bubbling

类型：布尔默认的：假除非表格是复合

如果为真，此字段的任何错误都将传递给父字段或表单。例如，如果在一个普通字段上设置为true，该字段的任何错误都将附加到主表单，而不是特定的字段。

error_mapping

类型：数组默认的：空

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

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

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

1 2 3 4 5 6 7 8

公共函数setDefaultOptions(OptionsResolverInterface＄解析器）｛＄解析器->setDefaults (数组（“error_mapping”= >数组（“matchingCityAndZipCode”= >“城市”，)，));｝

下面是映射左侧和右侧的规则:

• 左侧包含属性路径。
• 如果冲突是在类的属性或方法上生成的，那么它的路径就是“propertyName”。
• 类的项上生成的违例数组或ArrayAccess对象时，属性路径为(indexName)．
• 您可以通过连接它们来构造嵌套的属性路径，用圆点分隔属性。例如:地址[工作].matchingCityAndZipCode
• 错误映射的左侧也接受一个点．，它指的是字段本身。这意味着添加到字段中的任何错误都会添加到给定的嵌套字段中。
• 右侧仅包含表单中字段的名称。

映射

类型：布尔

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

虚拟

类型：布尔默认的：假

此选项决定是否将表单映射为数据。如果您需要一个表单来构造视图，这可能很有用。看到如何使用虚拟表单字段选项．

by_reference

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

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

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

1 2 3 4 5 6 7 8

＄构建器＝＄这->createFormBuilder (＄文章）;＄构建器->add (“标题”，“文本”）->add (＄构建器->创建(“作者”，“形式”，数组（“by_reference”= > ?)->add (“名字”，“文本”）->add (“电子邮件”，“电子邮件”))

如果by_reference是真的吗，下面的事情发生在你打电话时的幕后绑定在表格上:

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。

类似地，如果你使用集合表单类型，其中您的底层集合数据是一个对象(就像Doctrine的ArrayCollection),然后by_reference必须设置为假如果您需要setter(例如。setAuthors)被称为。

empty_data

类型：混合默认的：数组()如果多个或扩大，”否则

属性时，此选项确定字段将返回什么值empty_value选中“选择”。

该选项的默认值取决于字段选项:

• 如果复合是真正的而且data_class那么就设置好了新的data_class美元()；
• 如果复合是真正的也没有data_class那么就设置好了数组()；
• 如果复合是假,然后零．

例如，如果你想要性别要设置为的字段零当没有选择值时，你可以这样做:

1 2 3 4 5 6 7 8 9

＄构建器->add (“性别”，“选择”，数组（“选择”= >数组（“米”= >“男”，“f”= >“女”)，“要求”= >假，“empty_value”= >“选择性别”，“empty_data”= >零));