jQuery(html, [ownerDocument])


version 1.0 以降

解説

HTML文字列から、jQueryオブジェクトを生成します。
動的にDOM要素を作成することができます。

引数

  • html
    String: HTML文字列
  • [ownerDocument]オプション
    Element: 要素の生成先

戻り値

  • jQuery: jQueryオブジェクト

関連


例1:<p>Hello jQuery!</p> というDOM要素のjQueryオブジェクトを生成し、表示します。

$("<p>Hello jQuery!</p>").appendTo("#test_result");

例2:<em>[1~3]行目</em> というDOM要素のjQueryオブジェクトを生成し、表示します。

for(var i = 1; i <= 3; i++) {
    $("<em>" + i + "行目</em>")
        .append("<br/>")
        .appendTo("#test_result");
}

例3:例2)は次のように書くこともできます。

for(var i = 1; i <= 3; i++) {
    $("<em/>").text(i + "行目")
        .append("<br/>")
        .appendTo("#test_result");
}


終了タグに注意

version 1.3 以前では、HTMLタグは必ず閉じられていなければなりません。特に空要素には注意してください。

有効な書式の例
$("<img/>")
$("<span/>")
$("<span></span>")

無効な書式の例
$("<img>")
$("<span>")

※version 1.4 以降では、上記の書式は全て有効です。