Template:Reflist/doc

使用本模板可在條目中顯示註腳（<ref>...</ref>）列表。其涵盖了<references />的所有功能。

参数解说

{{Reflist|欄位數/欄位寬度|group=组别|refs=列表內容|liststyle=|list=}}

本模板所有参数均为可选

无名参数1

按固定寬度分欄（填入em等排印单位）：如{{Reflist|25em}}，瀏覽器會依照這個數值和當前的視窗大小，自動調整欄位數目。

按列数分欄（填入自然数；因在手机等竖屏设备会使栏宽过窄，此機制不建議使用）：如{{Reflist|2}}將會創造出一個兩欄式的的注釋列表，而{{Reflist|3}}會產生一個三欄式的列表。視窗大小可变，请慎重定义列数。

不填任何内容默认为1。

group

参见分组注释

refs

将脚注内容集中到一起存放，参见#统一存放参考信息集

liststyle

list

手工列出一般参考资料，使用此参数时，模板原本列出<references />的功能会无效化。可用{{ReflistH}}/{{ReflistF}}模板替代。

过时参数

colwidth

已合并到无名参数1

用法

只使用内文注释

代码	效果
一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。 ==參考資料== {{Reflist}}	一條青龍一氣通，二盤連莊二本場。 參考資料

只使用一般注释

代码	效果
一條青龍一氣通，二盤連莊二本場。 ==參考資料== {{Reflist|list= * 书目a * 书目b }}	一條青龍一氣通，二盤連莊二本場。 參考資料

内文与一般注释混合使用

代码	效果
一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。 ==參考資料== {{Reflist}} {{Reflist|list= * 书目a * 书目b }}	一條青龍一氣通，二盤連莊二本場。 參考資料

分栏

不支持Internet Explorer 9、Firefox 1.0、Safari 2、Opera 11.0及更低版本，这些浏览器只会显示为单行

複數欄位是使用 CSS3 作為基礎，目前使用Gecko（如Mozilla Firefox等）与Kestrel（Opera (瀏覽器)9.5及以上版本）作排版引擎的瀏覽器會得到較佳的效果，但由於 CSS 是網頁上的標準之一，因此日後將能適用在更多的瀏覽器。

按宽度分栏（例如{{Reflist|30em}}）会让浏览器在给定最小宽度的前提下（如宽度至少为30 em），显示尽可能多的栏目。宽度单位支持em, ex, in, cm, mm, pt, pc, px，但是通常使用em。数字和单位之间不能有空格。不支持使用百分比。

根据参考内容的宽度选择合适的宽度：

• 30em：当有大量参考文献且参考条目有一页宽时适用。例如：張伯苓的版本71040939#参考文献
• 20em：当有宽度较短的哈佛参考文献格式（如{{Template:Sfn}}）时适用。例如：南方十字 (无字小说)的版本71611463#脚注.

按30em宽度分栏

代码	效果
一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。 ==參考資料== {{Reflist|30em}}	一條青龍一氣通，二盤連莊二本場。 參考資料

分为2栏

代码	效果
一條青龍一氣通<ref>參考1</ref>，二盤連莊二本場<ref>參考2</ref>。 ==參考資料== {{Reflist|2}}	一條青龍一氣通，二盤連莊二本場。 參考資料

注意：像这样指定栏数会使參考資料列表在手机等竖屏设备上也分为两栏，造成糟糕的显示效果。指定栏宽是更符合响应式网页设计的做法。

分組註釋

於2008年6月開始，腳註系統支援了把註釋分成不同組合。這允許組合註釋、參考以及其他。請參閱Help:脚注#把註腳分組。

標籤的原始碼为<ref group="groupname">，对应註腳列表的原始碼，{{Reflist|group="groupname"}}。而其中的「groupname」是組合的名稱，如「注」、「参」或「标签」。注意groupname对简繁体敏感。

部分分组会显示特殊效果，如<ref group="upper-alpha">...</ref>的生成的脚注为，<ref group="lower-alpha">...</ref>生成的为。

按“注释”和“参考”分组

代码	效果
三元兼四喜，滿貫<ref group="注释">注释1</ref>遇全么<ref group="参考">参考1</ref>。 花<ref group="注释">注释2</ref>自槓頭髮，月從海底撈<ref group="参考">参考2</ref>。 ==注释和参考资料== ===注释=== {{Reflist|group=注释}} ===参考=== {{Reflist|group=参考}}	三元兼四喜，滿貫遇全么。 花自槓頭髮，月從海底撈。 注释和参考资料 注释 参考

统一存放参考信息集

从2014年2月开始，该模板可以通过|refs=统一存放注脚信息来方便管理。此次更新的相關引用错误问题的提示文件見en:Help:Cite errors。

示例

代码	效果
这是参考A<ref name="refname1" />。 这是参考B<ref name="refname2" />。 ==参考资料== {{Reflist|refs= <ref name="refname1">内容1</ref> <ref name="refname2">内容2</ref> }}	这是参考A。 这是参考B。 参考资料

模板數據

以下是该模板的模板数据，适用于可视化编辑器等工具。

Reflist模板数据

<templatedata> {

 "description": "在條目中加入一個使用較小字級顯示的註腳列表。",
 "params": {
   "colwidth": {
     "label": "欄位的寬度",
     "description": "瀏覽器會依照這個數值和當前的視窗大小自動調整欄位數目，請依照該頁面中注釋的平均寬度來填寫欄位的寬度數值。填入後參數「1」將被忽略。",
     "type": "string/line",
     "required": false
   },
   "1": {
     "label": "欄位的數目",
     "description": "欄位的數目，填入2將創造一個兩欄式的的注釋列表，如此類推。这样指定的栏数是固定的，在竖屏手机上也会分成两栏。",
     "type": "number",
     "default": "1",
     "required": false
   },
   "list": {
     "label": "自定義註釋內容",
     "description": "自定義註釋內容。",
     "default": "",
     "type": "string",
     "required": false
   },
   "refs": {
     "label": "隱藏的引用書目欄",
     "description": "用來集中放置完整引用格式的參考文獻，内容不會直接顯示，只在有內文引用時才顯示，主要目的是讓編者減少由於內文與參考資料夾雜而導致查閲困難。",
     "type": "string",
     "required": false
   },
   "group": {
     "label": "註腳組別名稱",
     "description": "註腳組別的名稱，即在插入參考文獻時「使用此組」輸入的名稱。",
     "type": "string/line",
     "required": false
   }
 }

} </templatedata>

參見

• {{ReferencesWithExtra}}
• {{Notelist}}
• {{Template reference list}}
• 在討論頁顯示參考文獻請用{{Reflist-talk}}
• Help:脚注
• Wikipedia:列明来源

重定向

• {{註腳}}