テンプレート:Reflist

脚注に参照文献リストを載せるためのテンプレートです。<references />の代用として{{Reflist}}を使用することができます。

本文と脚注のスタイルを変えて、全体を読みやすくするために用いられます。

使用法

複数の列

ブラウザのCSS3マルチカラムレイアウト対応

プロパティ	IE	Edge	Firefox	Safari	Chrome	Opera
column-width column-count	≥ 10 テンプレート:smaller	≥ 12 テンプレート:smaller	≥ 1.5 テンプレート:smaller	≥ 3 テンプレート:smaller	≥ 1 テンプレート:smaller	≥ 11.1 テンプレート:smaller
columns	≥ 10 テンプレート:smaller	≥ 12 テンプレート:smaller	≥ 9 テンプレート:smaller	≥ 3 テンプレート:smaller	≥ 1 テンプレート:smaller	≥ 11.1 テンプレート:smaller
break-before break-after break-inside	≥ 10 テンプレート:smaller	≥ 12 テンプレート:smaller	テンプレート:tooltip テンプレート:smaller	テンプレート:tooltip テンプレート:smaller	≥ 50 テンプレート:smaller	≥ 11.1 テンプレート:smaller

{{Reflist|30em}}などのように、emなどの相対単位やpxなどの絶対単位で幅を指定すると、その列幅以上になるように、脚注の列幅を指定できます。この際、数字と単位の間にはスペースを入れないでください。{{Reflist|colwidth=30em}}のように、列幅の前に「colwidth=」と入れても同じ表示を得ることができます。

{{Reflist|2}}とすると脚注が2列のリストに、{{Reflist|3}}とすると3列のリストになります。

一般にはem単位指定および列数指定が用いられています。

注意：2019年時点で、対応するブラウザは表のとおり。

発生し得る問題

脚注の分裂

脚注が途中で改列されてしまった例（テンプレート:oldid）。なお、この画像では列幅も小さくなっているが、現在は解消されている。

複数の列を使用することで、列の一番下に表示された脚注が次の列の頭に分かれて表示されてしまうことがあります。MediaWiki:Common.cssには表示が2列にわたって表示されないようにするCSSルールが含まれています。しかし、少なくない環境下において、1つの脚注であるにもかかわらず複数列表示の設定がされている場合や、スマートフォンで表示した場合などの特定の条件下では、1つの脚注が2列以上に分裂して表示されてしまうこともあります。

マークアップ [[:テンプレート:	描画
2列以上に組まれると<ref>このように脚注が表示されます。このように脚注が表示されます。</ref>、場合によっては1つの脚注が2列以上に分かれてしまいます。 この動作は、ウィンドウ幅やブラウザの種類によって表示が変化します。 == 脚注 == {{Reflist|10em}}	2列以上に組まれると、場合によっては1つの脚注が2列以上に分かれてしまいます。 この動作は、ウィンドウ幅やブラウザの種類によって表示が変化します。 脚注

このテンプレートで複数列設定を行った場合に、あなたのブラウザではそれぞれの脚注が1列に表示されていても、他の環境（ブラウザやウィンドウ幅など）によっては別の挙動を示すことがあります。

列幅が極端に狭くなる

脚注の列数を極端に大きく設定すると、列の幅が非常に短くなり、見にくくなる恐れがあります。そのため、列数指定に対しては、列幅がある一定の値（20em）未満にならないようになっています。

また、列幅が狭すぎると脚注自体が表示されなくなります。

マークアップ [[:テンプレート:	描画
このように、列数を多く設定した場合には、実際に表示される列数は、その列数よりも少なくなります<ref>このような表示になります。</ref><ref>このような表示になります。</ref><ref>このような表示になります。</ref>。 == 脚注 == {{Reflist|6}}	このように、列数を多く設定した場合には、実際に表示される列数は、その列数よりも少なくなります。 脚注

使用法

使用する列幅の指定や列数指定は編集者にゆだねられていますが、以下に一般的な指定を挙げます。

• 指定なしもしくは1列指定（既定）: 脚注が少ないときに用いられます。
• 30emもしくは2列以上指定: 多数の脚注を直接書いている場合に用いられます。
• 20em: {{sfn}} が使用されている場合によく用いられます。

例

15em幅指定の場合

マークアップ [[:テンプレート:	描画
Lorem ipsum.<ref>出典名、アクセス日時など</ref> Lorem ipsum dolor sit amet.<ref>出典名、アクセス日時など</ref> Lorem ipsum dolor sit amet.<ref>出典名、アクセス日時など</ref> Lorem ipsum dolor sit amet.<ref>出典名、アクセス日時など</ref> Lorem ipsum dolor sit amet.<ref>出典名、アクセス日時など</ref> == 脚注 == {{Reflist|15em}}	Lorem ipsum. Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet. 脚注

group引数

同一記事内に複数の脚注を設置する場合（<ref group=>, <references group=>を使用する場合）は、group引数を用いる事で対応できます。

表示例

• 脚注1では{{Reflist}}と書き、脚注は<ref>〜</ref>で括っています。
• 脚注2では{{Reflist|group=※}}と書き、脚注は<ref group="※">〜</ref>で括っています。

refs引数

<ref name="hoge">ほげほげ</ref> のような、内容とname属性をもつ脚注タグをrefs引数として列挙しておくと、ページ中でそのname属性を使うことができます。

使 用 例	これは本文です<ref group="†" name="hoge" />。ここでは説明ページの都合でgroup引数と併用していますが、もちろんgroup引数なしでも使えます<ref group="†" name="piyo" />。 {{Reflist|group="†"|refs=<ref group="†" name="hoge">これは脚注の内容です。</ref><ref group="†" name="piyo">これは本文中の脚注タグ内ではなく、refs引数の中に書いてあります。</ref>}}
実 際 の 表 示	これは本文です。ここでは説明ページの都合でgroup引数と併用していますが、もちろんgroup引数なしでも使えます。

通常――この機能を使わない場合は、name属性はページ中のどこかの脚注で定義しておく必要がありますが、それが消されると、name属性だけで記述している脚注でエラーとなってしまいます（実際、そのような編集はしばしば見られます）。このrefs引数で脚注のname属性を定義しておけば、このような事故を防ぐことができますし、ソースの可読性も向上します。

ただし欠点もあり、ここで定義された脚注が本文中で一度も使われなかった場合には、エラーが発生します。後で置換されたり除去されることが予想される脚注ではこの機能を使わず、普通に本文中の脚注タグで記述したほうが、後の編集者には親切かもしれません。

また、現在のところ、ここで入れ子脚注（H:REFNEST参照）を正常に利用することはできません。詳細はTemplate:Refnest#リスト定義時のエラーを参照してください。

liststyle引数

既定では、脚注は番号付けされて表示されます。liststyle引数を用いることで、脚注を番号付けさせないようにしたり、他の記号やローマ数字などで番号付けできるようになります。list-style-typeとして定義されたCSS文字列ならば使用することができます。 使用可能なスタイルは以下の表を参照してください。 テンプレート:CSS list-style-type values

scroll引数（廃止）

注意：2009年5月のHelp‐ノート:脚注における合意により、脚注をスクロール表示にしたい場合は各自Scrolled Reflistというガジェットを利用し、Template:Reflistのscrollパラメータは使用しないことになりました。なお、{{Reflist}}を使っている項目の脚注部分にはclass名として「reflist」が指定されていますので、ウェブブラウザのユーザスタイルシートにMediaWiki:Gadget-ScrolledReflist.cssの内容を転記すればIP利用者でも同等の効果を得ることができます。

追跡カテゴリ

• Category:Reflistで3列を指定しているページ - 第1引数に「3」を指定しているページを収集します。
• Category:Reflistで4列以上を指定しているページ - 第1引数に「4」もしくはそれ以上の列数を指定しているページを収集します。

テンプレートデータ

これはビジュアルエディターやテンプレートウィザードにより使用されるテンプレートのためのTemplateData文書です。

Reflist

This template displays the list of footnotes at the end of an article and provides additional formatting and organizing options. After hitting "Apply changes" and turning back to VE read mode, you will not see the references list. After hitting "Save page" and turning back to normal read mode the reference list will reappear with the changes applied, see T53146.

テンプレート引数

引数		説明	型	状態
Columns / Column width	1 colwidth	Two modes supported. First mode: integer number of fixed columns into which the reference list is to be rendered. Second mode: typographic unit of measurement such as 'em', specifying the width for the reference list columns, e.g. '33em'; spaced '33 em' will not be recognized 既定 1	文字列	省略可能
Liststyle	liststyle	Specifies the style used when the reference list is enumerated; accepts any valid CSS value defined for list-style-type 既定 decimal	文字列	省略可能
Group	group	Group is an identifier which restricts the references that are shown. Without this parameter, this template only shows references with no group identifier. With a group identifier specified, only references with a matching group identifier are handled. The rest are left alone.	文字列	省略可能
List of references	refs	Provides a space to define named references for use in the article. References defined in this space are not shown unless used somewhere in the article.	文字列	省略可能