HTML DOM Table createCaption()メソッドとは?構文と使い方をサンプルコードで解説
HTML DOM の Table createCaption() メソッドは、空の <caption> 要素を新しく生成し、HTML ドキュメント内のテーブルに追加するためのメソッドです。JavaScript を使ってテーブルにタイトル(キャプション)を動的に付加したい場合に活用できます。
構文
createCaption() メソッドの基本的な構文は以下のとおりです。
object.createCaption()
パラメータと戻り値
このメソッドは引数を受け取りません。呼び出すと、新しく生成された <caption> 要素が戻り値として返されるため、その要素に対して textContent や innerHTML を設定することで、キャプションのテキストを自由に指定できます。
使用例
それでは、HTML DOM Table createCaption() メソッドの具体的な使用例を見てみましょう。以下のコードでは、ボタンをクリックするとテーブルにキャプションが追加される仕組みになっています。
<!DOCTYPE html>
<html>
<style>
body {
color: #000;
background: lightblue;
height: 100vh;
text-align: center;
}
table {
margin: 2rem auto;
}
caption {
color: #db133a;
}
.btn {
background: #db133a;
border: none;
height: 2rem;
border-radius: 2px;
width: 40%;
display: block;
color: #fff;
outline: none;
cursor: pointer;
margin: 1rem auto;
}
.show {
font-size: 1.2rem;
}
</style>
<body>
<h1>DOM Table createCaption() メソッドのデモ</h1>
<table border="2">
<tr>
<td>名前</td>
<td>出席番号</td>
</tr>
<tr>
<td>John</td>
<td>071717</td>
</tr>
<tr>
<td>Jane</td>
<td>031717</td>
</tr>
</table>
<button onclick="create()" class="btn">キャプションを作成</button>
<script>
function create() {
var tableCaption = document.querySelector('table').createCaption();
tableCaption.innerHTML = "学生データ";
}
</script>
</body>
</html>コードの解説
ボタンがクリックされると create() 関数が実行され、querySelector('table') で取得したテーブル要素に対して createCaption() メソッドを呼び出します。これにより空の <caption> 要素がテーブルに追加され、続いて innerHTML プロパティを使って「学生データ」というテキストが設定されます。
実行結果
ページを開いた直後の表示は以下のようになります。

「キャプションを作成」ボタンをクリックすると、テーブルにキャプションが追加され、次のように表示されます。

まとめ
createCaption() メソッドを使えば、静的な HTML にキャプションを記述しなくても、ユーザーの操作に応じて動的にテーブルへタイトルを追加できます。なお、既にキャプションが存在する場合は新しい要素を作成せず、既存の <caption> 要素が返される点にも注意してください。逆にキャプションを削除したい場合は、deleteCaption() メソッドを使用します。
-
HTML DOM Table createTHead() メソッドの使い方を解説
createTHead() メソッドは、HTML DOM においてテーブル(table)オブジェクトに対して使用できるメソッドの一つです。このメソッドを呼び出すと、空の <thead> 要素が新しく生成され、HTML 文書内の対象テーブルに自動的に追加されます。テーブルに既に <thead> 要素が存在する場合は、新しく作成せずに既存の要素を返します。 構文 createTHead() メソッドの基本的な構文は以下の通りです。 object.createTHead() 引数は不要で、テーブルオブジェクトに対してそのまま呼び出すだけで動作します。戻り値として、作成または
-
HTML DOM テーブルの createTFoot() メソッドとは?使い方をサンプルコード付きで解説
HTML DOM の createTFoot() メソッドは、HTML文書内のテーブルに対して空の <tfoot> 要素を生成し、テーブルに追加するためのメソッドです。テーブルのフッター行(合計欄や注釈など)を動的に作成したい場合に活用できます。構文createTFoot() メソッドの基本的な構文は以下のとおりです。object.createTFoot()引数は不要で、呼び出されたテーブルオブジェクトに <tfoot> 要素が存在しない場合は新しく生成して返します。すでに存在する場合は、既存の <tfoot> 要素をそのまま返します。createTFoot