これはTemplate:Box-headerの解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。

Luaモジュールを使用しています: モジュール:Box-header

これはウィキポータルにおいて、コンテンツをボックスで囲って表示するテンプレートのひとつです。主に文章で構成されるコンテンツに適しています。スタイルをある程度標準化することを狙っています。

このテンプレートは単独ではうまく動作しません。必ず{{Box-footer}}と組み合わせて使います。

ポータル向けに最適化するため、デフォルトで編集画面へのリンクを表示する設定になっています。ポータル以外に使うときは、TOC や EDIT に yes の値を入れなければ前記のような表示になる点、注意してください。

いくつかのパターンのひな形を提示します。

ひな形1

サブページを作って参照読み込みする場合は以下のような構文にします。

{{Box-header
| title = <!-- タイトル -->
| editpage = <!-- 編集リンク先ページ名 -->
| noedit = <!-- 入力した場合は編集リンク非表示 -->
| titleforeground = <!-- タイトルの文字の色 -->
| titlebackground = <!-- タイトルボックスの背景色 -->
| background = <!-- 本体ボックスの背景色 -->
| border = <!-- ボックス全体の線の色 -->
| body-font-size = <!-- 本体ボックスのフォントサイズ -->
| viewpage = <!-- editpageと同じサブページ名。入力した場合は「表示」リンク表示、入力しなかった場合は非表示 -->
}}
{{<!-- editpageと同じサブページ名 -->}}
{{Box-footer | <!-- 本体ボックス末尾の右寄せテキスト --> }}

ひな形2

以下のTemplate:ウィキポータルボックスヘッダの同じ引数名でも動作します。（なお、ウィキポータルボックスヘッダにnoedit、viewpage引数はありません）

{{Box-header
| タイトル = <!-- タイトル -->
| 編集ページ = <!-- サブページ名。 -->
| noedit = <!-- 入力した場合は編集リンク非表示。 -->
| タイトル字色 = <!-- タイトルの文字の色 -->
| タイトル背景色 = <!-- タイトルボックスの背景色 -->
| 背景色 = <!-- 本体ボックスの背景色 -->
| 線色 = <!-- ボックス全体の線の色 -->
| body-font-size = <!-- 本体ボックスのフォントサイズ -->
| viewpage = <!-- editpageと同じサブページ名。入力した場合は「表示」リンク表示、入力しなかった場合は非表示。 -->
}}
{{<!-- 編集ページと同じサブページ名。 -->}}
{{Box-footer | <!-- 本体ボックス末尾の右寄せテキスト --> }}

ひな形3

サブページを作らず、ヘッダとフッタの間にコンテンツを記載する場合は以下のような構文にします。editpage、viewpage引数が不要となるため省かれています。

{{Box-header
| title = <!-- タイトル -->
| titleforeground = <!-- タイトルの文字の色 -->
| titlebackground = <!-- タイトルボックスの背景色 -->
| background = <!-- 本体ボックスの背景色 -->
| border = <!-- ボックス全体の線の色 -->
| body-font-size = <!-- 本体ボックスのフォントサイズ -->
}}

<!-- 本体ボックス部分に載せたいテキストをここに書きます -->

{{Box-footer | <!-- 本体ボックス末尾の右寄せテキスト --> }}

「Portal:なになに/box-header」「Portal:なになに/ボックスヘッダ」のような各ポータル専用テンプレートページを作ることが可能です。これで色などのスタイルを指定しておくと（例:Portal:文学/ボックスヘッダ、Portal:災害/box-header）、何度もTemplate:Box-headerを呼び出して色などの指定を行う必要がなくなります。

入力例1

文字色や背景色を指定するときは、例えば以下のようになります。

{{Box-header
| title = 特集項目
| editpage = Wikipedia:サンドボックス
| titleforeground = white
| titlebackground = #3366cc
| background = white
}}

[[Image:Castillo-de-arena.jpg|150px|left|サンプル画像左寄せ]]
'''特集項目'''とは、ウィキポータルにおいて導入部を引用して紹介される記事のこと。その分野の、主要なトピック、良質な記事といった受賞記事などの中から選定される。

{{Box-footer| ……[[Wikipedia:ウィキポータル|もっと見る]] }}

特集項目とは、ウィキポータルにおいて導入部を引用して紹介される記事のこと。その分野の、主要なトピック、良質な記事といった受賞記事などの中から選定される。

……もっと見る 先頭へ:？

入力例2

文字色や背景色を指定しない場合、以下のようにデフォルトの配色になります。

{{Box-header
| title = 特集項目
| editpage = Wikipedia:サンドボックス
}}

[[Image:Castillo-de-arena.jpg|150px|left|サンプル画像左寄せ]]
'''特集項目'''とは、ウィキポータルにおいて導入部を引用して紹介される記事のこと。その分野の、主要なトピック、良質な記事といった受賞記事などの中から選定される。

{{Box-footer| ……[[Wikipedia:ウィキポータル|もっと見る]] }}

特集項目とは、ウィキポータルにおいて導入部を引用して紹介される記事のこと。その分野の、主要なトピック、良質な記事といった受賞記事などの中から選定される。

……もっと見る 先頭へ:？

入力例3

[編集]を表示させたくないときは、以下のようにnoedit引数を指定します。

{{Box-header
| title = 特集項目
| titleforeground = white
| titlebackground = #3366cc
| background = white
| noedit = yes
}}

[[Image:Castillo-de-arena.jpg|150px|left|サンプル画像左寄せ]]
'''特集項目'''とは、ウィキポータルにおいて導入部を引用して紹介される記事のこと。その分野の、主要なトピック、良質な記事といった受賞記事などの中から選定される。

{{Box-footer| ……[[Wikipedia:ウィキポータル|もっと見る]] }}

特集項目とは、ウィキポータルにおいて導入部を引用して紹介される記事のこと。その分野の、主要なトピック、良質な記事といった受賞記事などの中から選定される。

……もっと見る 先頭へ:？

入力例4

以下の引数でも、入力例3と同じ動作をします。

{{Box-header
| タイトル = 特集項目
| タイトル字色= white
| タイトル背景色 = #3366cc
| 背景色 = white
| noedit = yes
}}

[[Image:Castillo-de-arena.jpg|150px|left|サンプル画像左寄せ]]
'''特集項目'''とは、ウィキポータルにおいて導入部を引用して紹介される記事のこと。その分野の、主要なトピック、良質な記事といった受賞記事などの中から選定される。

{{Box-footer| ……[[Wikipedia:ウィキポータル|もっと見る]] }}

特集項目とは、ウィキポータルにおいて導入部を引用して紹介される記事のこと。その分野の、主要なトピック、良質な記事といった受賞記事などの中から選定される。

……もっと見る 先頭へ:？

• editpage – [編集] をクリックしたときに編集画面を開くページ名を指定します。サブページを編集させたい時によく使用します。例えばPortal:日本で使う場合、未指定ではPortal:日本を編集するリンクになってしまいますが、「Portal:日本/特集」と入力すればPortal:日本/特集を編集するリンクにできます。名前空間を含むページ名（{{FULLPAGENAME}}に相当）を指定する必要があります。既定値ではそのテンプレートを読み込んでいるページになります。
• noedit – デフォルトでは [編集] のリンクが右端に表示されますが、|noedit=yes（または空白以外の何らかの文字）を入力すると、これを非表示にできます。なお、|EDITLINK=に空白以外の何らかの文字が入力されているときも、編集リンクは非表示です。
• section – デフォルトでは [編集] をクリックしたときにページ全体を編集します。この引数に|section=2のような数字を指定すると、その番号の節単位編集の画面を開くようになります。
• title – ボックスのタイトルです。例:|title=主要項目
• top – 右端の [編集] [表示] リンクの次に追加表示するテキストを指定できます。|EDITLINK=に空白以外の何らかの文字が入力されているときは、非表示です。
• viewpage – 右端の [編集] の次に表示される [表示] のリンク先ページ名を指定します。無効なページ名を指定するとエラーになります。|EDITLINK=に空白以外の何らかの文字が入力されているときは、非表示です。

• EDIT – 読み込みテンプレート等で右端の [編集] リンクを表示させない設定になっていても、|EDIT=yes（または空白以外の何らかの文字）を入力すると強制表示させることができます。
• EDITLINK – |EDITLINK=no（または空白以外の何らかの文字）を入力すると、右端の [編集] [表示] リンクを非表示にできます。
• SPAN – デフォルトでは、ボックスのタイトル部分に<h2>...</h2>タグを使用します |SPAN=yes （または空白以外の何らかの文字）を入力すると、<span>...</span>タグに変更できます。
• TOC – デフォルトでは、目次は非表示です。|TOC=yes（または空白以外の何らかの文字）を入力すると、表示させることができます。

（2025年7月調査時点の仕様）

• titlebackground – タイトルボックスの背景色
• titleforeground – タイトルの文字の色
• background – 本体ボックスの背景色
• foreground – 本体ボックスの文字の色
• title-font-family – タイトルの書体
• title-font-size, titlefont-size – タイトルのフォントサイズ
• title-font-weight – タイトルのフォントの太さ
• font-family – タイトルボックスの書体
• font-size – タイトルボックス右端の「編集」「表示」およびtopの引数のフォントサイズ。※タイトル自体や本体ボックスには適用されません。
• extra – タイトルボックスの追加のCSSスタイルを指定します。
• border – ボックス全体の線の色
• border-top – タイトルボックスの上側・下側の線の太さ（px単位、単位は省略）
• border-type – ボックス全体の線の形式。CSSにおけるborder-styleに相当。規定値solid（1本線）から、double（2本線）、none（線なし）などに変更できる。
• border-width – ボックス全体の線の太さ
• titleborder – タイトルボックスの線の色
• background-opacity – 本体ボックスの背景・文字の不透明度
• body-font-size – 本体ボックスの文字のフォントサイズ（日本語版独自仕様につき、英語版では未実装）
• padding – タイトルボックス内、本体ボックス内それぞれの余白
• padding-top – タイトルボックス内の上方向の余白
• padding-left – タイトルボックス内の左方向の余白
• padding-right – タイトルボックス内の右方向の余白
• padding-bottom – タイトルボックス内の下方向の余白
• title-align – タイトルの水平方向の寄せ位置（左・中央・右など）
• text-align – 本体ボックス内の水平方向の寄せ位置（左・中央・右など）
• title-border-radius – タイトルボックスの角を丸める半径。例えば|title-border-radius=0.5em 0.5em 0 0と指定すれば、左上と右上の角が半径0.5emで丸められます。
• border-radius – 本体ボックスの角を丸める半径。例えば|border-radius=0 0 0.5em 0.5emと指定すれば、左下と右下の角が半径0.5emで丸められます。

上下2つのボックスのうち、「タイトルボックス」(title-container)はタイトル部分のボックス、「本体ボックス」（box-header-body）はその下の中身部分のボックスを指します。「タイトル」は|title=に入力する文字部分を指します。「タイトルボックス」に適用するスタイルはタイトルおよびこのボックス内のほかの文字にも適用されますが、「タイトル」に適用するスタイルはこのボックス内のほかの文字には適用されません。

ほとんどの引数の名前はCSSのスタイルのプロパティに合わせる形に設計されています。

{{Box-footer}} も参照。右下の「先頭へ」または「目次へ」のリンクはBox-footerの機能です。

Template:ウィキポータルボックスヘッダ、Portal:Box-headerとこのテンプレート（Template:Box-header）の各引数は以下のように対応します。

※編集リンクの表示/非表示について :

• ウィキポータルボックスヘッダでは、|編集ページ=にする（空の値を入力する）と編集リンクは非表示になります。
• Portal:Box-headerでは、|EDIT=noまたは|EDITLINK=no（あるいは、いずれも空白以外の何らかの文字）を入力したとき、編集リンクは非表示になります。
• Template:Box-headerでは、|noedit=yesまたは|EDITLINK=no（あるいは、いずれも空白以外の何らかの文字）を入力したとき、編集リンクは非表示になります。

アクセシビリティの配慮に乏しい（Wikipedia:色の使用に準拠していない）配色を使っているページには、次のカテゴリが自動で付与され追跡対象となります。

• タイトルの配色コントラスト比が 4.5：1 未満 と不十分なもの - Category:タイトルの配色コントラスト比が不十分なBox-header
• 本体ボックス部分の配色コントラスト比が 7：1 未満 と不十分なもの - Category:本体の配色コントラスト比が不十分なBox-header

文字色に対してタイトル背景色が濃すぎる場合、また文字の方が明るい反転の配色の場合は文字色に対してタイトル背景色が薄すぎる場合に該当します。できるだけ修正したほうがよいでしょう。なお、下の配色の見本はすべて配色コントラスト比の基準を満たしているので参考となります。

/doc/color sample参照。

ポータル関連テンプレート
テンプレート使用方法の視覚的概要（英語版）
レイアウトと書式	{{Box portal skeleton}} {{Box-header}} 配色パレット シンプル（英語版） 角丸 四角（英語版） ウォッチリスト対応 {{Box-header colour}}[1] {{Box-footer}} {{Flex columns}} {{Plain navboxes}}
内容の読み込み（トランスクルージョン）	{{Transclude lead excerpt}}[2] {{Transclude linked excerpt}}[2] {{Transclude list item excerpt}}[2] {{Transclude random excerpt}}[2] {{Transclude selected excerpt}}[2] {{Excerpt}} {{Transclude DYK}}[9] {{Transclude selected current events}}[3] {{Transclude selected recent additions}}[4]
内容のスライドショー	{{Random slideshow}}[5] {{Transclude files as random slideshow}}[5] {{Transclude excerpts as random slideshow}}[6] {{Transclude linked excerpts as random slideshow}}[6] {{Transclude list item excerpts as random slideshow}}[6]
内容のランダム化	{{Random portal component}}[7] {{Random quotation}} {{Random subpage}}
一般	{{Portals}} {{Portals browsebar}} {{Portal description}} {{Portal information sidebar}} {{Portal navbar no header2}} {{Purge link portals}} {{WikimediaForPortals}}
リンク用テンプレート	{{ウィキポータルリンク}}[11] {{Portal bar}}[12] {{Portal-inline}}[13] {{Pbox}} {{Related portals2}}
トークページ・メンテナンス	{{Portal talk}} {{Portal maintenance status}}[8] {{Portal suggestions}} {{Portal toolbox}} {{WikiProject Portals}}[8]
画像	{{Portal dynamic image}} {{Portal image banner}}[10] {{Portal pictures}}[14] {{Portal POTD}}
モジュール	1. モジュール:Box-header 2. モジュール:Excerpt/portals（英語版） 3. モジュール:Selected current events（英語版） 4. モジュール:Selected recent additions（英語版） 5. モジュール:Random slideshow（英語版） 6. モジュール:Excerpt slideshow（英語版） 7. モジュール:Random portal component 8. モジュール:Portal maintenance status（英語版） 9. モジュール:Transclude DYK（英語版） 10. モジュール:Portal image banner（英語版） 11. モジュール:Portal 12. モジュール:Portal bar 13. モジュール:Portal-inline（英語版） 14. モジュール:Portal pictures（英語版）
ウィキプロジェクト	{{Portal and project}} {{WPbox}} {{NBbox}}
使用方法	Wikipedia:ウィキポータル Wikipedia:WikiProject ポータル（英語版）
詳細は Category:Template-Class Portal pages および Category:Wikipedia Portal templates を参照