appendメソッド

メソッドappendは、ある要素の末尾に別の要素を挿入することを可能にします。パラメータとして、通常はcreateElementで作成された要素、または文字列を受け取ります。カンマで区切って複数の要素や文字列を一度に追加することもできます。

構文

javascript親要素.append(要素または文字列);

例

段落を作成し、テキストを設定して、ページ上の#parentブロックの末尾に配置してみましょう:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
</div>
javascriptlet parent = document.querySelector('#parent');

let p = document.createElement('p');
p.textContent = '!';

parent.append(p);

コード実行結果:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
  <p>!</p>
</div>

例

#parentブロックの末尾に複数の段落を一度に配置してみましょう:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
</div>
javascriptlet parent = document.querySelector('#parent');

let p1 = document.createElement('p');
p1.textContent = 'a';

let p2 = document.createElement('p');
p2.textContent = 'b';

parent.append(p1, p2);

コード実行結果:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
  <p>a</p>
  <p>b</p>
</div>

例

メソッドのパラメータとして文字列を使用してみましょう:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
</div>
javascriptlet parent = document.querySelector('#parent');
parent.append('!');

コード実行結果:

html<div id="parent">
  <p>1</p>
  <p>2</p>
  <p>3</p>
  !
</div>

例

ulが与えられています。 その中に9個のliタグを配置し、それらのテキストを順番番号にしてみましょう:

html<ul id="parent"></ul>
javascriptlet parent = document.querySelector('#parent');

for (let i = 1; i <= 9; i++) {
  let li = document.createElement('li');
  li.textContent = i;
  parent.append(li);
}

コード実行結果:

html<ul id="parent">
  <li>1</li>
  <li>2</li>
  <li>3</li>
  <li>4</li>
  <li>5</li>
  <li>6</li>
  <li>7</li>
  <li>8</li>
  <li>9</li>
</ul>

例

trとtdでテーブルを埋めてみましょう:

html<table id="table"></table>
javascriptlet table = document.querySelector('#table');

for (let i = 1; i <= 3; i++) {
  let tr = document.createElement('tr'); // trを作成
  
  // trをtdで埋める:
  for (let j = 1; j <= 3; j++) {
    let td = document.createElement('td'); // tdを作成
    td.textContent = j; // テキストを書き込む
    
    tr.append(td); // 作成したtdをtrの末尾に追加
  }
  
  table.append(tr); // 作成したtrをテーブルの末尾に追加
}

コード実行結果:

html<table id="table">
  <tr>
    <td>1</td>
    <td>2</td>
    <td>3</td>
  </tr>
  <tr>
    <td>1</td>
    <td>2</td>
    <td>3</td>
  </tr>
  <tr>
    <td>1</td>
    <td>2</td>
    <td>3</td>
  </tr>
</table>

関連項目

  • メソッドprepend,
    要素を先頭に挿入します
  • メソッドappendChild,
    要素を末尾に挿入します
  • メソッドinsertBefore,
    要素の前に要素を挿入します
  • メソッドinsertAdjacentElement,
    指定された場所に要素を挿入します
  • メソッドinsertAdjacentHTML,
    指定された場所にタグを挿入します