模板: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}}

結果：