jQuery.add() 関数の正しい使用法

add() 関数は、指定された expression に一致する要素を現在一致する要素に追加するために使用され、それを jQuery オブジェクトの形式で返します

ここでの式には、セレクター (文字列)、HTML コンテンツが含まれます(文字列)、DOM要素(Element)、jQueryオブジェクト。

この関数の反対は not() 関数で、現在一致している要素から指定された式に一致する要素を削除するために使用されます。

この関数はjQueryオブジェクト(インスタンス)に属します。

構文

jQueryObject.add( expr [, context ] )

パラメータ

パラメータの説明

expr String/Element/jQuery型で指定する式。

context オプション/Element/jQuery タイプは、検索範囲を表すドキュメント ノードを指定します。このパラメーターは、expr パラメーターがセレクター文字列を表す場合にのみ使用できます。

expr パラメータが文字列の場合、jQuery セレクターまたは HTML タグ の内容を表し、jQuery が自動的に対応する判断を行います。

jQuery 1.3.2 新しいサポート: パラメーター expr は jQuery オブジェクトにすることができます。

jQuery 1.4 の新規サポート: context パラメーターが追加されました。 expr パラメータがセレクタを表す場合、context パラメータはセレクタの検索範囲を指定するために使用されます。

戻り値

add()関数の戻り値はjQuery型で、現在のjQueryオブジェクトと指定された式の一致する要素の合計をカプセル化した新しいjQueryオブジェクトを返します。

一致する要素がない場合は、空の jQuery オブジェクトが返されます。

add() 関数は、現在の jQuery オブジェクトの要素の一致を変更しません。加算結果は戻り値として新しい jQuery オブジェクトに反映されるだけです。

例と説明

add() 関数と共用体セレクターには次の同等のコードがあります:

// 这里的s1、s2均表示任意的选择器
$("s1").add("s2");
// 等价于
$("s1,s2");

次の HTML コードを例として取り上げます:

<p id="n1">
    <span id="n2">
        <span id="n3">A</span>
    </span>
    <label id="n4">B</label>
    <span id="n5">
        <span id="n6">C</span>
    </span>
    <strong id="n7" class="active">D</strong>
    <span id="n8" class="active">E</span>
</p>
<p id="n9">
    <span id="n10"></span>
    <label id="n11"></label>
    <span id="n12" class="active"></span>
</p>

次の jQuery サンプル コードは、add の具体的な使用法を示すために使用されます。 () 関数:

//返回jQuery对象所有匹配元素的标识信息数组
//每个元素形如：#id
function getTagsInfo($doms){
    return $doms.map(function(){
        return "#" + this.id;
    }).get();
}
//匹配所有的p元素，再加上所有的label元素
var $elements1 = $("p").add("label");
document.writeln( getTagsInfo( $elements1 ) ); // #n1,#n4,#n9,#n11
var $matches = $("span.active").add( document.getElementsByTagName("label")  );
document.writeln( getTagsInfo( $matches ) ); // #n4,#n8,#n11,#n12
var $elements2 = $("label").add( $("strong") );
document.writeln( getTagsInfo( $elements2 ) ); // #n4,#n7,#n11
var $elements3 = $("span.active").add( "label", $("#n9") );
document.writeln( getTagsInfo( $elements3 ) ); // #n8,#n11,#n12
var $elements4 = $("p").add(".active").add("span:only-child");
document.writeln( getTagsInfo( $elements4 ) ); // #n1,#n3,#n6,#n7,#n8,#n9,#n12

以上がjQuery.add() 関数の正しい使用法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。