模板:虛擬模板/doc

此頁面是Template:虛擬模板的模板文件。
此頁面可能包含了模板的使用說明、分類和其他內容。

此模板文件被引用於約693,000個頁面，佔全部頁面的9%。
為了避免造成大規模的影響，所有對此模板文件的編輯應先於沙盒、測試樣例或您的沙盒上測試。
測試後無誤的版本可以一次性地加入此模板文件中，但是修改前請務必於討論頁發起討論。

模板引用數量會自動更新。

本模板不能替換參照嵌入。由於技術限制，在替換引用（subst）階段時nowiki的行為與非替換引用時不同，因此替換引用本模板將會導致其行為無法預期或者導致未定義行為。

如需將本模板替換引用須經由下列兩項程序進行（否則可能出現未定義行為）：
1. 將code參數中的內容改成使用跳脫字元（如{{改成\{\{），並移除nowiki和msgnw等調用。
2. 將模板調用改成{{subst:虛擬模板/auto}}完成替換引用。
若因技術原因無法完成以上操作，請使用{{softsubst}}，並依照預覽模式下的指示操作。

此模板使用Lua語言：

Module:TemplateParameters（沙盒）

本模板透過解析器函數，可在不建立一個新的模板的情況下，動態生成一個「虛擬的」臨時模板，並傳入參數進去，類似於C++或java的匿名函數、Closure或者JavaScript中的立即調用函數表達式。

用途：在部分說明文檔示範模板語法，或解協助解析條目中無法順利被解析的模板語法。
用法：由於需要先迴避模板語法在生成一個「虛擬的」臨時模板前就被解析，因此{{{}}}與{{}}皆要先由跳脫字元切割成如{\{\{}\}\}與{\{}\}的形式。

參數及使用方法

{{虛擬模板 | code= 填入模板語法 | ... | ... 傳入模板參數、當正常模板使用 }}

模板資料

以下是該模板的模板資料，適用於視覺化編輯器等工具。

虛擬模板模板資料

透過解析器函數，可在不建立一個新的模板的情況下，動態生成一個「虛擬的」臨時模板，並傳入參數進去

模板參數
此模板以參數行內格式為優先。
參數		描述	類型	狀態
1	`1`	傳入"code"參數的的第1個參數範例測試	字串	非必填
code	`code`	模板語法範例 {{{1}}}	字串	非必填
code語法為nowiki	`delnowiki`	解析code內容中位於nowiki標籤內的部分	布林值	非必填
code語法為msgnw	`delmsgnw`	解析code內容中位於msgnw內的部分	布林值	非必填

範例

一般用法
- 輸入{{虛擬模板|code=在{{{1}}}中，{{{2}}}是一門{{{3}}}。 | 數學 | 微積分 | 重要的議題 }}
  顯示為「在數學中，微積分是一門重要的議題。」
強制注入參數
- 輸入{{虛擬模板|code=在{{{1}}}中，{{{2}}}是一門{{{3}}}。|args={{虛擬模板|參數 | \1=物理學 | 數學 | 重要的議題 }} }}
  顯示為「在物理學中，數學是一門重要的議題。」
  ※註：如果{{虛擬模板}}的第一參數已經數入了「參數」來指定模式，那麼如果需要傳入真正的第一參數到模板裡的話，就需要使用跳脫字元的第一參數表示法：|\1=。
防止提前解析
- 方法一，使用跳脫字元
  - 輸入{{虛擬模板|code={\{#tag:math{{!}}\\frac{ {{{1}}} }{ {{{2}}} } }\} | 16 | 25 }}
    顯示為「 ${\frac {16}{25}}$ 」
- 方法二，使用<nowiki></nowiki>
  - 輸入{{虛擬模板|delnowiki=yes|code=<nowiki>{{#tag:math|\\frac{ {{{1}}} }{ {{{2}}} } }}</nowiki> | 16 | 25 }}
    顯示為「 ${\frac {16}{25}}$ 」
測試間接參數傳遞時，特定模板語法的行為
- 輸入{{虛擬模板|delnowiki=yes|code=<nowiki>{{#invoke:ilh|main}}</nowiki> | lang=維基數據 | lang-code=d | Minecraft世界 | Q26945014 }}
  顯示為「Minecraft世界（：Q26945014）」
  - 說明：虛擬模板內的語法為「{{#invoke:ilh|main}}」，當這個內容是一個獨立的模板時，結果為輸入參數「| lang=維基數據 | lang-code=d | Minecraft世界 | Q26945014」的行為。
作為空模板
- 與匿名函數原理類似，同樣可以僅宣告但不提供內容
- 此時則與{{void}}相同
- 輸入{{虛擬模板|void}}
  顯示為「」；展開為「」
還原跳脫字元
- 輸入{{虛擬模板|code=\n**:#第甲項\tAA\b\n**:#第乙項\tBB\b}}
  顯示為「
  1. 第甲項 AA�
  2. 第乙項 BB�」
{{虛擬模板}}的傳遞與使用（僅在單次頁面渲染有效）
照順序擺放代碼將有以下效果：
1. {{變數|set|臨時模板1=虛擬模板{{!}}code=順利地執行了{\{\{1}\}\}的臨時模板{\{\{2}\}\}。}}
2. {{變數|call|臨時模板1| 1號 | 引用 }}→「順利地執行了1號的臨時模板引用。」
延伸用法（讓模板可以自己產生內容，又能讓外部調用）
1. 模板內：{{虛擬模板|code={\{#invoke:Fullurl|fullurl}\}|args=<noinclude>{{虛擬模板|參數|\1=Template:虛擬模板}}</noinclude>{{#invoke:參數|虛擬模板擴展參數}}}}
  模板顯示：Template:虛擬模板
2. 調用{{模板名|Module:TemplateParameters2}}
  顯示：Module:TemplateParameters2