{block} · smarty3中文手冊

<table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"><tr><th colspan="3" align="center">Smarty - the compiling PHP template engine</th></tr><tr><td width="25%" align="left" valign="bottom"><a href="language.function.assign.html" accesskey="P">Prev</a></td> <td width="50%" align="center" valign="bottom">Chapter 7. Built-in Functions[第七章.內置函數]</td> <td width="25%" align="right" valign="bottom"><a href="language.function.call.html" accesskey="N">Next</a></td></tr></table> # {block} 塊 {block} is used to define a named area of template source for template inheritance. For details see section of Template Interitance. The {block} template source area of a child template will replace the correponding areas in the parent template(s). Optionally {block} areas of child and parent templates can be merged into each other. You can append or prepend the parent {block} content by using the append or prepend option flag with the childs {block} definition. With the {$smarty.block.parent} the {block} content of the parent template can be inserted at any location of the child {block} content. {$smarty.block.child} inserts the {block} content of the child template at any location of the parent {block}. {blocks}'s can be nested. {block}用來定義一個命名的模板繼承源區域。具體細節可參考[模板繼承](#)章節。 {block}的一個子模板源區將取代父模板中的相應區域。任意的子、父模板{block}區域可以彼此結合。可以利用子{block}定義中的*append*、*prepend*選項標記追加或預置父{block}內容。使用{$smarty.block.parent}可將父模板的{block}內容插入至子{block}內容中的任何位置。使用{$smarty.block.child}可將子模板{block}內容插入至父{block}內容中的任何位置。 {block}可以嵌套。 **Attribute： ** | Attribute Name | Type | Required | Default | Description | |-----|-----|-----|-----|-----| | name | string | yes | *n/a* | The name of the template source block | **option flags(in children template only):** | **Name** | **Description** | |-----|-----| | append | The {block} content will be be appended to the content of the parent template {block} | | prepend | The {block} content will be prepended to the content of the parent template {block} | | nocache | Disables caching of the {block} content | **屬性： ** | 屬性名 | 類型 | 是否必須 | 缺省值 | 描述 | |-----|-----|-----|-----|-----| | name | string | yes | *n/a* | 模板源塊名稱 | **選項標簽（只對子模版有效）：** | **名稱** | **描述** | |-----|-----| | append | {block}內容將追加到父模板{block}內容中 | | prepend | {block}內容將添加到父模板{block}內容中 | | nocache | 用'nocache' 屬性為變量賦值 | 譯注 | append與prepend作用方向是相反的，append是添加到父模板后面，而prepend是添加到父模板前面。 | |-----| <table width="100%" border="0" cellpadding="0" cellspacing="0" class="EXAMPLE"><tr><td><div class="EXAMPLE"> <a name="AEN2715" id="AEN2715"> </a> Example 7.15. Simple {block} example 例 7-15.簡單的{block} 模板 <table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre>parent.tpl<html> <head> <title>{block name="title"}Default Title{/block}</title> <title>{block "title"}Default Title{/block}</title> {* short-hand *} </head></html> child.tpl{extends file="parent.tpl"} {block name="title"}Page Title{/block}The result would look like<html> <head> <title>Page Title</title> </head></html></pre></td> </tr></table>Example 7.16. Prepend {block} example 例 7-16.添加{block} 模板 <table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre>parent.tpl<html> <head> <title>{block name="title"}Title - {/block}</title> </head></html> child.tpl{extends file="parent.tpl"} {block name="title" prepend}Page Title{/block} The result would look like<html> <head> <title>Title - Page Title</title> </head></html></pre> </td> </tr></table> Example 7.17. Append {block} example 例 7-17.追加{block} 模板 <table border="0" bgcolor="#E0E0E0" width="100%"><tr><td> parent.tpl <html> <head> <title>{block name="title"} is my titel{/block}</title> </head> </html> child.tpl {extends file="parent.tpl"} {block name="title" append} Page Title {/block} The result would look like <html> <head> <title>Page title is my titel</title> </head> </html> </td> </tr></table> Example 7.18. {$smarty.block.child} example 例 7-18.{$smarty.block.child}例子 <table border="0" bgcolor="#E0E0E0" width="100%"><tr><td> parent.tpl <html> <head> <title>{block name="title"}The {$smarty.block.child} was inserted here{/block} </head> </html> child.tpl {extends file="parent.tpl"} {block name="title" append} Child Title {/block} The result would look like <html> <head> <title>The - Child Title - was inserted here</title> </head> </html></td> </tr></table> Example 7.19. {$smarty.block.parent} example 例 7-19.{$smarty.block.parent}例子 <table border="0" bgcolor="#E0E0E0" width="100%"><tr><td> parent.tpl <html> <head> <title>{block name="title"}Parent Title{/block}</title> </head> </html> child.tpl {extends file="parent.tpl"} {block name="title" append} You will see now - {$smarty.block.parent} - here {/block} The result would look like <html> <head> <title>You will see now - Parent Title - here</title> </head> </html> </td> </tr></table>See also Template interitance, $smarty.block.parent, $smarty.block.child, and {extends} 參考<a href="advanced.features.tem.inheritance.html">模板繼承</a>、<a href="language.variables.smarty.html#pblock">$smarty.block.parent</a>、 <a href="language.variables.smarty.html#cblock">$smarty.block.child</a>和<a href="language.function.extends.html">{extends}</a> </div></td> </tr></table> <table summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"><tr><td width="33%" align="left" valign="top"><a href="language.function.assign.html" accesskey="P">Prev</a></td><td width="34%" align="center" valign="top"><a href="index.html" accesskey="H">Home</a></td><td width="33%" align="right" valign="top"><a href="language.function.call.html" accesskey="N">Next</a></td></tr><tr><td width="33%" align="left" valign="top">{assign} 賦值</td><td width="34%" align="center" valign="top"><a href="language.builtin.functions.html" accesskey="U">Up</a></td><td width="33%" align="right" valign="top">{call} 調用</td></tr></table>