HOWTO · JavaScript
JavaScript を使用して既存の HTML 要素に HTML コンテンツを追加する
このチュートリアルでは、JavaScript を使用して HTML を追加する方法について詳しく説明します。
このページの内容
既存の要素にコンテンツを追加するときは、追加するものに応じて API を選びます。DOM ノードを追加するには appendChild() を使い、HTML 文字列を解析して指定位置に挿入するには insertAdjacentHTML() を使います。innerHTML に値を代入すると要素の子孫が置き換わるため、既存の子要素を維持したい場合には適しません。
innerHTML を使って新しい HTML ノードを追加する際の注意点
要素の innerHTML に文字列を設定すると、その文字列が解析され、要素の子孫ノードが置き換わります。その結果、子孫ノードが保持していた状態や、それらのノードに直接設定されたイベントリスナーが失われることがあります。ただし、対象要素の属性がすべて削除されるわけではありません。対象要素自体は残り、その子要素が置き換わります。
innerHTML と insertAdjacentHTML() は、どちらも文字列をマークアップとして解析します。文字列に信頼できない入力が含まれていると、クロスサイトスクリプティング(XSS)のリスクが生じることがあります。ユーザー提供の値には、textContent などのテキスト用プロパティを使ってノードを作成する方法を優先してください。マークアップを挿入する必要がある場合は、アプリケーションに適した方法でサニタイズします。MDN の innerHTML に関するセキュリティ上の注意も参照してください。
DOM 要素を置き換えずに HTML コンテンツを追加する
新しく要素を作る場合は、ノードを作成して既存のツリーに挿入します。信頼できる HTML 文字列を使う場合は、insertAdjacentHTML() で挿入位置を選びます。どちらの方法でも、対象要素の既存の子孫を置き換えずにコンテンツを追加できます。以下では、小さな住所フォームを使って両方の方法を示します。
JavaScript で appendChild() を使って HTML コンテンツを追加する
appendChild() が受け取るのはノードであり、HTML 文字列ではありません。対象要素の現在の最後の子の後ろにノードを追加します。そのノードがすでに文書内の別の場所にある場合は、複製されず、同じノードが移動します。
次の例を実行してください。
このセクションのコードと表示されるラベルや出力は英語のままです。
function addAddressLine(addressContainer, lineCount) {
const input = document.createElement("input");
input.type = "text";
input.placeholder = `Address Line ${lineCount}`;
addressContainer.appendChild(input);
}
if (typeof document !== "undefined") {
let lineCount = 0;
const button = document.getElementById("add-address");
const addressContainer = document.getElementById("address");
button.addEventListener("click", () => {
addAddressLine(addressContainer, ++lineCount);
});
}
フォームの要素を取得できるよう、スクリプトはフォームの後に配置するか、defer を指定して読み込んでください。
<form>
<label>Name: <input id="name" type="text"></label>
<div id="address">
<label>Address: <input id="contact" type="text"></label>
</div>
<button id="add-address" type="button">Add Address Line</button>
</form>
クリックハンドラーは行番号を増やし、新しいテキスト入力欄を address 要素に追加します。元の名前欄と住所欄はそのまま残ります。type="button" 属性により、ボタンを押してもフォームは送信されません。コード例には、フォームの既存の名前欄と住所欄、および追加される住所入力欄が示されています。コードブロック内の表示ラベルは、変更されず英語のままです。
注記
append() も使えます。ノードと文字列テキストを受け取りますが、文字列は HTML として解析されず、テキストとして挿入されます。戻り値のノードを使う場合や、単一ノードを扱う既存の処理に合わせる場合は appendChild() を使います。ここではブラウザーの対応状況を扱いません。アプリケーションで対応ブラウザーの要件がある場合は、対象ブラウザーを確認してください。
insertAdjacentHTML() で指定位置に HTML を挿入する
target.insertAdjacentHTML(position, htmlString) を呼び出すと、文字列が解析され、target を基準にした位置へマークアップが挿入されます。
beforebeginは対象要素の直前に挿入します。対象要素には親が必要です。afterbeginは対象要素の内部で、最初の子の前に挿入します。beforeendは対象要素の内部で、最後の子の後に挿入します。マークアップを末尾に追加するときに使う位置です。afterendは対象要素の直後に挿入します。対象要素には親が必要です。
たとえば、住所コンテナーの末尾に新しい住所入力欄を挿入するには、次のようにします。
このセクションのコードと表示されるラベルや出力は英語のままです。
if (typeof document !== "undefined") {
const addressContainer = document.getElementById("address");
addressContainer.insertAdjacentHTML(
"beforeend",
'<input type="text" placeholder="Additional address line">'
);
}
appendChild() と異なり、このメソッドは第 2 引数を HTML として解析します。文字列が信頼できる場合、または安全にサニタイズされている場合に限って使い、信頼できないテキストをマークアップに連結しないでください。ユーザー入力を表示する場合は、要素を作成して textContent などの適切なプロパティを設定し、そのノードを追加します。