{% 占位符 %}
这{% placeholder %}
标签将呈现一个占位符部分,通常是在布局中使用.此标记将返回已使用添加的任何占位符内容{% put %}
标记,或定义的任何默认内容(可选)。
{% placeholder name %}
然后可以将内容注入任何后续页面或部分中的占位符。
{% put name %}
<p>Place this text in the name placeholder</p>
{% endput %}
默认占位符内容
占位符可以具有默认内容,这些内容可以由页面替换或补充。如果{% put %}
页面上未定义具有默认内容的占位符标记,则显示默认占位符内容。布局模板中的示例占位符定义:
{% placeholder sidebar default %}
<p><a href="/contacts">Contact us</a></p>
{% endplaceholder %}
页面可以向占位符注入更多内容。这{% default %}
标记指定应显示默认占位符内容的位置。如果不使用标签,占位符内容将被完全替换。
{% put sidebar %}
<p><a href="/services">Services</a></p>
{% default %}
{% endput %}
检查占位符是否存在
在布局模板中,您可以使用placeholder()
功能。这使您可以根据页面是否提供占位符内容来生成不同的标记。例子:
{% if placeholder('sidemenu') %}
<!-- Markup for a page with a sidebar -->
<div class="row">
<div class="col-md-3">
{% placeholder sidemenu %}
</div>
<div class="col-md-9">
{% page %}
</div>
</div>
{% else %}
<!-- Markup for a page without a sidebar -->
{% page %}
{% endif %}
自定义属性
这placeholder
标签接受两个可选属性——title
和type
.这title
属性不被 CMS 本身使用,但可以被其他插件使用。 type 属性管理占位符类型。目前支持两种类型——text 和html.文本占位符的内容在显示之前被转义。 title 和 type 属性应该在占位符名称和default
属性,如果它被呈现。例子:
{% placeholder ordering title="Ordering information" type="text" %}
具有默认内容、标题和类型属性的占位符示例。
{% placeholder ordering default title="Ordering information" type="text" %}
There is no ordering information for this product.
{% endplaceholder %}