TextType字段填充数组电子邮件值。在更复杂的例子,你可以嵌入整个表单,它是有用的在创建形式公开一对多关系(例如,一个产品,你可以管理许多相关产品照片)。

呈现为	取决于entry_type选项
默认的无效信息	集合是无效的。
遗留无效的信息	{{value}}的值是无效的。
父类型	FormType
类	CollectionType

提示

选项的完整列表和继承了这种类型定义在你的应用可以运行这个命令:

1 2

#替换“FooType”的表单类型的类名美元php bin /控制台调试:FooType形式

请注意

如果你正在与教义的实体的集合,特别注意allow_add,allow_delete和by_reference选项。你也可以看到一个完整的示例如何嵌入一组形式篇文章。

电子邮件字段对应于一个电子邮件地址数组。的形式,你想让每个电子邮件地址作为自己的输入文本框:

1 2 3 4 5 6 7 8 9 10 11 12

使用ob娱乐下载\组件\形式\扩展\核心\类型\CollectionType;使用ob娱乐下载\组件\形式\扩展\核心\类型\EmailType;/ /……美元构建器- >add (“电子邮件”,CollectionType::类,/ /数组中的每一项都将是一个“电子邮件”字段“entry_type”= > EmailType::类,/ /这些选项传递给每一个“电子邮件”类型“entry_options”= > [“attr”= > [“类”= >“邮箱”]]]);

最简单的方式来呈现这是:

1

{{form_row (form.emails)}}

一个更灵活的方法是这样的:

1 2 3 4 5 6 7 8 9 10 11

{{了form_label (form.emails)}}{{form_errors (form.emails)}}<ul>{%为emailField形式。电子邮件%}<李>{{form_errors (emailField)}}{{form_widget (emailField)}}< /李>{%endfor%}< /ul>

在这两种情况下,会呈现,除非你没有输入字段电子邮件数据数组已经包含了一些电子邮件。

在这个简单的例子中,它仍然是无法添加新地址或删除现有的地址。添加新地址可以使用allow_add选项(和可选原型选项)(见下面的例子)。删除的邮件电子邮件数组是可能的allow_delete选择。

allow_add被设置为真正的,如果任何识别提交的项目,他们会无缝地添加到数组的物品。在理论上这是伟大的,但需要一点努力在实践中得到正确的客户端JavaScript。

按照前面的示例,假设您从两个电子邮件开始电子邮件数据数组。在这种情况下,两个输入字段将被呈现,像这样(取决于表单的名称):

1 2

<输入类型=“电子邮件”id=“form_emails_0”的名字=“形式(电子邮件)[0]”价值=“foo@foo.com”/ ><输入类型=“电子邮件”id=“form_emails_1”的名字=“形式(电子邮件)[1]”价值=“bar@bar.com”/ >

允许用户添加另一个电子邮件,就集allow_add来真正的-通过JavaScript呈现另一个字段的名称形式(电子邮件)[2](越来越多的领域等等)。

帮助使这一切变得更简单,设置原型选项真正的允许您呈现一个“模板”字段,你可以使用JavaScript来帮助您动态地创建这些新字段。呈现原型领域是这样的:

1 2 3 4 5

<输入类型=“电子邮件”id=“form_emails___name__”的名字=“形式(电子邮件)(__name__)”价值=”“/ >

通过替换__name__(如与一些独特的价值。2),您可以构建和新的HTML字段插入表单。

使用jQuery,一个简单的例子可能会看起来像这样。如果你一下子呈现你的收藏领域(如。form_row (form.emails)),然后事情更容易,因为data-prototype属性自动为您呈现(有轻微差异,请参见下面的note)和所有你需要的是这个JavaScript代码:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日

/ / add-collection-widget.jsjQuery (文档时(函数(){jQuery (“.add-another-collection-widget”).click (函数(e){var= jQuery (jQuery列表(这).attr (“data-list-selector”));/ /列表的试图找到柜台或使用列表的长度var计数器= list.data (“widget-counter”)| | list.children . length ();/ /获取原型模板varnewWidget = list.attr (“data-prototype”);/ /替换id和名称中使用“__name__”的原型/ /与一些独一无二的你的电子邮件/ /结束名称属性看起来像name =“联系(邮件)[2]”newWidget = newWidget.replace (/ __name__ / g、计数器);/ /增加计数器计数器+ +;/ /存储,长度不能使用是否允许删除小部件list.data (“widget-counter”、计数器);/ /创建一个新的列表元素,并将其添加到列表中varnewElem = jQuery (list.attr (“data-widget-tags”). html (newWidget);newElem.appendTo(列表);});});

和更新的模板如下:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日24

{{form_start(形式)}}{#……#}{#商店data-prototype属性上的原型#}<ulid=“email-fields-list”data-prototype=”{{form_widget (form.emails.vars.prototype) | e}}”data-widget-tags=”{{' <李> < /李> | e}}”data-widget-counter=”{{form.emails |长度}}”>{%为emailField形式。电子邮件%}<李>{{form_errors (emailField)}}{{form_widget (emailField)}}< /李>{%endfor%}< /ul><按钮类型=“按钮”类=“add-another-collection-widget”data-list-selector=“# email-fields-list”>添加另一个电子邮件< /按钮>{#……#}{{form_end(形式)}}<脚本src=“add-collection-widget.js”>< /脚本>

提示

如果你立刻呈现整个集合,则自动上可用的原型data-prototype(如属性的元素。div或表)围绕你的收藏。唯一的区别在于,整个“形式行”为你呈现,这意味着你不需要把它在任何容器元素,因为它上面了。

布尔默认的:假

如果设置为真正的,如果未识别的项目提交给集合,它们将被添加新项。结束数组将包含现有的项目以及新项目,在提交数据。详细信息,请参阅上面的例子。

的原型选项可以用来帮助呈现一个原型项目,可以使用——使用JavaScript动态地创建新表单项在客户端。有关更多信息,请参见上面的例子如何嵌入一组形式。

谨慎

如果你嵌入整个其他形式来反映一个一对多的关系数据库,您可能需要手动确保正确地设置这些新对象的外键。如果你使用原则,这不会自动发生。请点击上面的链接查看更多细节。

布尔默认的:假

如果设置为真正的,那么如果一个现有的项目不包含在提交数据,它将正确地缺席最后一项的数组。这意味着您可以通过JavaScript实现一个“删除”按钮,删除表单元素的DOM。当用户提交表单时,其缺席提交的数据将意味着从最终数组中删除。

有关更多信息,请参见如何嵌入一组形式。

谨慎

使用此选项时要小心当你嵌入对象的集合。在这种情况下,如果任何嵌入形式被移除,他们将正确地失踪的最终数组对象。然而,根据您的应用程序逻辑,当一个对象被删除,您可能需要删除它或者至少删除外键引用的主要对象。这一切都是自动处理的。有关更多信息,请参见如何嵌入一组形式。

布尔或可调用的默认的:假

如果你想显式地删除空从表单收集条目必须设置这个选项真正的。然而,现有的收集条目只会被删除,如果你有allow_delete选择启用。否则,空值将保存。

谨慎

的delete_empty归一化值时只选择删除项零。如果嵌套entry_type是一种复合类型,您必须设置要求选项假或设置empty_data选项零。这两个选项可以设置里面entry_options。读到的表单的empty_data选项学习为什么这是必要的。

从集合中删除的值只有在规范化值零。然而,你也可以选择值设置为一个可调用,将执行提交每个值的集合。如果可调用的返回真正的从集合中移除的价值。例如:

1 2 3 4 5 6 7 8 9

使用ob娱乐下载\组件\形式\扩展\核心\类型\CollectionType;/ /……美元构建器- >add (“用户”,CollectionType::类,/ /……“delete_empty”= >函数(用户美元用户= null){返回零= = =美元用户| |空(美元用户- >getFirstName ());}));

使用一个可调用的是特别有用的化合物形式类型,这可能定义复杂条件考虑他们是空的。

数组默认的:[]

这个数组的形式传递给指定的类型entry_type选择。例如,如果您使用了ChoiceType作为你的entry_type选项(例如下拉菜单的集合),那么你需要至少通过选择选择基本的类型:

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

使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;使用ob娱乐下载\组件\形式\扩展\核心\类型\CollectionType;/ /……美元构建器- >add (“favoriteCities”,CollectionType::类,“entry_type”= > ChoiceType::类,“entry_options”= > [“选择”= > [纳什维尔的= >纳什维尔的,“巴黎”= >“巴黎”,“柏林”= >“柏林”,“伦敦”= >“伦敦”,]]]);

数组默认的:[]

6.1

的prototype_options选项是在Symfony 6.1中引入的。ob娱乐下载

这个数组的形式传递给指定的类型entry_type选择在创建它的原型。它允许有不同的选项取决于你添加一个新的条目或编辑现有条目:

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

使用ob娱乐下载\组件\形式\扩展\核心\类型\CollectionType;使用ob娱乐下载\组件\形式\扩展\核心\类型\TextType;/ /……美元构建器- >add (“名字”,CollectionType::类,“entry_type”= > TextType::类,“entry_options”= > [“帮助”= >“你可以在这里编辑这个名字。”),“prototype_options”= > [“帮助”= >你可以在这里输入一个新的名称。、]]);

字符串默认的:Sob娱乐下载ymfony的\组件\形式\扩展\核心\类型\ TextType '

这是对每一项的字段类型集合(如。TextType,ChoiceType等等)。例如,如果你有一个电子邮件地址数组,可以使用的EmailType。如果你想嵌入其它形式的集合,通过表单类型类(如这个选项。MyFormType::类)。

布尔默认的:真正的

当使用这个选项是有用的allow_add选择。如果真正的(如果allow_add也真正的),一个特殊的“原型”属性将是可用的,这样您就可以呈现一个“模板”示例页面上的一个新元素应该是什么样子。的的名字给这个元素属性__name__。这允许您添加一个“添加另一个”按钮通过JavaScript读取原型,取代__name__里面有一些独特的名称或编号和渲染表单。当提交,它将被添加到您的底层数组的allow_add选择。

原型可以通过呈现原型集合中的变量:

1

{{form_row (form.emails.vars.prototype)}}

注意,你真正需要的是“部件”,但这取决于你呈现形式,在整个“行”可能更容易。

提示

如果你渲染整个收藏领域,然后原型形式行自动上可用data-prototype(如属性的元素。div或表)围绕你的收藏。

如何真正使用这个选项的详细信息,见上面的例子一样如何嵌入一组形式。

混合默认的:零

允许您定义特定数据的原型。每个新行添加最初将包含这个选项的数据集。默认情况下,数据配置的所有条目entry_options选项将使用:

1 2 3 4 5 6 7 8 9 10

使用ob娱乐下载\组件\形式\扩展\核心\类型\CollectionType;使用ob娱乐下载\组件\形式\扩展\核心\类型\TextType;/ /……美元构建器- >add (“标签”,CollectionType::类,“entry_type”= > TextType::类,“allow_add”= >真正的,“原型”= >真正的,“prototype_data”= >“新标签占位符”]);

字符串默认的:__name__

如果你有几个集合形式,或者更糟,嵌套收藏您可能想要更改占位符,这样无关的占位符替换为相同的值。

invalid_message

类型:字符串默认的:这个值是无效的

这是验证错误消息,如果数据使用进入这个领域没有意义(即未验证)。

这可能发生,例如,如果用户输入一个无意义的字符串TimeType字段不能被转换成实时或如果用户输入一个字符串(例如苹果)进入很多领域。

正常(业务逻辑)验证(例如当设置一个最小长度字段)应设置使用验证消息的验证规则(参考)。