Template:Reflist/doc

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

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

使用法

複数の列

ブラウザの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|2}}とすると脚注が2列のリストに、{{Reflist|3}}とすると3列のリストになります。

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

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

発生し得る問題

脚注の分裂

脚注が途中で改列されてしまった例(和田アキ子)

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

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

このテンプレートで複数列設定を行った場合に、あなたのブラウザでは1列に表示されていても、他の環境(ブラウザやウィンドウ幅など)によっては別の挙動を示すことがあります。可能ならば、なるべく多くの環境でテストすることをおすすめします。

列幅が極端に狭くなる

脚注の列数を極端に大きく設定すると、列の幅が非常に短くなり、見にくくなる恐れもあります。また、脚注自体が表示されなくなることもあります。

マークアップ	描画
このように、列数を多く設定した場合には、1列の幅が非常に短くなってしまい<ref>このような表示になってしまいます</ref>、スマートフォンだけでなく、パソコンにおいても見づらくなってしまいます。 ==脚注== {{Reflist|5}}	このように、列数を多く設定した場合には、1列の幅が非常に短くなってしまい、脚注が見づらくなってしまいます。 脚注

使用法

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

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

例

20em幅指定の場合

マークアップ	描画
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|20em}}	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文字列ならば使用することができます。 使用可能なスタイルは「en:Template:CSS list-style-type values」に列挙されています。

scroll引数（廃止）

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

関連項目

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