跳转到内容

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 元素中包含一个通用的样式表和其他元数据。

华夏公益教科书