Template:Reflist

テンプレートの解説[表示] [編集] [履歴] [キャッシュを破棄]

このテンプレートは900,000以上のページで使われています。 余計な混乱やサーバーへの負荷を避けるために、どんな変更でも最初はテンプレートのサンドボックス・サブページ、テストケース・サブページもしくはあなた自身の利用者スペースのページで試すべきです。そうすれば、試した変更を1度の編集でこのテンプレートに加えることができます。しかし、最初にあなたの提案した変更を、この項目のノートで議論するようにお願いします。

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

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

使用法

複数の列

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

プロパティ	IE	Edge	Firefox	Safari	Chrome	Opera
column-width column-count	≥ 10 (2012)	≥ 12 (2015)	≥ 1.5 (2005)	≥ 3 (2007)	≥ 1 (2008)	≥ 11.1 (2011)
columns	≥ 10 (2012)	≥ 12 (2015)	≥ 9 (2011)	≥ 3 (2007)	≥ 1 (2008)	≥ 11.1 (2011)
break-before break-after break-inside	≥ 10 (2012)	≥ 12 (2015)	≥ 65 (2019)	≥ 10 (2016)	≥ 50 (2016)	≥ 11.1 (2011)

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

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

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

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

発生し得る問題

脚注の分裂

脚注が途中で改列されてしまった例（和田アキ子）。なお、この画像では列幅も小さくなっているが、現在は解消されている。

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

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

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

列幅が極端に狭くなる

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

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

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

使用法

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

• 指定なしもしくは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.[1] Lorem ipsum dolor sit amet.[2] Lorem ipsum dolor sit amet.[3] Lorem ipsum dolor sit amet.[4] Lorem ipsum dolor sit amet.[5] 脚注 出典名、アクセス日時など 出典名、アクセス日時など 出典名、アクセス日時など 出典名、アクセス日時など 出典名、アクセス日時など

group引数

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

表示例

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

脚注1

1. 1111111111
2. 2222222222
3. 3333333333

脚注2

1. aaaaaaaaaa
2. bbbbbbbbbb
3. cccccccccc

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>}}
実 際 の 表 示	これは本文です[† 1]。ここでは説明ページの都合でgroup引数と併用していますが、もちろんgroup引数なしでも使えます[† 2]。 これは脚注の内容です。 これは本文中の脚注タグ内ではなく、refs引数の中に書いてあります。

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

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

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

liststyle引数

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

none
1つめ 2つめ 3つめ 4つめ

disc
1つめ 2つめ 3つめ 4つめ

circle
1つめ 2つめ 3つめ 4つめ

square
1つめ 2つめ 3つめ 4つめ

decimal
1つめ 2つめ 3つめ 4つめ

decimal-leading-zero
1つめ 2つめ 3つめ 4つめ

lower-roman
1つめ 2つめ 3つめ 4つめ

upper-roman
1つめ 2つめ 3つめ 4つめ

lower-alpha
1つめ 2つめ 3つめ 4つめ

upper-alpha
1つめ 2つめ 3つめ 4つめ

lower-greek
1つめ 2つめ 3つめ 4つめ

armenian
1つめ 2つめ 3つめ 4つめ

georgian
1つめ 2つめ 3つめ 4つめ

hebrew
1つめ 2つめ 3つめ 4つめ

cjk-ideographic
1つめ 2つめ 3つめ 4つめ

hiragana
1つめ 2つめ 3つめ 4つめ

katakana
1つめ 2つめ 3つめ 4つめ

hiragana-iroha
1つめ 2つめ 3つめ 4つめ

katakana-iroha
1つめ 2つめ 3つめ 4つめ

CSSのlist-style-type引数

CSS 2.1のlist-style-type^[1]

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes

CSS 2.1で非推奨となったCSS2のlist-style-type^[2]

一部ブラウザではサポートされています。

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	No	No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	No	No

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	No	No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	No	No

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	No	No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	No	No

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	No	No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	No	No

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	No	No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	No	No

Internet Explorer					Firefox			Safari		Chrome				Opera
6	7	8	9	10	3	4	5	4	5	9	10	11	12	10	11	12
No	No	No	No	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	No	No

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

テンプレートパラメーター

パラメーター		説明	型	状態
段組みの列数または列幅	1 colwidth	2つのモードをサポートしています。モード1：指定した列数で参考文献リストを段組み。モード2：印刷用の “em” などの測定単位で列幅を指定（例：33em）して参考文献リストを段組み。 「33 em」のように空白を挟むと認識しません。 既定 1	短いテキスト	省略可能
リストスタイル	liststyle	参考文献リストを列挙するときに使用する書式を設定します。有効な CSS 値を list-style-type に定義できます。 値の候補 decimal upper-alpha upper-roman lower-alpha lower-greek lower-roman 既定 decimal	短いテキスト	省略可能
グループ	group	group は、表示する脚注を制限するパラメータ（識別子）です。このテンプレートに group パラメータを指定しないと、このパラメータのない脚注のみ表示します。指定すると group パラメータと一致する脚注に絞り込んで処理します。それ以外は処理されません。	短いテキスト	省略可能
出典のリスト	refs	記事内でどんな名前付き脚注を使うか、定義する場所を提供します。脚注をこの場所で定義すると、記事のどこかで1回も使用しないものは、一覧に表示されません。 例 <ref name="foo">ある出典。</ref>	内容	省略可能

このテンプレートは、記事の最後に脚注の一覧を表示し、追加の書式設定や整理のオプションを提供します。"Apply changes"（変更の適用）をクリックしてビジュアル編集（VE）表示モードに戻った後は、参照リストは表示されません。"Save page"（ページの保存）を押して通常の表示モードに戻すと、変更を適用した参考文献一覧が再び表示されます。Phabricator:T53146 を参照してください。

関連項目

• {{脚注ヘルプ}}
• {{Reflist-talk}} - ノートページ用。
• {{Notelist}} - 注釈リスト用。
• Help:脚注部分をスクロール化する

1. “Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification”. W3C (2010年12月7日). 2016年12月2日閲覧。
2. “Cascading Style Sheets, level 2 CSS2 Specification”. W3C (2008年4月11日). 2016年12月2日閲覧。

この解説は、Template:Reflist/docから呼び出されています。 (編集 | 履歴)
編集者は、このテンプレートをサンドボックス (編集 | 差分)とテストケース (編集)で試すことができます。（解説）
/docのサブページにカテゴリを追加してください。 このテンプレートのサブページ一覧。