模板:Ptl/doc

本模板已应用于7000+页面。
该模板提供的功能很重要并且使用率高。
为避免大规模的破坏及不必要的服务器负荷，任何改动均应先在该模板对应的沙盒页面或您自己的用户页下进行测试，并将测试无误的代码一次性地改动至本模板。
为尊重其他用户，任何功能/兼容性改动在生效前都应先在讨论页进行讨论。

简介

该模板用于在页面中模拟出一个“页面内模板（Page Template）”，按场景解决代码重复或仅用于对应条目等问题。

{{页内模板}}，{{lambda}}也重定向至该模板。

如果有多个页面都要使用同一组模板代码，建议新建一个模板页面，而不是在多个页面间复制模板代码。

(ｉ)注意 在模板中使用该模板会增加页面展开长度，请优先考虑新建模板。对于连续使用本模板的场景，建议使用{{Template Repeat}}替代。

用法

<!-- 声明模板 -->
{{ptl|define=模板名|tl=<nowiki>
模板代码
<!-- 其中的参数写法 -->
{{{ 1 }}}                         <!-- 匿名参数，所有参数名都会自动清除首尾空格，这与wikitext模板是一致的 -->
{{{ name }}}                      <!-- 命名参数 -->
{{{ 匿名参数2 | 默认值 }}}        <!-- 添加默认值 -->
{{{ 3 | {{{ age | 14 }}} }}}      <!-- 允许嵌套使用 -->
</nowiki>
}}

<!-- 使用模板 -->
{{ptl|use=模板名|参数...}}

• 模板代码需要使用<nowiki>标签包裹
• 若参数中要显示管道符，可以使用{{!}}代替
• 如果未对某个参数传参，也未设置默认值，这个参数的代码将被看作是一个普通字符串，这与wikitext模板是一致的。

简写

• 可以不填写use参数而直接使用，这时将调用上次调用过的模板
• 若从未调用过模板，则改为调用最新声明的那个模板

示例

示例1

{{ptl|define=plus|tl=<nowiki>
{{#expr:{{{1 | 0}}} + 1}}
</nowiki>}}
{{ptl}}

{{ptl|10}}

结果：

1

11

示例2

{{ptl|define=rect|tl=<nowiki>
<div style="width:{{{width | 100px}}}; height:{{{height | 100px}}}; background:{{{color | #eee}}};"></div>
</nowiki>}}
{{ptl|define=round|tl=<nowiki>
<div style="width:{{{width | 100px}}}; height:{{{height | 100px}}}; background:{{{color | orange}}}; border-radius:50%;"></div>
</nowiki>}}

{{ptl}}

{{ptl|use=rect|color=blue}}

结果：