andSelf() 関数は、以前に一致した要素を現在一致している要素に追加し、それを新しい jQuery オブジェクトの形式で返すために使用されます。
現在の jQuery オブジェクトは、他の jQuery オブジェクトの特定のメソッドを呼び出すことで作成できます。この関数を使用すると、現在の jQuery オブジェクトと以前に作成した jQuery オブジェクトの一致する要素をすべて含む新しい jQuery オブジェクトが返されます。
この関数はjQueryオブジェクト(インスタンス)に属します。
構文
この関数は jQuery 1.2 で追加されましたが、1.8 以降は廃止されるとマークされています。 jQuery 1.8 以降では、代わりに addBack() 関数を使用してください。
jQueryObject.andSelf( )
戻り値
andSelf()関数の戻り値はjQuery型で、現在のjQueryオブジェクトとそれを作成したjQueryオブジェクトを含む新しいjQueryオブジェクトを返します。すべての要素。
一致する要素がない場合は、空の jQuery オブジェクトが返されます。
jQuery 1.8 以降、andSelf() 関数は addBack() 関数のエイリアスです。
詳細: jQuery オブジェクトが作成されると、それを作成した jQuery オブジェクトの reference を保存する内部 property(prevObject) が存在します。 andSelf() 関数が呼び出されると、現在の jQuery とそれを作成した jQuery オブジェクトが add() 関数を通じて接続され、新しい jQuery オブジェクトが返されます。
例と説明
次の 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 サンプル コードは、andSelf() 関数の具体的な使用法を示すために使用されます:
//返回jQuery对象所有匹配元素的标识信息数组 //每个元素形如:#id function getTagsInfo($doms){ return $doms.map(function(){ return "#" + this.id; }).get(); } //匹配所有的p元素 var $p = $("p"); // 选取所有p元素的后代label元素 var $label = $p.find("label"); // 由于jQuery对象$label是通过$p的特定方法创建,使用andSelf()将返回一个新的jQuery对象 // 该对象所匹配的元素是$p和$label两者的匹配元素之和 var $pAndLabel = $label.andSelf(); document.writeln( getTagsInfo( $pAndLabel ) ); // #n1,#n4,#n9,#n11 // 所有包含类名"active"的span元素和它们的上一个紧邻的同辈元素 var $elements = $("span.active").prev().andSelf(); document.writeln( getTagsInfo( $elements ) ); // #n7,#n8,#n11,#n12 // andSelf()之前有3个jQuery对象: // 第1个:$("p") // 第2个:$("p").find("strong") // 第3个:$("p").find("strong").siblings(".active") // 调用andSelf()的是第3个对象,创建该对象的是第2个对象 // 因此andSelf()返回包含第3个对象和第2个对象的匹配元素之和的jQuery对象 var $matches = $("p").find("strong").siblings(".active").andSelf(); document.writeln( getTagsInfo( $matches ) ); // #n7,#n8
以上がjQuery.andSelf() 関数の使用状況の分析の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。