Help:表の作り方

ごく単純な例を以下に示します。以下のように記述します。

{| class="wikitable"
|+ 表のタイトル
! 見出し0 !! 列見出しA !! 列見出しB !! 列見出しC
|-
! 行見出し1
| セル1A || セル1B || セル1C
|-
! 行見出し2
| セル2A || セル2B || セル2C
|}

これは、以下のような表が表示されます。罫線は #a2a9b1（■）、見出し背景は #eaecf0（■）、セル背景は #f8f9fa（■）で表示されます。

Template:Table2を用いて、以下のように書いても全く同じように表示されます。

{{Table2 | cols= 4 | caption= 表のタイトル
| th1= 見出し0 | th2= 列見出しA | th3= 列見出しB | th4= 列見出しC
| 行見出し1 | セル1A | セル1B | セル1C
| 行見出し2 | セル2A | セル2B | セル2C
| cell1-1= background:#eaecf0; font-weight:bold;
| cell2-1= background:#eaecf0; font-weight:bold;
}}

また、以下のように書いても全く同じように表示されます。

<table class="wikitable">
    <caption>表のタイトル</caption>
    <tr>
        <th>見出し0</th><th>列見出しA</th><th>列見出しB</th><th>列見出しC</th>
    </tr>
    <tr>
        <th>行見出し1</th><td>セル1A</td><td>セル1B</td><td>セル1C</td>
    </tr>
    <tr>
        <th>行見出し2</th><td>セル2A</td><td>セル2B</td><td>セル2C</td>
    </tr>
</table>

前者の {| で始まり、パイプ (|) を多用するものをパイプ構文と呼びます。後者は HTML5 で記述されています。それぞれに利点と欠点がありますが、以降はより簡潔に書けるパイプ構文を中心に解説していきます。

テーブルエンド（|}）を除く各マークは、オプションで1つ以上の属性を受け付けます。属性はマークと同じ行記述します。

• ヘッダーセル（! または !!）、データセル（| または ||）とキャプション（|+）は内容を持つので、

（! scope="row" | 見出し）のように、属性と内容をシングルパイプ（|）で区切って記述します。

• 表（{|）および行（|-）は内容を直接保持しないので、属性の後にパイプ（|）は必要ありません（例：|- style="position:sticky; top:0"）。

テーブルによく含まれる属性は以下の通りです。

class

例）class="wikitable sortable"

id

例）id="table-1"

style

CSSのスタイル設定

scope

ヘッダセルによる見出しの対象となるデータセルの範囲を示す

rowspan

セルを行方向に拡張する

colspan

セルを列方向に拡張する

 

編集ツールバーによって表の枠組みの簡易作成ができます。「 > 上級」を展開し、表アイコン   を押すことで、表の枠組みのフォーマットが挿入されます。

ただし、複雑な表を作るには以降のパイプ構文に通じている必要があるでしょう。

パイプ構文は、実際にはHTML要素の省略記法に過ぎません。HTMLの知識はそのままパイプ構文にも応用できます。

以下、「行」という語は表の横一列を、「列」という語は縦一列を意味します。構文上の改行記号で区切られる「行」については「ライン」と表記します。混同に気をつけてください。

重要なルール

各種の記号は必ずラインの先頭に書かねばならず、空白などを手前に入れてはいけません。

{| で開始し、 |} で終了するまでがひとつの表になります。開始記号と表の内容、終了記号はそれぞれ独立したラインに書く必要があります。これは <table></table> に相当します。

{|
     <!-- 表の内容を記述 -->
|}

|+ （パイプとプラス記号）に続けて書いた内容は、表のタイトルになります。これは省略可能です。 <caption></caption> に相当します。

{|
|+ タイトルを記述
     <!-- 表の内容を記述 -->
|}

表は、行をひとつの単位として記述します。 |- （パイプとマイナス記号）だけを独立したラインに記述すると、そこから新しい行を開始します。表中最初の行に限って、 |- を省略することができます。 <tr> に相当します。

{|
|+ タイトルを記述
|- <!-- この行にパラメータがなければ省略可能 -->
     <!-- 行の内容を記述 -->
|-
     <!-- 行の内容を記述 -->
|}

各行は、表の最小構成要素であるセルを1個以上含みます。セルは |（パイプ1個）で開始し、続けて同じラインにセルの内容を記述します。 <td> に相当します。

{|
|+ 表タイトル
|-
| セル 1
|-
| セル 2
|}

1行にセルを2個以上含める場合は、新しいラインに記述するか、既存のセルと同じラインに続けて || （パイプ2個）で区切って次のセルの内容を記述します。以下の2つの行の表示結果は全く同じになります。

{|
|+ 表タイトル
|-
| セル 1
| セル 2
| セル 3
|-
| セル 1 || セル 2 || セル 3
|}

パイプの代わりに ! （感嘆符）を使うことで、見出しセルを記述できます。使用するブラウザにもよりますが大抵はセル内でセンタリングされ、太字で表示されます。 ! で始まるラインに続けて書いたセルはすべて見出しセルとして扱われるので、通常のセルは新しいラインから書く必要があります。見出しセル同士の区切りは !! でも || でも可能ですが、分かりやすさのために !! を使用した方がいいでしょう。 <th> に相当します。

{|
|+ 表タイトル
|-
! 列見出し 1 !! 列見出し 2 !! 列見出し 3
|-
! 行見出し 1
| セル 1-2
| セル 1-3
|-
! 行見出し 2
| セル 2-2 || セル 2-3
|}

最後の例は、以下のように表示されます。

この例は必要最低限の記述しかしていないので、見た目が寂しいかもしれません。次の節で解説するパラメータを指定することにより、罫線など見た目を調整することが可能になります。

表全体、タイトル、各行、各セルにはパラメータを記述することができます。パラメータの記述により罫線や背景色などを変更できます。

表全体・行

開始記号に続けてパラメータを記述します。

タイトル・セル・見出しセル

開始記号の後にパラメータを記述し、 | （パイプ1個）で区切って内容を記述します。

{| （表全体のパラメータ）
|+ （タイトルのパラメータ） | タイトル
|- （行のパラメータ）
! （見出しセルのパラメータ） | 見出し
| （セル A のパラメータ） | セル A || （セル B のパラメータ） | セル B
|}

パラメータはHTML要素の属性に対応し、例えば表全体に対する指定 {| style="color:red;" ... |} は <table style="color:red;"> ... </table> として出力されます。

一部を除いて、ほとんどのパラメータはセルの結合（後述）と style 属性にインライン CSS で記述することになります。より詳しい解説は専門書や入門サイトなどに譲り、ここでは単純なものやよく使われるものに限って解説します。

テーブル全体に罫線を表示するのはとても簡単です。表全体のパラメータに、

{| class="wikitable"

と指定するだけです。先の例に適用すると、以下のように表示されます。

別の方法として border 属性を使用することができます。これはスタイルシートを理解しないブラウザで罫線を表示するための方法です。ただし、日本語版ウィキペディアでは、スタイルシートを理解しないブラウザに対応するためのガイドラインはありません。原則としては上記指定を用いて外観を統一してください^{[注 1][注 2]}。

{| border="1"

また、表全体の罫線を非表示にする場合は、何も指定する必要はありません。

 {|

表の一部にだけ罫線が必要な場合は、上記のように罫線を非表示にし、個々のセルの境界線を CSS で指定します。本ページ「#その他の CSS の利用」の節を参照してください。

セルの一部を結合して1つのセルのように扱うには、セルのパラメータに rowspan 属性または colspan 属性を指定します。

{| class="wikitable" style="text-align:center;"
|-
! || 列1 || 列2 || 列3
|-
| '''行 1'''
| rowspan="2" | A
| colspan="2" | B
|-
| '''行 2'''
| C <!-- 列 1 はセル A に塞がれている -->
| D 
|-
| '''行 3'''
| E
| rowspan="2" colspan="2" | F
|-
| '''行 4'''
| G <!-- 列 2 と 3 はセル F に塞がれている -->
|-
| '''行 5'''
| colspan="3" | H
|}

rowspan 属性を指定するとセルを縦に結合します。 colspan 属性を指定するとセルを横に結合します。

rowspan 属性、 colspan 属性ともに属性値を指定する事により指定された個数のセルを結合します。

表全体の幅を指定するには、表全体のパラメータに CSS の width プロパティを設定します。

ウィキマークアップ

{| class="wikitable" style="width:100%"
|+ 幅 100% の表
| セル1 || セル2 || セル3
|}
{| class="wikitable" style="width:80%;"
|+ 幅 80% の表
| セル1 || セル2 || セル3
|}<ref(?: name="(.*?)")?>((?:.|\n)*?)<\/ref>
{| class="wikitable" style="width:50%;"
|+ 幅 50% の表
| セル1 || セル2 || セル3
|}

実際の表示

列の幅を個別に指定するには、セルのパラメータにやはり width プロパティを設定します。1箇所で設定すれば、他の行の同じ列にも適用されます。

ウィキマークアップ

{| class="wikitable" style="width:80%;"
|+ 表全体の幅は 80%
| style="width:50%;" | 幅 50% のセル <!-- 表全体の幅に対する割合 -->
| style="width:10em;" | 幅 10em のセル
| 幅を指定しないセル
|}

実際の表示

幅を指定するもうひとつの方法に width 属性がありましたが、セルに対する width 属性は廃止されました^{[注 3]}。インライン CSS の width プロパティで置き換える必要があります。

表の左右の余白の幅を指定することで間接的に表の幅を指定する方法もあります。その場合は、 div 要素を用います。表の幅とは関係なく単に余白を設けたい場合や、左右に空けたスペースに記事などを入れたい場合は#表の配置を参照してください。

ウィキマークアップ

←元のテキストエリアの左端
<div style="margin:0 2em 0 4em;"> <!-- または <div style="padding:0 2em 0 4em;"> -->
{| class="wikitable" style="width:100%"
|+ 左に 4em 、右に 2em の余白を設け、残り全部が表全体の幅
| style="width:50%;" | 幅 50% のセル <!-- 表全体の幅に対する割合 -->
| style="width:10em;" | 幅 10em のセル
| 幅を指定しないセル
|}
</div>
<div style="text-align:right">元のテキストエリアの右端→</div>

実際の表示

表の高さを指定するには CSS の height プロパティ（line-height プロパティ）を設定します。表全体および行に対する設定が可能ですが列の幅と違い折り返しの発生などで行や表全体の高さは動的に変化するので、あえて設定することはあまりありません。

幅や高さを指定するのに様々な単位を使用できますが、特別な理由^{[注 4]}がない限り % （表示領域に対するパーセンテージ）か em （1em = 日本語表示環境で漢字1文字分）で指定してください。例えばセルの幅を px （ピクセル単位）で指定した場合、ブラウザの文字サイズを大きく設定してもセルの大きさは変化しないためたいへん見づらくなるおそれがあります。 em であれば基準となる文字サイズに連動してセルのサイズが変化します。

日本語を含むいくつかの言語では文中のどこでも折り返しが可能であるため、場合によっては、見出しセルや本文セルの語が折り返されて表示され非常に見づらくなります。これを防ぐには、 CSS の white-space プロパティを設定します。

セルのパラメータに nowrap 属性を使用して同じ効果を得られましたが、この属性は廃止されました^{[注 3]}。

参考：寿限無

ウィキマークアップ

{| class="wikitable"
|+ 見出しが折り返されてしまうかもしれない表
! 折り返されそうな見出し
| 寿限無寿限無五劫の擦り切れ海砂利水魚の水行末雲来末風来末食う寝る処に住む処やぶら小路の藪柑子パイポパイポパイポのシューリンガンシューリンガンのグーリンダイグーリンダイのポンポコピーのポンポコナーの長久命の長助
|}
{| class="wikitable"
|+ 見出しの折り返しを禁止した表
! style="white-space:nowrap;" | 折り返されそうな見出し
| 寿限無寿限無五劫の擦り切れ海砂利水魚の水行末雲来末風来末食う寝る処に住む処やぶら小路の藪柑子パイポパイポパイポのシューリンガンシューリンガンのグーリンダイグーリンダイのポンポコピーのポンポコナーの長久命の長助
|}

実際の表示

セル内の文字をセンタリングしたり右寄せにしたりするには、 CSS の text-align プロパティを設定します。行のパラメータとして設定すると行の中のセル全てに、表全体のパラメータとして設定すると表に含まれるセル全てに適用されます。

ウィキマークアップ

{| class="wikitable" style="width:100%;"
|+ 文字寄せのサンプル
| style="text-align:left;" | 左寄せのセル
| style="text-align:center;" | 中央寄せのセル
| style="text-align:right;" | 右寄せのセル
|}
{| class="wikitable" style="text-align:right;"
|+ 全部右寄せの表
! × !! 2 !! 3 !! 4 !! 5 <!-- 見出しセルには適用されない -->
|-
! 2
| 4 || 6 || 8 || 10
|-
! 3
| 6 || 9 || 12 || 15
|-
! 4
| 8 || 12 || 16 || 20
|-
! 5
| 10 || 15 || 20 || 25
|}

実際の表示

かつてこの用途に align 属性を使用し align="right" としていましたが、 HTML5 で廃止されました^{[注 1]}。

数値の桁を揃えたいときなどには、テンプレートの{{0}}も使用できます。

セル内の文字の垂直方向の配置を指定するには、 CSS の vertical-align プロパティを設定します。こちらは text-align プロパティと異なり、行や表全体に指定してもセルには反映されません^{[注 5]}。セルのパラメータとして使用してください。

ウィキマークアップ

{| class="wikitable" style="width:100%; height:3em;"
|+ 垂直方向の指定のサンプル
| style="vertical-align:top;" | 上辺で揃えたセル
| style="vertical-align:middle;" | 中央で揃えたセル
| style="vertical-align:bottom;" | 下辺で揃えたセル
|}

実際の表示

かつてこの用途に valign 属性を使用し valign="top" としていましたが、 HTML5 で廃止されました^{[注 1]}。

表を中央に表示するには、表全体のパラメータに以下を指定します。これは「上下に余白を空けず、左右の余白を自動計算する」という意味で、左右それぞれの端から等しい距離つまり中央に配置されます。

{| style="margin:0 auto;"

表を右または左に寄せるには、表全体のパラメータに以下を指定します。後に続くテキストは反対側に回り込み、余白部分に流し込まれる形になります。

{| class="floatright" <!-- 右寄せ -->

または

{| class="floatleft" <!-- 左寄せ -->

ウィキマークアップ

'''この段落は表の手前に書かれています'''：寿限無寿限無五劫の擦り切れ海砂利水魚の水行末雲来末風来末食う寝る処に住む処やぶら小路の藪柑子パイポパイポパイポのシューリンガンシューリンガンのグーリンダイグーリンダイのポンポコピーのポンポコナーの長久命の長助

{| class="wikitable floatright"
|+ 右寄せした表
! 見出し0 !! 列見出しA !! 列見出しB !! 列見出しC
|-
! 行見出し1
| セル1A || セル1B || セル1C
|-
! 行見出し2
| セル2A || セル2B || セル2C
|}

'''この段落は表の後に書かれています'''：寿限無寿限無五劫の擦り切れ海砂利水魚の水行末雲来末風来末食う寝る処に住む処やぶら小路の藪柑子パイポパイポパイポのシューリンガンシューリンガンのグーリンダイグーリンダイのポンポコピーのポンポコナーの長久命の長助

実際の表示

かつてこの用途に align 属性を使用し align="top" としていましたが、 HTML5 で廃止されました^{[注 1]}。

 

この項目では色を扱っています。閲覧環境によっては、色が適切に表示されていない場合があります。

背景色を指定するには、CSS の background-color プロパティを設定します。文字色は color プロパティを設定します。

※背景色と、文字（リンクや脚注を含む）の色の差が少ないと、文章が読みにくくなることがあります。

ウィキマークアップ

{| class="wikitable" style="background-color:#fdd;" <!-- 表全体の背景色をピンクに -->
|+ 表の色を設定する
! 見出しセル <!-- wikitable で見出しセルへの指定が上書きされるので、ピンクにならない -->
! 見出しセル
! style="background-color:#dfd;" | 背景色を変更した見出し <!-- セルに直接指定すれば変更可能 -->
|-
| style="color:#007;" | 文字色を変更したセル
| style="background-color:#dd7;" | 背景色を変更したセル
| セル
|-
| セル
| style="color:#fff; background-color:#700;" | 背景色と文字色を変更したセル
| セル
|- style="background-color:#ddf;"
| 行全体の || 背景色を || 変更
|}

実際の表示

かつてこの用途に bgcolor 属性を使用していましたが、 HTML5 で廃止されました。^{[注 1]} また文字色を変更するためにセル内の文字を <font> タグで囲む方法がありましたが、font 要素も同様に廃止されました^{[注 3]}。

Wikipedia:アクセシビリティ#色も参照してください。

class="sortable"を使用することによって、Javascriptで表の各列を昇順または降順にソート（整列）できるようになります。

ウィキマークアップ

{| class="wikitable sortable"
|+ 昇順・降順に並べ替えできるwikitable
! 見出し0 !! 列見出しA !! 列見出しB !! 列見出しC !! 列見出しD !! 列見出しC/D !! class="unsortable" | 列見出しE
|-
! 行見出し1
| a || ウ {{表計算%|10|60}} || あえて
|-
! 行見出し2
| b || ア {{表計算%|20|40}} || 整列ボタン
|-
! 行見出し3
| c || イ {{表計算%|30|80}} || 付けない列
|- class="sortbottom"
! 合計
| － || － {{表計算%|60|180}} || 最下部に固定
|}

実際の表示

並べ替えをしたくない列には class="unsortable" |をつけます。また、並べ替え時に、特定の行を最下部に固定したい場合は|- class="sortbottom"をつけます。

見た目の文字列（例：優勝）と見えない非表示の文字列（例：1位）を設定する（ソート順や整列する内容を変える）場合は、<span style="display:none;">1位</span>優勝と入力する。また、見えない文字列だけでなく、音声読み上げを行わない文字列を入力したい場合についての詳細は「Template:Display none」なども参照してください。

二行を一緒にソートしたい場合

二行のソートキー（セル内の文字列）を文字列のマークアップ部分まで含めて一致させた上で、<span style="display:none;">表示させない文字列</span>のマークアップを使い表示させる範囲だけを変えるという方法によって、ソート時に二行分が一緒に移動する表を作ることもできます。

二行を一緒にソートする表（ウィキマークアップ）

{| class="wikitable sortable" style="width:29em;"
! style="width:1.5em;" |   !! style="width:6em;" | 名前 !! style="width:6em;" | 出身地 !! style="width:7em;" | 生年月日 !! 記録
|-
! style="border-bottom:none;" | <span style="display:none;">1位</span>優勝
| A 
| 神奈川 
| 1950/5/5 
| 2:26:18<span style="display:none;"><div style="position:relative; left:-19em; margin-right:-19em; overflow:auto;">Aについての備考、Aについての備考、Aについての備考</div></span>
|- style="background:#fff;"
! style="border-top:none;" | <span style="display:none;">1位優勝</span>
| style="border-right:none;" | <span style="display:none;">A</span> 
| style="border-left:none; border-right:none;" | <span style="display:none;">神奈川</span> 
| style="border-left:none; border-right:none;" | <span style="display:none;">1950/5/5</span> 
| style="border-left:none;" | <span style="display:none;">2:26:18</span><div style="position:relative; left:-19em; margin-right:-19em; overflow:auto;">Aについての備考、Aについての備考、Aについての備考</div>
|-
（2位から5位は中略）
|}

二行を一緒にソートする表（実際の表示）

Javascriptを使用して、表を非表示にし(mw-collapsed)、「表示」をクリックなどすると表示されます(mw-collapsible)。モバイルビューでは折りたたまれません。

{| class="wikitable mw-collapsible mw-collapsed"
|+可読性を損なうかもしれない長い表
|-
! 表示を !! 押すと !! 開きます
|-
| 長いよ || 長いよ || 長いよ
|-
| ・<br>・<br>・ || ・<br>・<br>・ || ・<br>・<br>・
|-
| 長いよ || 長いよ || 長いよ
|}

class="wikitable" を使わずに罫線を表示するには、各セルに罫線を表示する設定を記述しなければなりません（正確には罫線と言うより、各セルの境界線（border、ボーダーライン）です）。

以下、表全体および各セルで border で始まる記述をしているのが罫線の指定部分です。

右から左へ進むかな文字の五十音表の例

ウィキマークアップ

{| style="width:20em; margin-left:1em; border-width:2px 3px 3px 2px; border-color:#a77 #733 #733 #a77; border-style:solid; border-collapse:collapse; background-color:white; text-align:center;"
|+ style="font-weight:bold; font-size:smaller;" | 五十音表
|-
! style="border-bottom:1px solid #733;" | ん
! style="border-bottom:1px solid #733;" | わ
! style="border-bottom:1px solid #733;" | ら
! style="border-bottom:1px solid #733;" | や
! style="border-bottom:1px solid #733;" | ま
! style="border-bottom:1px solid #733;" | は
! style="border-bottom:1px solid #733;" | な
! style="border-bottom:1px solid #733;" | た
! style="border-bottom:1px solid #733;" | さ
! style="border-bottom:1px solid #733;" | か
! style="border:solid #733; border-width:0 0 1px 1px;" | あ
|- style="background-color:#edd;"
| || style="color:#777;" | ゐ || り || || み || ひ || に || ち || し || き
! style="border-left:1px solid #733;" | い
|-
| || || る || ゆ || む || ふ || ぬ || つ || す || く
! style="border-left:1px solid #733;" | う
|- style="background-color:#edd;"
| || style="color:#777;" | ゑ || れ || || め || へ || ね || て || せ || け
! style="border-left:1px solid #733;" | え
|-
| || を || ろ || よ || も || ほ || の || と || そ || こ
! style="border-left:1px solid #733;" | お
|}

実際の表示

class="wikitable" を使いつつ、一部の罫線を非表示にする例です。

ウィキマークアップ

{| class="wikitable" style="text-align:center;"
!colspan="3"|期間
|-
|style="border-right:none;"|1962年4月2日<br/>A
|style="border-width:1px 0;" |-
|style="border-left:none;"| 1966年4月2日<br/>B
|}

実際の表示

表の中に、さらに表を表示することができます。以下の例では、セル2の中に青色で表示される別の表が入っています。内側の表であっても、表を開始する記号 ({|) がラインの先頭に来る必要があることに注意してください。

{| class="wikitable"
| セル1
| セル2
{| class="wikitable" style="background:#aad; margin:.5em;"
| 入れ子になった
|-
| 表
|}
| style="vertical-align:bottom;" | もとの表のセル3
|}

条件文を使う場合は引数の区切りにパイプが使用されるため、表のウィキマークアップに使うパイプと干渉してお互いがうまく動作しなくなってしまいます。このような場合、マジックワード {{!}} を利用して直接パイプを表記しないか、もしくは HTML で記述します。

以下は、表の一部に条件文を使用した例です。場合によって表示する内容を変更するテンプレートを作成する場合などに使います。Help:テンプレートとHelp:条件文も参照してください。

{| class="wikitable"
{{#if: {{{1|}}} 
| {{!}} 引数が指定されていれば表示する行
| {{!}} 引数が指定されていないときに表示する行
}}
|-
| 引数に関係なく表示する行
|}

<table class="wikitable">
{{#if: {{{1|}}} 
| <tr><td>引数が指定されていれば表示する行</td></tr>
| <tr><td>引数が指定されていないときに表示する行</td></tr>
}}
<tr><td>引数に関係なく表示する行</td></tr>
</table>

実際の表示

• Excel2Wiki（英語） - Excelで作成した表形式データを貼り付けるとwiki文法を生成します。ヘッダー行の指定やソート機能の設定などもオプション設定できます。列幅指定やセル結合はできません。
• MediaWiki Tables Generator（英語） - サイト上で表作成できます。列幅指定や左右上下の文字寄せも設定できます。またCSVファイルのインポートも可能です。
• CSV Converter（英語） - CSVファイルをインポートし、wiki文法を生成します。セル内の改行も反映されます。出力形式を選択でき、他言語文字化けにも対応できます。
• Copy & Paste Excel-to-Wiki Converter（英語）
• Table Capture（英語） - HTML Tableを選択すると、その表データをCSV形式に変換するChromeプラグインです。

• Wikipedia:スタイルマニュアル/表
• プロジェクト:テンプレート/マークアップ
• Help:ウィキテキストにおけるHTML
• Category:段組みテンプレート - 短い箇条書きなどの文章を段組み表示する各種テンプレート
• Template:0 - {{0}}と呼び出すと、不可視な数字の 0 （ゼロ）が挿入されます。表中で数字の桁を揃える用途に使用できます。
• MediaWiki:Common.css - wikitableのデフォルトの色設定などの解説
• mw:Help:Tables/ja - MediaWikiのHelp:表