行动

类型：字符串默认的:空字符串

此选项指定提交表单时将数据发送到哪里(通常是URI)。的值表示为行动属性。形式元素。空值被认为是同一个文档引用，即表单将被提交给呈现表单的同一个URI。

by_reference

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

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

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

1 2 3 4 5 6 7 8

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

如果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。

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

cascade_validation

类型：布尔默认的：假

将此选项设置为真正的强制对嵌入的表单类型进行验证。例如，如果你有一个ProductType用嵌入式CategoryType,设置cascade_validation来真正的在ProductType会导致数据来自哪里CategoryType也要被验证。

复合

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

此选项指定表单是否为复合表单。这与表单是否有子表单无关。一个表单可以是复合的，但根本没有任何子表单(例如，一个空的集合表单)。

约束

类型：数组或约束默认的：零

允许您将一个或多个验证约束附加到特定字段。有关更多信息，请参见添加验证．属性中添加此选项FormTypeValidatorExtension形式扩展。

数据

类型：混合默认的:默认为基础对象的字段(如果有的话)

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

1 2 3

＄构建器->add (“令牌”，“隐藏”，数组（“数据”= >“六边形abcdef”));

data_class

类型：字符串

此选项用于设置表单要使用的适当数据映射器，因此可以将其用于任何需要对象的表单字段类型。

1 2 3

＄构建器->add (“媒体”，“sonata_media_type”，数组（“data_class”= >“Acme \ DemoBundle \实体\媒体”));

empty_data

类型：混合

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

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

DEFAULT_PLACEHOLDER

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

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

1 2 3 4 5 6 7 8 9

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

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

• 如果data_class设置为要求是真正的,然后新的data_class美元()；
• 如果data_class设置为要求是假,然后零；
• 如果data_class并没有设置复合是真正的,然后数组()(空数组);
• 如果data_class并没有设置复合是假,然后”(空字符串)。

empty_data

类型：混合

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

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

DEFAULT_PLACEHOLDER

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

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

1 2 3 4 5 6 7 8 9

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

error_bubbling

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

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

error_mapping

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

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

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

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

1 2 3 4 5 6 7 8

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

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

• 左侧包含属性路径;
• 如果违反是在类的属性或方法上生成的，则其路径简单propertyName；
• 类的项上生成的违例数组或ArrayAccess对象时，属性路径为(indexName)；
• 您可以通过连接它们来构造嵌套的属性路径，用圆点分隔属性。例如:地址[工作].matchingCityAndZipCode；
• 右侧仅包含表单中字段的名称。

默认情况下，任何未映射的属性的错误都会冒泡到父表单。你可以用点(．)，将所有未映射属性的错误映射到特定字段。例如，将所有这些错误映射到城市字段中,使用:

1 2 3 4 5

＄解析器->setDefaults (数组（“error_mapping”= >数组（“。”= >“城市”，)，));

extra_fields_message

类型：字符串默认的：此表单不应包含额外字段。

这是验证错误消息，如果提交的表单数据包含一个或多个不属于表单定义的字段，则使用该消息。占位符{{extra_fields}}可用于显示以逗号分隔的提交的额外字段名称列表。

inherit_data

类型：布尔默认的：假

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

invalid_message

类型：字符串默认的：此值无效

这是验证错误消息，如果输入到该字段的数据没有意义(即验证失败)，将使用该消息。

例如，如果用户将无意义的字符串输入到时间字段不能转换为实时的，或者如果用户输入字符串(例如。苹果)转换为数字字段。

正常(业务逻辑)验证(例如在设置字段的最小长度时)应该使用验证消息和验证规则(参考）.

invalid_message_parameters

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

当设置invalid_message选项时，您可能需要在字符串中包含一些变量。这可以通过在该选项中添加占位符并包括该选项中的变量来实现:

1 2 3 4 5

＄构建器->add (“some_field”，“some_type”，数组（/ /……“invalid_message”= >'您输入的值无效，它应该包含%num%字母'，“invalid_message_parameters”= >数组（“% num %”= >6)));

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”)));

映射

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

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

max_length

类型：整数默认的：零

如果此选项不为空，则为属性最大长度某些浏览器使用它来限制字段中的文本量。

这只是一个浏览器验证，因此数据仍然必须在服务器端进行验证。

方法

类型：字符串默认的：帖子

此选项指定用于提交表单数据的HTTP方法。的值表示为方法属性。形式元素中的表单提交，用于决定是否处理handleRequest ()提交后的方法。可能取值为:

• 帖子
• 得到
• 把
• 删除
• 补丁

模式

类型：字符串默认的：零

这就增加了一个HTML5模式属性通过给定正则表达式限制字段输入。

post_max_size_message

类型：字符串默认的：上传的文件过大。请尝试上传一个小一点的文件。

这是验证错误消息，如果提交的POST表单数据超过php . ini的post_max_size指令。的{{Max}}占位符可以用来显示允许的大小。

property_path

类型：任何默认的：字段名

默认情况下，字段显示表单域对象的属性值。当表单提交时，提交的值被写回对象中。

如果要重写字段读取和写入的属性，可以设置property_path选择。它的默认值是字段的名称。

如果希望在读取或写入对象时忽略该字段，则可以设置property_path选项假，但使用property_path已弃用，您应该使用映射选择。

read_only

类型：布尔默认的：假

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

要求

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

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

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

修剪

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

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

attr

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

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

1 2 3

＄构建器->add (“身体”，“文本区域”，数组（“attr”= >数组（“类”= >“tinymce”)));

auto_initialize

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

一个内部选项:设置表单是否应该自动初始化。对于所有字段，该选项应该仅为真正的对于根形式。您不需要更改这个选项，也不需要为此担心。

block_name

类型：字符串默认的:表格名称(见知道要定制哪个块）

允许您重写用于呈现表单类型的块名称。例如，如果您有相同表单的多个实例，并且您需要分别个性化表单的呈现，则很有用。

禁用

类型：布尔默认的：假

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

标签

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

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

1

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

1 2 3 4

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

translation_domain

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

这是翻译域，将用于为该字段呈现的任何标签或选项。