扩展或包含 - Twig中哪种更好？

Question

为什么Twig文档建议使用扩展而不是包括？ Symfony 2的文档说是因为“在Symfony2中，我们喜欢以不同的方式思考这个问题：一个模板可以被另一个模板所装饰。”但仅此而已。这只是作者的奇思妙想或更多？感谢帮助。

Answer 1

当使用继承：

你有50页共享相同的布局 - 创建layout.twig作为父母，并且每一页扩展了layout.twig。所以父母是通用的，孩子是特定的。

当使用包括：

出了50页的，也有共享的HTML块6页 - 创建一个共享chunk.twig并将其包含在那些6页。

另一个用途：

您注意到layout.twig是有点混乱，你想模块化，所以拆分sidebar.twig到一个单独的文件，并将其包含在layout.twig。

您可以使用包括继承用例：

当然，创建页眉，页脚和你有什么块，并且使用包括在每一个50页。但如上所述，这是错误的设计。

你可以使用继承了包括用例：

当然，在父layout.twig共享块创建一个空块，并创建一个第二级子布局与-块。将layout.twig扩展并填充块块，然后在上面的示例中共享该块的6个页面可以扩展layout-with-chunk.twig而不是layout.twig。但是这又是错误的设计，因为块块不被所有的孩子共享，并且不应该进入基础父项。另外你已经混淆了继承树。

所以：

如上所述 - 它的设计不是编程的问题。这不是关于：我可以使用不同的编程技术来获得相同的结果，关于哪种用法是更好的设计。

Answer 2

这取决于你想完成什么。通过扩展视图，您正在使用装饰模式。如果你熟悉Symfony 1，这与输出$ sf_content的layout.php文件是一样的。当你想在整个项目中使用一个常用的html'shell'时，你使用这个方法。

另一方面，包含视图可让您在另一个视图中插入一个视图。

假设您有一个包含'about'和'contact'页面的个人网站。您将有3次： base.html.twig
about.html.twig
contact.html.twig

base.html.twig包含您的网站全线采用了常见的HTML。这可能包括您的标题，导航，页脚等（所有这些不会/不应该跨页面更改）。

about.html.twig和contact.html.twig仅包含这些特定部分的HTML。这两种观点都延伸到base.html.twig。这消除了代码重复。如果您想对标题进行更改，则只需在一个位置进行更改 - base.html.twig。

现在让我们假设您有一些其他内容要在“关于”和“联系”页面上显示（但不一定在其他页面上） - 您可以为此创建单独的视图并将其包含在about.html.twig和contact.html.twig。

该文档实际上并不建议扩展包括，它们是应该用于特定目的的两个单独的方法。

希望这会有所帮助！

Answer 3

枝条延伸是不同的，远比包括更强大。尝试将扩展从与您正在考虑包含的方式相反的方面考虑。使用扩展名，您可以从结束视图（即about.htm）开始并向后工作，添加在网站上制作页面所需的图层。在每个级别上，通过扩展内容块可以覆盖或添加到该块的父内容。

“包含”不够灵活，您从基本模板开始，到about.htm视图工作，并且无法在不同文件中处理常见的内容块。

检查出三级继承，这是一种常见的扩展模式该位：http://symfony.com/doc/current/book/templating.html#three-level-inheritance

Answer 4

我喜欢武器的答案，但我认为你错过了什么，他说。包含和扩展是不同的事情：如果扩展，您可以更改父项，使用不包含的项。

E.g. 我致以基地布局，像这样：

{% extends "layout/default.html" %} 

什么扩展现在给我，是从父使用块！你没有包含这个。现在你可以做一个标题专门为每一页：

{% block title %}My title just for this page{% endblock %} 

现在，包括给你更多的刚性和固定的HTML，e.g：

{% include 'header.html' %} 

，并在最可能entitiy repitition，例如表行：

{% include 'foo' with {'foo': 'bar'} %} 

所以你建立你的布局与包括和你扩展你的基地布局，以确保自己的网站符合指定的设计。

Answer 5

只是为了增加另一个混合选项，你可能会考虑embed。它可以让你利用从extends继承，但也允许多次重用，如include呢。

微不足道的示例：

“partials/titleize。小枝“：

<h2 class="title">{% block title %}Default Title{% endblock %}</h2> 

”一些-template.twig“ 将继承它使用embed：

{% embed "partials/titleize.twig" %} 
    {% block title %}Section 1{% endblock %} 
{% endembed %} 

... 

{% embed "partials/titleize.twig" %} 
    {% block title %}Section 2{% endblock %} 
{% endembed %} 

呈现

<h2 class="title">Section 1</h2> 
... 
<h2 class="title">Section 2</h2>