跳至內容

模板:虛擬模板/doc

本頁使用了標題或全文手工轉換
維基百科,自由的百科全書

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

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

參數及使用方法

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

模板資料

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

虛擬模板模板資料

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

模板參數

此模板以參數行內格式為優先。

參數描述類型狀態
11

傳入"code"參數的的第1個參數

範例
測試
字串非必填
codecode

模板語法

範例
{{{1}}}
字串非必填
code語法為nowikidelnowiki

解析code內容中位於nowiki標籤內的部分

布林值非必填
code語法為msgnwdelmsgnw

解析code內容中位於msgnw內的部分

布林值非必填

範例

  • 一般用法
    • 輸入{{虛擬模板|code=在{{{1}}}中,{{{2}}}是一門{{{3}}}。 | 數學 | 微積分 | 重要的議題 }}
      顯示為「在數學中,微積分是一門重要的議題。」
  • 強制注入參數
    • 輸入{{虛擬模板|code=在{{{1}}}中,{{{2}}}是一門{{{3}}}。|args={{虛擬模板|參數 | \1=物理學 | 數學 | 重要的議題 }} }}
      顯示為「在物理學中,數學是一門重要的議題。」
      ※註:如果{{虛擬模板}}的第一參數已經數入了「參數」來指定模式,那麼如果需要傳入真正的第一參數到模板裡的話,就需要使用跳脫字元的第一參數表示法:|\1=
  • 防止提前解析
    • 方法一,使用跳脫字元
      • 輸入{{虛擬模板|code={\{#tag:math{{!}}\\frac{ {{{1}}} }{ {{{2}}} } }\} | 16 | 25 }}
        顯示為「
    • 方法二,使用<nowiki></nowiki>
      • 輸入{{虛擬模板|delnowiki=yes|code=<nowiki>{{#tag:math|\\frac{ {{{1}}} }{ {{{2}}} } }}</nowiki> | 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}\}\}。}} $VAR_DEF 臨時模板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

技術限制

由於MediaWiki禁止模板迭代調用,因此在虛擬模板的code中使用其他虛擬模板可能會出現問題,例如

  • 輸入{{虛擬模板|code=一次,{{虛擬模板{{!}}code=二次}} }}
    顯示為「一次,檢測到模板循環:Template:虛擬模板

但若避免遞迴地傳入參數則沒有問題,如:

  • 輸入{{虛擬模板|code=一次,{{虛擬模板|code=二次}} }}
    顯示為「一次,二次」

此顯示的效果與普通模板雷同,此處以{{模板1}}做示範:

  • 輸入{{模板1}}
    顯示為「一次,檢測到模板循環:Template:模板1

重新導向

注意事項

模板編輯說明

參見