attr

类型:数组默认的:［］

属性，可以向HTML字段表示形式添加额外属性attr选择。它是一个以HTML属性为键的关联数组。当你需要为某个小部件设置自定义类时，这可能很有用:

1 2 3

＄构建器->add (“身体”, TextareaType：：类,“attr”= > [“类”= >“tinymce”)));

数据

类型:混合默认的:默认为底层结构的字段。

当你创建一个表单时，每个字段最初都会显示表单域数据的对应属性的值(例如，如果你将一个对象绑定到表单)。如果你想覆盖表单或单个字段的初始值，你可以在data选项中设置它:

1 2 3 4 5 6

使用ob娱乐下载\组件\形式\扩展\核心\类型\HiddenType;/ /……＄构建器->add (“令牌”, HiddenType：：类,“数据”= >“六边形abcdef”]);

禁用

类型:布尔默认的:假

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

empty_data

类型:混合

从HTTP的角度来看，提交的数据始终是字符串或字符串数组。因此，默认情况下，表单将把任何空字符串视为null。如果希望获取空字符串，则显式地设置empty_data空字符串的选项。

这个选项决定字段的值返回当提交的值为空(或缺失)时。如果在视图中呈现表单时没有提供初始值，则不设置初始值。

这意味着它可以帮助您处理带有空白字段的表单提交。例如，如果你想要的名字要显式设置为的字段John Doe当没有选择值时，你可以这样做:

1 2 3 4

＄构建器->add (“名字”，零, (“要求”= >假，“empty_data”= >“John Doe”]);

这仍然会呈现一个空文本框，但在提交John Doe值将被设置。使用数据或占位符选项，在呈现的表单中显示此初始值。

如果表单是复合的，则可以设置empty_data作为数组、对象或闭包。看到如何为窗体类配置空数据文章中有关于这些选项的详细信息。

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”= > [“。”= >“城市”，]，]);

帮助

类型:字符串或TranslatableInterface默认的:零

允许您为表单字段定义帮助消息，默认情况下呈现在字段下面:

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

使用ob娱乐下载\组件\翻译\TranslatableMessage;＄构建器->add (“zipCode”，零, (“帮助”= >“您信用卡账单地址的邮政编码。”,)/ /……->add (“状态”，零, (“帮助”= >新TranslatableMessage (“order.status”, (“% order_id %”= >＄订单->getId ()),“存储”)，]);

help_attr

类型:数组默认的:［］

为用于显示表单字段的帮助消息的元素设置HTML属性。它的值是一个以HTML属性名作为键的关联数组。这些属性也可以在模板中设置:

1 2 3

{{form_help (form.name,“你的名字”,{help_attr:{‘类’:‘CUSTOM_LABEL_CLASS}})}}

help_html

类型:布尔默认的:假

的内容默认为帮助选项在模板中呈现之前进行转义。将此选项设置为真正的不转义它们，这在帮助包含HTML元素时很有用。

标签

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

设置呈现字段时将使用的标签。设置为假将压制标签:

1 2 3 4 5 6 7 8

使用ob娱乐下载\组件\翻译\TranslatableMessage;＄构建器->add (“zipCode”，零, (“标签”= >“邮政编码”，//你可以选择使用TranslatableMessage对象作为标签内容“标签”= >新TranslatableMessage (“address.zipCode”, (%的国家%的= >＄国家),“地址”),)

标签也可以在模板中设置:

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娱乐下载那么这个选项的值将从您的验证信息中猜测出来。

row_attr

类型:数组默认的:［］

元素中添加的HTML属性的关联数组，用于呈现表单类型行:

1 2 3

＄构建器->add (“身体”, TextareaType：：类,“row_attr”= > [“类”= >“文本编辑器”，“id”= >“……”)));

sanitize_html

类型:布尔默认的:假

当真正的时，文本输入将使用ob娱乐下载Symfony HTML Sanitizer组件在表单提交之后。这可以保护表单输入不受XSS、点击劫持和CSS注入的影响。

洗手液

类型:字符串默认的:“默认”

当sanitize_html启用时，可以指定定制的洗手液使用此选项。

修剪

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

如果为真，提交的字符串值的空白将通过修剪函数在绑定数据时调用。这可以保证，如果提交的值带有额外的空格，那么在将值合并回基础对象之前，该值将被删除。