HOWTO · jQuery
jQuery で要素を作成する
このチュートリアルでは、jQuery で HTML 要素を作成する方法を示します。
このページの内容
要素を作成するには、JavaScript の document.createElement() DOM API を使うか、HTML を jQuery に渡します。その後、jQuery の挿入メソッドでコンテンツを配置します。作成と挿入は別の操作です。選択した要素の内側に配置するには append() または prepend() を、要素の隣に配置するには before() または after() を選びます。
jQuery で要素を作成して挿入する
挿入位置に応じて使用するメソッドを選びます。append() は選択した各要素の最後の子要素としてコンテンツを追加し、prepend() は最初の子要素として追加します。before() と after() は、選択した要素の直前または直後に兄弟要素を追加します。これらのメソッドでは、1つまたは複数の項目を挿入できます。兄弟要素を挿入するメソッドを使っても、選択した要素自体の位置は変わりません。
HTML 文字列、jQuery、または DOM でコンテンツを作成する
jQuery には複数の形式のコンテンツを渡せます。たとえば $("<p>New paragraph</p>") のような HTML 文字列から、マークアップを含む jQuery オブジェクトを作成できます。変数やユーザー入力の値をテキストとして扱う場合は、要素を作成して .text() でテキストを設定します。これにより、値は HTML として解析されず、テキストとして扱われます。また、document.createElement() でネイティブ DOM 要素を作成し、その要素を jQuery の挿入メソッドに渡すこともできます。
次の JavaScript のリストモデルは、新しい項目を末尾に追加したときの順序を示しています。ページ上で対応する jQuery の操作は $("#items").append("<li>Third</li>") です。
次の例を実行します。
このセクションのコードと表示されるラベルや出力は英語のままです。
const items = ["First", "Second"];
const newItem = "Third";
items.push(newItem);
console.log(items.join("\n"));
First
Second
Third
値からテキストを作るときは、jQuery の .text() を使います。たとえば $("<p>").text(message) は、内容がテキストの段落を作成します。DOM で同じことをするコードは const paragraph = document.createElement("p"); paragraph.textContent = message; です。どちらの結果も append()、prepend()、before()、または after() に渡せます。
append() で要素の末尾にコンテンツを追加する
コンテナーの内側の末尾に項目を1つ追加するには、コンテナーを選択して append() を呼び出します。たとえば $("#items").append("<li>Third</li>") のように記述します。複数の項目を追加するには、$("#items").append("<li>Third</li>", $("<li>").text("Fourth")) のように複数のコンテンツ引数を渡します。既存の子要素の後に、新しい項目が引数の順に追加されます。
prepend() で先頭にコンテンツを追加する
prepend() を呼び出すと、選択した要素の既存の子要素より前に新しいコンテンツを配置できます。例: $("#items").prepend("<li>First</li>")。複数のコンテンツ引数も渡せます。たとえば $("#items").prepend("<li>First</li>", $("<li>").text("Second")) のように記述します。引数は、指定した順序のまま先頭に挿入されます。現在のリストの前に表示したいお知らせや項目を追加する場合に便利ですが、コンテナー自体の前にコンテンツを挿入するメソッドではありません。
選択した要素の前または後に要素を挿入する
コンテンツを選択した要素の内側ではなく隣に配置する場合は、before() と after() を使います。たとえば $("h1").before("<p>Introduction</p>") は見出しの直前に段落を挿入し、$("h1").after("<p>Details</p>") は直後に挿入します。どちらのメソッドも複数のコンテンツ引数を受け取ります。たとえば $("h1").after("<p>Details</p>", $("<p>").text("More information")) とすると、見出しの後に2つの段落がその順序で配置されます。セレクターが複数の要素に一致する場合、jQuery は一致した各要素にコンテンツを挿入します。既存の DOM ノードを渡すと、最後の移動先を除くすべての移動先にはその複製を挿入し、最後の移動先には元の DOM ノードを移動します。