Smarty手册
上一篇	第七章内建函数	下一篇

{include}

{include}标记用来在当前模板中包含其它模板。任何当前模板中可用的变量在被包含的模板中也同样可用。

{include}标记必须有file属性，包含模板资源路径。
设置可选的assign属性，可以将{include}的输出指定给一个模板变量而不是直接输出。类似于{assign}。
变量可以作为属性传递给被包含的模板。任何显式传递给被包含模板的变量只在该被包含文件的范围内可用。属性变量如果和当前模板变量重名，将覆盖后者。
一旦离开被包含模板的范围，所有赋过值的变量都将恢复。也就是说，在被包含模板中，你可以使用所有来自包含模板中的变量。但是在被包含模板中对这些变量所做的改变，在包含模板的{include}语句后不再可见。
使用模板资源语法来{include}在$template_dir目录外的文件。

属性名	类型	必需？	缺省	描述
file	string	Yes	n/a	要包含的模板文件的名称
assign	string	No	n/a	被包含模板输出所要赋值的变量
[var ...]	[var type]	No	n/a	传递给模板的局部变量

例子7-17. 简单的{include}例子

<html>
<head>
  <title>{$title}</title>
</head>
<body>
{include file='page_header.tpl'}

{* 主体模板在此，$tpl_name变量将被一个值代替，如'contact.tpl'
*}
{include file="$tpl_name.tpl"}

{include file='page_footer.tpl'}
</body>
</html>

例子7-18. {include}传递变量

{include file='links.tpl' title='Newest links' links=$link_array}
{* body of template goes here *}
{include file='footer.tpl' foo='bar'}

上面的模板要包含下面的links.tpl：

<div id="box">
<h3>{$title}{/h3>
<ul>
{foreach from=$links item=l}
.. do stuff  ...
</foreach}
</ul>
</div>

例子7-19. {include}及赋值给一个变量

本例中将nav.tpl的内容赋值给$navbar变量，然后在页面的顶和末显示。

<body>
  {include file='nav.tpl' assign=navbar}
  {include file='header.tpl' title='Smarty is cool'}
    {$navbar}
    {* body of template goes here *}
    {$navbar}
  {include file='footer.tpl'}
</body>

例子7-20. 各种{include}资源演示

{* 绝对路径 *}
{include file='/usr/local/include/templates/header.tpl'}

{* 绝对路径（和上例一样）*}
{include file='file:/usr/local/include/templates/header.tpl'}

{* Windows绝对路径（必须使用"file:"前缀）*}
{include file='file:C:/www/pub/templates/header.tpl'}

{* 从命名为"db"的模板资源中包含 *}
{include file='db:header.tpl'}

{* 包含一个变量模板，例如$module = 'contacts' *}
{include file="$module.tpl"}

{* 无法取得预想效果，因为单引号不会有变量替代 *}
{include file='$module.tpl'}

{* 包含一个多变量模板，例如amber/links.view.tpl *}
{include file="$style_dir/$module.$view.tpl"}

参见{include_php}，{insert}，{php}，模板资源以及组件化的模板。

上一篇	主页	下一篇
{if},{elseif},{else}	返回	{include_php}