jQuery.wrapAll()関数の使い方の詳しい説明

wrapAll() 関数は、一致するすべての要素を 1 つの要素でラップするために使用されます。

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

構文

この関数は jQuery 1.2 の新しい関数です。

jQueryObject.wrapAll(wrapper)

パラメータ

パラメータ 説明

wrapper String/Element/jQuery/Function 型のノードで、一致する要素をラップするために使用されます。

パラメータラッパーがstringの場合、jQueryセレクターまたはhtml文字列とみなされ、jQueryが自ら判断します。

wrapper が関数型ではない場合、wrapAll() は一致するすべての要素を最初に一致する要素の位置に移動し、指定された単一の要素ですべてをラップします。

jQuery 1.4 の新しいサポート: パラメーター ラッパーを関数にすることができます。 WrapAll() は、一致するすべての要素に基づいてこの関数を走査して実行します。関数内の this は、対応する DOM 要素を指します。

wrapAll() は、一致する要素内の現在の要素の index であるパラメーターも関数に渡します。 関数の戻り値は、ラッピングに使用されるノードのコンテンツです(HTML文字列、DOM要素、またはjQueryオブジェクトの可能性があります)。

注: ラッパーが複数の要素に一致する場合、最初の要素のみがラッピング要素として使用されます。

注: ラッパーが複数レベルのネストされた要素 (「

」など) の場合、wrapAll() は、外側から内側へ。最初のノード。ノードに子ノードがない場合、または最初の子ノードが要素ノード (テキスト ノード、コメント ノードなど) ではない場合は、内側への検索を停止し、現在一致する要素を内側の終了位置に直接追加 (append()) します。現在のノード。

戻り値

wrapAll() 関数の戻り値は jQuery 型で、現在の jQuery オブジェクト自体を返します (チェーン スタイルのプログラミングを容易にするため)。

注: ラッパー要素が現在のページ内の要素であっても、要素は元の位置から消えることはありません。なぜなら、wrapAll() は要素のコピー (クローン) を使用してラッピング要素として機能するからです。

例と説明

wrapAll() 関数は、一致するすべての要素を 1 つの要素でラップするために使用されます:

<p>段落文本1<span></span></p>
<p>段落文本2<span></span></p>
<script type="text/javascript">
$("p").wrapAll( &#39;<div></div>&#39; ); 
</script>
<!--以下是jQuery代码执行后的html内容-->
<div><p>段落文本1<span></span></p><p>段落文本2<span></span></p></div>

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

<p id="n1">
    <span id="n2">[span#n2]</span>    
</p>
<p id="n3">
    <label id="n4">[label#n4]</label>
</p>
<span id="n5">[span#n5]</span>
<span id="n6">[span#n6]</span>

次の jQuery サンプル コードは、wrapAll( ) 関数 具体的な使用法:

// 在n4元素外包裹del元素：<del>{#n4}</del>
$("#n4").wrapAll(&#39;<del/>&#39;);
// 在所有span元素外包裹单个em元素：<em class="all-span">{#n2}{#n5}{#n6}</em>
// 所有span元素会先移动到第一个span元素的位置，然后全部被em元素包裹起来
$("span").wrapAll(&#39;<em class="all-span"></em>&#39;);

コードを実行します (他のコードをデモ ページにコピーして実行してください)

wrapAll() は、ラップされた要素の開始タグと終了タグを、追加することなく、一致するすべての要素の両側に配置します。余分な空白文字。上記のコードを実行した後の完全な HTML コードは次のとおりです (形式は調整されていません):

<p id="n1">
    <em class="all-span"><span id="n2">[span#n2]</span><span id="n5">[span#n5]</span><span id="n6">[span#n6]</span></em>    
</p>
<p id="n3">
    <del><label id="n4">[label#n4]</label></del>
</p>

以下は、パラメーター ラッパーが関数である jQuery のサンプル コードです:

<p id="n1">
    <span id="n2">[span#n2]</span>    
</p>
<p id="n3">
    <label id="n4">[label#n4]</label>
</p>
<span id="n5">[span#n5]</span>
<span id="n6">[span#n6]</span>




    [span#n2]    


    [label#n4]

[span#n5]
[span#n6]
以下是wrapper参数为多层嵌套元素的jQuery示例代码：
[span#n1]
[label#n2]
[span#n3]



[span#n1][span#n3]
[label#n2]

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