Template:Ptl

模板文档  

这个文档嵌入自Template:Ptl/doc。

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

不建议继续使用

此模板正在使用的Variables扩展将于2025-9-11 21:46（UTC+8）永久移除，在此警告被移除之前，请勿继续使用此模板。

• 若继续使用此模板创建页面内模板，可能会收到103号滥用过滤器的警告。
• 请尽量在模板页面空间下，创建同名页面并提交修改，若您编辑的内容仅用于用户页，请直接调用目标用户页。
• 若您具备一定的网页编程能力，可根据源代码使用替代办法，避开存在问题的代码或运行库。

简介

该模板用于在页面中模拟出一个“页面内模板（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}}

结果：