多个

类型：布尔默认的：假

当设置为true时，用户将能够同时上传多个文件。

复合

类型：布尔默认的：假

此选项指定类型是否包含子类型。此选项是针对内置类型进行内部管理的，因此不需要显式地配置它。

data_class

类型：字符串默认的：文件

此选项设置类型要使用的适当的与文件相关的数据映射器。

empty_data

类型：混合默认的：零

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

禁用

类型：布尔默认的：假

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

error_bubbling

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

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

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

标签

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

设置呈现字段时将使用的标签。设置为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猜测您的字段类型，ob娱乐下载那么这个选项的值将从您的验证信息中猜测出来。