模組:TalkIcon/doc

使用方法：

{{#invoke:TalkIcon|main|...arguments...}}

一般可以加上 safesubst：

{{{{{|safesubst:}}}#invoke:TalkIcon|main|...arguments...}}

可用參數

• icon、匿名參數 1：必填，分為單圖片（填入 File:XXXXX.jpg 形式）、多圖片（填入 multi:XXXXX1.jpg/XXXXX2.jpg/XXXXX3.jpg 形式）與純文字三種。
• text、匿名參數 2：選填，圖標對應文本。
• extra、匿名參數 3：選填，擴充功能參數。

包裹圖標相關

• type：選填，建議，圖標類型。填寫不存在的類型會被靜默忽略，若不確定請務必檢查輸出的 wikitext 是否包含這些 class。
  • 可用類型（完整可用列表請參考Module:TalkIcon/data）：
    • type=xfd：存廢討論（zhwiki-xfdicon）
      • type=xfd-delete（zhwiki-xfdicon-delete）、type=xfd-keep（zhwiki-xfdicon-keep）、type=xfd-move（zhwiki-xfdicon-move）
    • type=vote：投票（zhwiki-voteicon）
      • type=vote-support（zhwiki-voteicon-support）、type=vote-oppose（zhwiki-voteicon-oppose）、type=vote-neutral（zhwiki-voteicon-neutral）
    • type=spi：傀儡調查（zhwiki-spiicon）
    • type=humor、type=humour：幽默（zhwiki-humoricon）
    • type=discussion：其他可用於討論的圖標（zhwiki-discussionicon）
  • 若需使用多個類型，可用半形逗號,連接，如 xfd-delete,humor。
• id：選填，建議，圖標ID，如Template:Vd對應的ID應填入英文delete。輸出 class zhwiki-talkicon-<id>。
• iconClass：選填，其他欲包裹圖標的class。模板已自動帶入 skin-invert 無需傳入。
• iconColor：選填，懸浮於圖標上時要顯示的文字。
• iconLang：選填，圖標要適用的 HTML 語言，常見為填入 zh-Hant 以使用在簡體下不置中但繁體下置中的標點符號。
• iconStyles：選填，其他要包裹圖標的樣式。
• iconSpace：選填，是否在圖標正後方插入 。預設值：使用圖片圖標則為真，否則為假。注意空字串會被當成不指定此選項回落到預設值。

純文字圖標

• fg、iconColor：選填，建議，圖標前景色。
• bg、iconBackground：選填，建議，圖標背景色。

單圖片圖標

• size、iconSize：選填，圖標大小，預設 20px。
• alt、iconAlt：選填，圖標替代參數。
• link、iconLink：選填，圖標目標連結。

多圖片圖標

僅支援單圖片圖標的size參數，如有其他特殊需求請直接傳wikitext當純文本圖標使用。

無法被正確解析成標題的圖片會被自動忽略。

擴充功能參數

除了 extra 參數外，模組也支援以下包裝 extra 參數的參數：

• explain：選填，解釋，相當於 |extra=：{{{explain}}}。
• to：選填，至什麼什麼頁面，相當於 |extra={{#if:{{{to|}}}|至(...略)[[{{{to}}}](...略)}}。
  • wrapTo：包裹連結的符號，一般應使用 |wrapTo={{{w|{{{wrap|{{{wrapTo|}}}}}}}}} 應付不同需求。模板實現的包裹項目有（以下可填之值可能未完全列舉，詳請請參考模組）：
    • 引號「」：使用 q、quote、引号、引號。
    • 雙書名號《》：使用 b、book、书名号、書名號。
    • 單書名號〈〉：使用 single-book、单书名号、單書名號。
    • 書1：使用 b1、书1、書1（同雙書名號）。
    • 書2：使用 b2、书2、書2、s（同{{單雙書名號轉換}}）。
    • 書3：使用 b3、书3、書3、v（同{{引書號轉換}}）。

雜項

• wrapClass：選填，不建議使用，包裹在整個圖標輸出外面的class。
• wrapStyles：選填，不建議使用，包裹在整個圖標輸出外面的樣式。

範例

• {{#invoke:TalkIcon|main|File:Example.png|text=範例|alt=沙盒|link=Wikipedia:沙盒}} →  範例
• {{#invoke:TalkIcon|main|(×)|山豬|fg=red|bg=pink|type=xfd-delete,humor|id=delete}} → (×)山豬
• {{#invoke:TalkIcon|main|File:Vote.svg|size=24px|alt=投票|link=Project:投票}} →
• {{#invoke:TalkIcon|main|(？)|疑問|fg=white|bg=#007fff|iconLang=zh-Hant}} → (？)疑問
• {{#invoke:TalkIcon|main|⚠|注意|extra=你的腳下|iconStyles=font-family: 'Noto Color Emoji', 'Segoe UI Emoji', 'sans-serif';}} → ⚠注意你的腳下
• {{#invoke:TalkIcon|main|(►)|移動|fg=blue|bg=lightblue|to=Wikipedia:沙盒|wrapTo=q}} → (►)移動至「Wikipedia:沙盒」
• {{#invoke:TalkIcon|main|File:Symbol declined.svg|駁回|explain=使用者查核不是在釣魚}} →  駁回：使用者查核不是在釣魚
• {{#invoke:TalkIcon|main|multi:WikiProject Council project list icon.svg/書.svg|這是一本書}} →  這是一本書
• {{#invoke:TalkIcon|main|bg=black|fg=silver|( π )|題外話|iconSpace=false}} → ( π )題外話
• {{#invoke:TalkIcon|main|bg=black|fg=silver|( π )|題外話|iconSpace=true}} → ( π ) 題外話