TurboGears - 包括

可以通过在当前文档中使用包含标签来包含另一个 XML 文档（尤其是 HTML 文档）的内容。为了启用此类包含，必须在 HTML 文档的根元素中声明 XInclude 命名空间。

<html xmlns = "http://www.w3.org/1999/xhtml" xmlns:xi = "http://www.w3.org/2001/XInclude >

上面的声明指定 include 指令包含“xi”前缀。要在当前文档中添加另一个 html 页面的内容，请使用 xi:include 指令，如下所示 -

<xi:include href = "somepage.html" />

在以下示例中，root.py 包含 include() 控制器，该控制器公开 include.html。

from hello.lib.base import BaseController
from tg import expose, request

class RootController(BaseController):
   @expose('hello.templates.include')
   def include(self):
      return {}

标题和页脚 HTML

在include.html中，声明了include命名空间，并添加了heading.html和footer.html的内容。这是 templates\include.html 的 HTML 脚本 -

<html xmlns = "http://www.w3.org/1999/xhtml" 
   xmlns:xi = "http://www.w3.org/2001/XInclude">
	
   <head>
      <title>TurboGears Templating Example</title>
   </head>
	
   <body>
      <xi:include href = "heading.html" />
      <h2>main content </h2>
      <xi:include href = "footer.html" />
   </body>
	
</html>

这是 templates\heading.html 代码 -

<html>
   <head>
      <title>TurboGears Templating Example</title>
   </head>
	
   <body>
      <h1>This is page Header</h1>
   </body>
</html>

以下是templates\footer.html

<html>
   <head>
      <title>TurboGears Templating Example</title>
   </head>
	
   <body>
      <h3>This is page footer</h3>
   </body>
</html>

使用变速箱开始开发，在浏览器中输入http://localhost:8080/include 。呈现的输出如下所示 -

模板示例

这样就可以实现视图的模块化构造。如果 xi:include 指令中提到的资源不可用，则会引发错误。在这种情况下，可以使用 xi:fallback 加载替代资源。

<xi:include href = “main.html”>
   <xi:fallback href = ”default.html”/>
</xi.include>

内容的包含可以动态化为可以包含表达式的 href 属性。

在 root.py 中添加以下控制器。

@expose('hello.templates.ref-include')
   def refinclude(self):
      return {'pages':['heading','main','footer']}

将以下代码另存为 templates 文件夹中的 ref-include.html。

<html xmlns = "http://www.w3.org/1999/xhtml"
   xmlns:py = "http://genshi.edgewall.org/"
   xmlns:xi = "http://www.w3.org/2001/XInclude">
	
   <head>
      <title>TurboGears Templating Example</title>
   </head>
	
   <body>
      <xi:include href = "${name}.html" py:for = "name in pages" />
   </body>
	
</html>

在启动服务器之前，请确保模板文件夹中有 header.html、main.html 和 footer.html。在浏览器中输入http://localhost:8082/refinclude得到如下输出

页脚模板