Umbraco/示例与文章/模板/主模板
在 Umbraco 中,子模板可以包含主模板,以确保一组页面具有共同的元素(通常是页眉和页脚)。
在阅读本文之前,您需要了解如何创建 Umbraco 文档和模板类型。
在这个非常简单的示例中,我们将创建一个主模板,用于创建开头的 HTML 和 HEAD 标签,打开 BODY 标签,插入子模板,然后关闭 HTML 标签。
在 Umbraco 中,创建一个名为“Master”(可以是任何名称)的模板,其中包含以下代码。
<html> <head> <title> <?UMBRACO_GETITEM field="pageName"/> </title> </head> <body> <?UMBRACO_TEMPLATE_LOAD_CHILD/> </body> </html>
重要!Umbraco 2.1 中报告了一个错误,其中 <?UMBRACO_TEMPLATE_LOAD_CHILD/> 中的空格会导致主/子模板功能失败。请严格按照原样复制粘贴。
上面的模板应该是相当熟悉的 HTML。有两个 Umbraco 标签需要您注意
<?UMBRACO_GETITEM field="pageName"/>
pageName 属性是 Umbraco 内容 XML 中所有节点的通用元素。上面的代码只是将此名称插入到 html 标题标签中。
<?UMBRACO_TEMPLATE_LOAD_CHILD/>
上面的代码告诉 Umbraco,这是应该在标记中插入子模板的位置。我们将在下一步学习如何做到这一点。
在 Umbraco 中,创建一个名为“Child”或您想要的任何名称的模板。
在左侧菜单中,单击您刚刚创建的模板。
模板的源代码可以是您想要的任何内容,但对于这个非常简单的示例,让我们使用以下内容
<p>I am output from the child template</p>
在保存模板之前,更改名为“主模板”的下拉框,使值设置为在本教程第一步中创建的主模板。
从设置菜单中选择一种文档类型,或创建一个新的空白文档类型。
将您在第二步中创建的子模板添加到您文档类型的“允许模板”中。
转到 Umbraco 的内容部分,并创建您文档类型的一个节点。
现在预览该节点,并将“模板类型”设置为您在本教程第二步中创建的子模板。
查看预览的源代码,结果应显示您的主模板已包含在子模板周围,如下所示
<html> <head> <title> Node Title </title> </head> <body> <p>I am output from the child template</p> </body> </html>
您现在可以扩展您的主模板,在 HEAD 元素中包含一个通用的样式表和其他元数据。