模板: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:列明来源

重定向

• {{脚注}}