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]

以下は、ラッパー パラメーターが多層ネストされた要素である jQuery サンプル コードです:

<span id="n1">[span#n1]</span>
<label id="n2">[label#n2]</label>
<span id="n3">[span#n3]</span>
<!--以上是执行jQuery代码前的html内容-->
<script type="text/javascript">
// 在所有span元素外包裹嵌套的div元素：<div><p><em>{#n1}{#n3}</em></p></div>
// 所有span元素都会移动到第一个span元素的位置
$("span").wrapAll( &#39;<div><p><em></em></p></div>&#39; );
/*
如果参数为&#39;<div><p> <em></em></p></div>&#39;，由于&#39;<p>&#39;的第一个子节点是空格(文本节点)，因此停止向内层查找，直接在p元素内部的末尾位置插入所有的span元素：<div><p> <em></em>{#n1}{#n3}</p></div>
 */
</script>
<!--以上是执行jQuery代码后的html内容-->
<div><p><em><span id="n1">[span#n1]</span><span id="n3">[span#n3]</span></em></p></div>
<label id="n2">[label#n2]</label>

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