如何嵌入一个集合的形式

编辑本页

警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 2.1,现已不再维护。

本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。

任务类,并且您想编辑/创建/删除许多标签与该任务相关的对象,就在同一个表单中。

请注意

在本条目中,我们粗略地假设您使用Doctrine作为数据库存储。但如果你不使用Doctrine(例如,Propel或只是一个数据库连接),这是非常相似的。本教程中只有少数部分真正关心“持久性”。

如果你使用Doctrine时,您将需要添加Doctrine元数据,包括Task的关联映射定义标签财产。

让我们从这里开始:假设每个任务属于多个标签对象。首先创建一个简单的任务类:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
/ / src / Acme / / Task.php TaskBundle /实体名称空间AcmeTaskBundle实体使用学说常见的集合ArrayCollection任务受保护的描述受保护的标签公共函数__construct()->标签=ArrayCollection ();}公共函数getDescription()返回->描述;}公共函数setDescription描述->描述=描述;}公共函数getTags()返回->标签;}}

请注意

ArrayCollection是教义所特有的,基本上与使用数组(但它必须是一个ArrayCollection如果你使用的是Doctrine)。

现在,创建一个标签类。正如你在上面看到的,a任务可以有很多标签对象:

1 2 3 4 5 6 7
/ / src / Acme / / Tag.php TaskBundle /实体名称空间AcmeTaskBundle实体标签公共的名字;}

提示

的名字这里的财产是公共的,但它也可以很容易地受到保护或私有(但这样它就需要getName而且setName方法)。

现在让我们看表格。创建一个表单类,以便a标签对象可以被用户修改:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
/ / src / Acme / TaskBundle /形式/类型/ TagType.php名称空间AcmeTaskBundle形式类型使用ob娱乐下载组件形式AbstractType使用ob娱乐下载组件形式FormBuilderInterface使用ob娱乐下载组件OptionsResolverOptionsResolverInterfaceTagType扩展AbstractType公共函数buildForm(FormBuilderInterface构建器数组,选项构建器->add (“名字”);}公共函数setDefaultOptions(OptionsResolverInterface解析器解析器->setDefaults (数组“data_class”= >“Acme \ TaskBundle \实体\标签”));}公共函数getName()返回“标签”;}}

有了这些,您就足够单独呈现一个标签表单了。但由于最终目标是允许a的标记任务控件的窗体中进行修改,请为任务类。

的集合TagType使用集合字段类型:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
/ / src / Acme / TaskBundle /形式/类型/ TaskType.php名称空间AcmeTaskBundle形式类型使用ob娱乐下载组件形式AbstractType使用ob娱乐下载组件形式FormBuilderInterface使用ob娱乐下载组件OptionsResolverOptionsResolverInterfaceTaskType扩展AbstractType公共函数buildForm(FormBuilderInterface构建器数组,选项构建器->add (“描述”);构建器->add (“标签”“收集”数组“类型”= >TagType ()));}公共函数setDefaultOptions(OptionsResolverInterface解析器解析器->setDefaults (数组“data_class”= >“Acme实体\ TaskBundle \ \任务”));}公共函数getName()返回“任务”;}}

的一个新实例TaskType

12 34 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40
/ / src / Acme / TaskBundle /控制器/ TaskController.php名称空间AcmeTaskBundle控制器使用AcmeTaskBundle实体任务使用AcmeTaskBundle实体标签使用AcmeTaskBundle形式类型TaskType使用ob娱乐下载组件HttpFoundation请求使用ob娱乐下载FrameworkBundle控制器控制器TaskController扩展控制器公共函数newAction(请求请求任务任务();//伪代码-这里只是为了任务有一些标签//否则,这不是一个有趣的例子标签1标签();标签1->name =“标签1”任务->getTags ()->add (标签1);标签2标签();标签2->name =标签2的任务->getTags ()->add (标签2);//结束虚拟代码形式->createForm (TaskType (),任务);//在POST上处理表单如果请求->isMethod (“职位”)) {形式->bind (请求);如果形式->isValid ()) {/ /……可能会做一些表单处理,比如保存Task和Tag对象}}返回->呈现(“AcmeTaskBundle:任务:new.html.twig”数组“形式”= >形式->createView ()));}}

对应的模板现在能够同时呈现描述字段的TagType已经与此相关的任何标记的表单任务.在上面的控制器中,我添加了一些虚拟代码,这样你就可以看到它的作用(因为a任务第一次创建时没有标记)。

  • 嫩枝
  • PHP
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
{# src / Acme / TaskBundle /资源/视图/任务/ new.html。树枝#}{#……#}<形式行动“…”方法“职位”{{form_enctype(form)}}>{#渲染任务的唯一字段:description #}{{form_row(form.description)}}<h3>标签h3><ul“标签”>{#遍历每个现有标签并呈现其唯一字段:name #}{%形式上的标签。标签%}<>{{form_row(tag.name)}}>{%endfor%}ul>{{form_rest(form)}}{#……#}形式>

当用户提交表单时,提交的数据为标签字段用于构造一个ArrayCollection标签对象,然后在标签字段任务实例。

标签收集自然是通过任务- > getTags ()并且可以持久化到数据库中,或者根据需要任意使用。

到目前为止,这工作得很好,但不允许动态添加新标记或删除现有标记。因此,虽然编辑现有的标签会工作得很好,但用户实际上还不能添加任何新标签。

谨慎

在这个条目中,您只嵌入了一个集合,但不限于此。您还可以将嵌套集合嵌入到您喜欢的任何级别。但是,如果在开发设置中使用Xdebug,则可能会收到一个错误已达到'100'的最大函数嵌套级别,中止!错误。这是由于xdebug.max_nesting_levelPHP设置,默认为One hundred.

这个指令将递归限制在100个调用,如果你一次呈现整个表单,这可能还不够form_widget(形式)).要解决这个问题,你可以将这个指令设置为一个更高的值(通过PHP ini文件或via报错,例如在app / autoload.php)或手动渲染每个表单字段form_row

此表单不应包含额外字段.要使其更加灵活,可以添加allow_add选择您的收集字段:

12 3 4 5 6 7 8 9 10 11 12 13 14
/ / src / Acme / TaskBundle /形式/类型/ TaskType.php/ /……使用ob娱乐下载组件形式FormBuilderInterface公共函数buildForm(FormBuilderInterface构建器数组,选项构建器->add (“描述”);构建器->add (“标签”“收集”数组“类型”= >TagType (),“allow_add”= >真正的));}

除了告诉字段接受任意数量的提交对象之外,allow_add也会产生“原型”变量可供您选择。这个“原型”是一个小的“模板”,它包含了能够呈现任何新“标签”表单的所有HTML。要渲染它,请对模板进行以下更改:

  • 嫩枝
  • PHP
1 2 3
<ul“标签”data-prototype{{form_widget(form.tags.vars.prototype)|e}}>...ul>

请注意

如果你渲染你的整个“标签”子表单一次(例如。form_row (form.tags)),则原型自动可在外部使用div随着data-prototype属性,类似于上面所看到的。

提示

form.tags.vars.prototype表单元素看起来和感觉起来就像个体吗form_widget(标签)您的循环。这意味着你可以打电话form_widgetform_row了form_label在上面。你甚至可以选择只呈现它的一个字段(例如的名字字段):

1
{{form_widget(form.tags.vars.prototype.name)|e}}

在渲染的页面上,结果看起来像这样:

1
<ul“标签”data-prototype& lt;div比;& lt;标签类=“;要求“;比;__name__& lt;/标签比;& lt;div id =“;task_tags___name__“;比;& lt;div比;& lt;标签=“;task_tags___name___name“;类=“;要求“;比;的名字& lt;/标签比;& lt;输入类型=“;文本“;id =“;task_tags___name___name“;name =“;任务[标记][__name__][名称]“;要求=“;要求“;最大长度=“;255“;/比;& lt;/ div比;& lt;/ div比;& lt;/ div比;>

本节的目标是使用JavaScript读取该属性,并在用户单击“添加标记”链接时动态添加新的标记表单。为了简单起见,本示例使用jQuery,并假设您已经将它包含在页面的某个地方。

添加一个脚本标签,这样您就可以开始编写JavaScript了。

首先,通过JavaScript将一个链接添加到“tags”列表的底部。其次,绑定到该链接的“click”事件,这样您就可以添加一个新的标记表单(addTagForm将在下一页显示):

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
varcollectionHolder美元;//设置一个“添加标签”链接var$addTagLink = $('添加标签');var$newLinkLi = $李李' < > < / > ') .append (addTagLink美元);jQuery (文档时(函数//获取包含标签集合的ul$collectionHolder = $(“ul.tags”);//添加“添加标签”锚和li到标签ul(collectionHolder.append美元newLinkLi);//计算当前的表单输入(例如2),使用它作为新的//当插入一个新项时(例如2)collectionHolder.data美元(“指数”collectionHolder.find美元(:输入) . length);addTagLink.on美元(“点击”函数e//阻止链接在URL上创建“#e.preventDefault ();//添加一个新的标签表单(见下一个代码块)addTagForm (collectionHolder, newLinkLi美元);});});

addTagForm函数的工作是使用data-prototype属性在单击此链接时动态添加新表单。的data-prototypeHTML包含标签文本输入名称为的元素任务[标记][__name__][名称]的idtask_tags___name___name.的__name__是一个小的“占位符”,您将用一个唯一的递增数字(例如。任务[标记][3][名称]).

2.1

已更改占位符$ $ $ $的名字__name__在Syob娱乐下载mfony 2.1

实现这一切所需的实际代码可能会有很大的不同,但这里有一个例子:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
函数addTagFormcollectionHolder, newLinkLi美元//获取前面解释的数据原型var$collectionHolder.data(“原型”);//获取新的索引var$collectionHolder.data(“指数”);//将原型HTML中的__name__替换为//而是一个基于我们有多少项的数字varnewForm = prototype.replace(/ __name__ / g、指数);//为下一项增加索引collectionHolder.data美元(“指数”, index +1);//在“添加标签”链接之前,以一里的单位显示页面中的表单var$newFormLi = $(李李' < > < / > ') .append (newForm中将);(newLinkLi.before美元newFormLi);}

请注意

在真正的javascript文件中分离javascript比像这里这样在HTML中编写javascript更好。

现在,每当用户单击添加标签链接,一个新的子表单将出现在页面上。当表单提交时,任何新的标签表单都将转换为新的标签对象,并添加到标签的属性任务对象。

控件中的标记添加一个“加法器”和一个“移除器”方法,使处理这些新标记更加容易任务类:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
/ / src / Acme / / Task.php TaskBundle /实体名称空间AcmeTaskBundle实体/ /……任务/ /……公共函数addTag标签->标签->add (标签);}公共函数removeTag标签/ /……}}

接下来,添加一个by_reference选项。标签字段并设置为

12 3 4 5 6 7 8 9 10 11 12
/ / src / Acme / TaskBundle /形式/类型/ TaskType.php/ /……公共函数buildForm(FormBuilderInterface构建器数组,选项/ /……构建器->add (“标签”“收集”数组/ /……“by_reference”= >));}

通过这两个更改,当表单提交时,每个更改都是新的标签对象添加到任务类,通过调用addTag方法。在此更改之前,它们是通过调用在表单内部添加的任务- > getTags() - >添加(任务).这很好,但是强制使用“加法器”方法使得处理这些问题变得很新鲜标签对象更容易(特别是如果你使用的是Doctrine,我们接下来会谈到!)。

谨慎

如果没有addTag而且removeTag方法,则表单仍将使用setTag即使by_reference.你会学到更多关于removeTag方法。

为了保存Doctrine的新标签,您需要考虑更多的事情。首先,除非遍历所有的new标签对象和调用(em - >坚持美元标签)在每一个,你会收到一个来自Doctrine的错误:

通过这种关系发现了一个新的实体Acme实体\ TaskBundle \ \任务#标签没有配置为级联实体的持久化操作…

方法自动“级联”持久化操作任务对象到任何相关标记。要做到这一点,请添加级联选择您的元数据:

  • 注释
  • YAML
  • XML
1 2 3 4 5 6 7 8
/ / src / Acme / / Task.php TaskBundle /实体/ /……/ * * *@ORM\ManyToMany(targetEntity="Tag", cascade={"persist"}) */受保护的标签

第二个潜在的问题涉及拥有侧和反向侧教义关系。在这个例子中,如果关系的“拥有”方是“Task”,那么持久化将很好地工作,因为标记被正确地添加到Task中。但是,如果所属方在“Tag”上,那么您将需要做更多的工作,以确保修改关系的正确一方。

诀窍是确保每个“标签”上都设置了单个“任务”。做到这一点的一个简单方法是添加一些额外的逻辑addTag (),由表单类型since调用by_reference设置为

1 2 3 4 5 6 7 8 9
/ / src / Acme / / Task.php TaskBundle /实体/ /……公共函数addTag(ArrayCollection标签标签->addTask ();->标签->add (标签);}

内部标签,只要确保你有一个addTask方法:

1 2 3 4 5 6 7 8 9
/ / src / Acme / / Tag.php TaskBundle /实体/ /……公共函数addTask(任务任务如果(!->任务->包含(任务)) {->任务->add (任务);}}

如果你有对多关系,那么解决方案是类似的,除了你可以简单地打电话setTask从内addTag

allow_delete类型:

12 3 4 5 6 7 8 9 10 11 12
/ / src / Acme / TaskBundle /形式/类型/ TaskType.php/ /……公共函数buildForm(FormBuilderInterface构建器数组,选项/ /……构建器->add (“标签”“收集”数组/ /……“allow_delete”= >真正的));}

现在,需要将一些代码放入removeTag的方法任务

12 3 4 5 6 7 8 9 10 11 12
/ / src / Acme / / Task.php TaskBundle /实体/ /……任务/ /……公共函数removeTag标签->标签->removeElement (标签);}}

allow_delete选项有一个后果:如果集合的项在提交时没有发送,则相关数据将从服务器上的集合中删除。因此,解决方案是从DOM中删除表单元素。

首先,在每个标签表单中添加一个“delete this tag”链接:

12 3 4 5 6 7 8 9 10 11 12 13 14 15
jQuery (文档时(函数//添加一个删除链接到所有现有的标签形式li元素collectionHolder.find (“李”) . each (函数{addTagFormDeleteLink ($ ());});/ /……从上面看剩下的街区});函数addTagForm/ /……//添加一个删除链接到新表单addTagFormDeleteLink ($ newFormLi);}

addTagFormDeleteLink函数看起来是这样的:

12 3 4 5 6 7 8 9 10 11 12
函数addTagFormDeleteLinktagFormLi美元var$removeFormA = $('delete this tag');(tagFormLi.append美元removeFormA);removeFormA.on美元(“点击”函数e//阻止链接在URL上创建“#e.preventDefault ();//删除标签表单的li美元tagFormLi.remove ();});}

当一个标签表单从DOM中删除并提交时,被删除的标签对象将不包含在传递给的集合中setTags.根据您的持久性层,这可能不足以实际删除被删除对象之间的关系标签而且任务对象。

当以这种方式删除对象时,您可能需要多做一点工作,以确保对象之间的关系任务被移除的标签被正确移除。

在《主义》中,你有关系的两个方面:拥有的一面和相反的一面。通常在这种情况下你会有一个关系和被删除的标记将消失并正确地保存(添加新标记也很容易)。

但是如果你有一个对多关系或与一个的mappedBy在Task实体上(意味着Task是“逆”面),您将需要做更多的工作来正确地保存已删除的标记。

在这种情况下,您可以修改控制器以删除已删除标记上的关系。假设你有一些editAction它正在处理任务的“更新”:

12 34 56 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59
/ / src / Acme / TaskBundle /控制器/ TaskController.php/ /……公共函数editActionid,请求请求新兴市场->getDoctrine ()->getManager ();任务新兴市场->getRepository (“AcmeTaskBundle:任务”->找到(id);如果(!任务){->createNotFoundException (“没有找到任务”id);}originalTags数组();//在数据库中创建当前Tag对象的数组foreach任务->getTags ()作为标签){originalTags[] =标签;}editForm->createForm (TaskType (),任务);如果请求->isMethod (“职位”)) {editForm->bind (->getRequest ());如果editForm->isValid ()) {// filter $originalTags包含不再存在的标签foreach任务->getTags ()作为标签){foreachoriginalTags作为关键= >toDel){如果toDel->getId () = = =标签->getId ()) {设置originalTags关键]);}}}//删除标签和任务之间的关系foreachoriginalTags作为标签){//从标签中删除任务标签->getTasks ()->removeElement (任务);//如果它是一个多对一关系,像这样删除关系/ /标签- > setTask(空);新兴市场->persist (标签);//如果你想完全删除标签,你也可以这样做/ / em - >删除美元($标签);新兴市场->persist (任务);新兴市场->冲洗();//重定向到某个编辑页面返回->重定向(->generateUrl (“task_edit”数组“id”= >id)));}}//渲染一些表单模板

如您所见,正确地添加和删除元素可能很棘手。除非您有一个多对多关系,其中Task是“拥有”的一方,否则您将需要做额外的工作,以确保在每个Tag对象本身上正确更新关系(无论您是添加新标记还是删除现有标记)。

此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。