查看“模板:IconLink/doc”的源代码

<includeonly>{{Lua|Module:IconLink}}</includeonly>
{{测试中模板|使用方法更動}}
本模板可以给外部链接附上对应的图标。

在支持的范围内，提供以下便捷功能：
*根据URL自动识别网站；
*根据网站标识符和ID构建链接（如给出<code>tw</code>和<code>irodori7</code>即可构建链接[https://twitter.com/irodori7 https://twitter<wbr>.com<wbr>/irodori7]）；
*对于独特的ID格式（如BV号、sm号等），不填写网站标识符便能识别网站。

==效果和使用例==
*填写了标题时：{{icl|https://www.bilibili.com/video/BV1Wx411D74Q|【friends】哇咧哇咧哇 哇咧哇咧哇}}
*未填写标题时：{{icl|https://www.bilibili.com/video/BV1Wx411D74Q}}
*未匹配到网站，填写了标题时：{{icl|link=https://zh.moegirl.org.cn/_?curid=230429|动物游行 ～加帕里公园纪念～ - 萌娘百科 万物皆可萌的百科全书}}
*未匹配到网站，未填写标题时：{{icl|link=https://zh.moegirl.org.cn/_?curid=230429}}

;使用例
{{信息栏2.0
|top-bcolor=#0039e6
|t-bcolor=#757575
|l-bcolor=#4d79ff
|l-color=#fff
|title= '''可不'''
|image=KAFU.jpg
|别号=KAFU
|-橫欄1= 媒體
|_文字框=
|Youtube = {{IconLink|https://www.youtube.com/channel/UCm_1n9F3A6pz-Ms2NP93tBA|音楽的同位体「可不」 KAFU}}
|Twitter = {{IconLink|https://twitter.com/kaf_you|@kaf_you}}
}}

{| class="wikitable" style="font-size:small"
|-
! 投稿顺序 !! 投稿時間 !! 歌曲名稱 !! 作詞 !! 作曲 !! 編曲 !! 媒体
|-
| 2 || 2021年01月09日 || {{lj|「[[Hologram(一二三)|ホログラム]]」}} || [[一二三(P主)|一二三]] || [[一二三(P主)|一二三]] || [[一二三(P主)|一二三]] || {{IconLink|yt|NgEXMtQh_Gs}} {{IconLink|BV1Y54y1s7bH}} {{IconLink|sm38086642}}
|}

{| class="wikitable" style="font-size:small"
|-
! 投稿序號 !! 投稿時間 !! 投稿系列 !! 名稱 !! 媒体
|-
| #4 || 2020年08月16日 || {{lj|ヰ世界創世記}} || {{lj|「流星」}} || {{IconLink|tw|isekaijoucho 1294937774684958721}} {{IconLink|av586128057}}
|}
{{Clear}}

==用法==
<pre>-{}-{{icl|网站标识符|URL或ID|标题}}</pre>
“网站标识符”和“ID”请见[[#支持的网站]]。如果想用的ID不支持怎么办？——填写完整URL。

填写时必须按这个相对顺序，但并不是每个参数都要填写：
*填写了URL就不用填网站标识符，如<code style="overflow-wrap:break-word"><nowiki>{{icl|https://www.bilibili.com/video/BV1Wx411D74Q}}</nowiki></code>等同于<code style="overflow-wrap:break-word"><nowiki>{{icl|bili|https://www.bilibili.com/video/BV1Wx411D74Q}}</nowiki></code>。
*若ID符合[[#独特ID格式]]，则无需填写网站标识符。如<code><nowiki>{{icl|BV1Wx411D74Q}}</nowiki></code>等同于<code><nowiki>{{icl|bili|BV1Wx411D74Q}}</nowiki></code>。

===命名参数===
网址和标题中可能会有等号，这会与匿名参数冲突（等号前面的部分会被当成参数名）。因此本模板还支持一些命名参数，替换原本的匿名参数。
*<code>-{}-|site=网站标识符</code>（主要用于[[#封装模板]]）
*<code>|link=URL</code>
*<code>-{}-|title=标题</code>

例如（注意网址中的等号）：
*使用匿名参数：
**<code>-{}-&#123;&#123;icl|'''{{color|#c1000b|https&#58;//www<wbr>.youtube<wbr>.com<wbr>/watch<wbr>?v&#61;}}'''ZnfHNU6iej4|【PUBG限制玩法】不管说什么都愿意听的HINATA酱【#1X】&#125;&#125;</code>
**<strong class="error"><span class="scribunto-error">Lua错误 模块:IconLink的第XX行：分析参数失败</span></strong>
*使用命名参数：
**<code>-{}-&#123;&#123;icl|'''{{color|#007100|link&#61;}}'''https&#58;//www<wbr>.youtube<wbr>.com<wbr>/watch<wbr>?v&#61;ZnfHNU6iej4|【PUBG限制玩法】不管说什么都愿意听的HINATA酱【#1X】&#125;&#125;</code>
**{{icl|link=https://www.youtube.com/watch?v=ZnfHNU6iej4|【PUBG限制玩法】不管说什么都愿意听的HINATA酱【#1X】}}

----

以下参数只能使用命名参数：
* <code>size</code> 调整图标大小，格式与<code><nowiki>[[File:...|<size>]]</nowiki></code>中的相同。

例如：
* {{example|code=<nowiki>{{icl|BV1Wx411D74Q|size=42px}}</nowiki>|：}}

==支持的网站==
{|class="wikitable sortable"
! 网站 !! 标识符（不分大小写） !! 支持自动检测的域名 !! 支持的ID（部分大小写敏感）
|-
| [[AcFun]]
| <code>acfun</code>
| acfun<wbr>.cn
| 视频ac号<!--不支持文章ac号-->、UID
|-
| [[bilibili]]
| <code>bilibili</code>、<code>bili</code>、<code>bl</code>
| bilibili<wbr>.com
| av号、BV号、cv号、UID
|-
| Instagram
| <code>instagram</code>、<code>ig</code>
| instagram<wbr>.com
| 用户名（@后面的部分）
|-
| [[niconico]]
| <code>niconico</code>、<code>nc</code>
| nicovideo<wbr>.jp
| sm号、so号、UID
|-
| [[piapro]]
| <code>piapro</code>
| piapro<wbr>.jp
| piapro ID
|-
| [[Twitch(直播平台)|Twitch]]
| <code>twitch</code>、<code>ttv</code>
| twitch<wbr>.tv
| 用户（频道）名
|-
| 微博
| <code>weibo</code>、<code>wb</code>
| weibo<wbr>.com、weibo<wbr>.cn
| “https:<wbr>//weibo<wbr>.com/”后面的路径
|-
| X
| <code>x</code>、<code>twitter</code>、<code>tw</code>
| twitter<wbr>.com、x<wbr>.com
| 用户名<ref name="atUsername"/>、帖子（填写格式为“<code>-{}-用户名 帖子号</code>”）<ref name="atUsername">用户名带不带“@”均可。</ref>
|-
| [[YouTube]]
| <code>youtube</code>、<code>ytb</code>、<code>yt</code>
| youtube<wbr>.com
| 视频ID、频道ID（“UC”开头）、频道标识名（“@”开头）
|}
支持自动检测的域名理论上可以包含短链，但是为了鼓励使用完整链接，所以没做进去。

===独特ID格式===
如果ID符合独特ID格式，则无需填写网站标识符。
{|class="wikitable sortable"
! 独特ID !! 格式 !! 对应网站
|-
| ac号 || ac+数字 || AcFun
|-
| av号 || av+数字 || rowspan="3" | bilibili
|-
| BV号 || BV+字母数字
|-
| cv号 || cv+数字
|-
| sm号 || sm+数字 || niconico
|}

==封装模板==
不建议封装过多这样的模板，除非真的使用很广。

使用[[模块:IconLink]]的<code>wrapper</code>函数，以bilibili为例：
<pre>{{#invoke:IconLink|wrapper|site=bilibili}}</pre>

对于其他网站把“bilibili”换成对应的网站标识符就行。

封装模板在使用上除了没有“网站标识符”外，与本模板一致。

==注释==
<references/>
<includeonly>[[Category:外部链接模板]]</includeonly><noinclude>[[Category:模板文档]]</noinclude>