jQuery.wrap()関数の詳しい説明

wrap() 関数は、一致する各要素の外側で指定された HTML 構造をラップするために使用されます。

この関数の反対は unwrap() 関数で、現在一致している要素の親要素に使用されます (親要素のみが削除され、その内部ノードはすべて保持されます)。

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

構文

jQueryObject.wrap(wrapper)

パラメータ

パラメータの説明

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

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

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

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

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

注: ラッパーが複数レベルのネストされた要素 (e388a4556c0f65e1904146cc1a846bee5a8028ccc7a7e27417bff9f05adf593272ac96585ae54b6ae11f849d2649d9e694b3e26ee717c64999d7867364b1b4a3 など) の場合、wrap() はネストの各レベルの最初の要素をチェックします。ノードの外側から内側へ。ノードに子ノードがない場合、または最初の子ノードが要素ノード (テキスト ノード、コメント ノードなど) ではない場合は、内側への検索を停止し、現在一致する要素を内側の終了位置に直接追加 (append()) します。現在のノード。

戻り値

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

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

例と説明

wrap() 関数は、一致する各要素の前にコンテンツを挿入するために使用されます:

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

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

<p id="n1">
    <span id="n2">span#n2</span>    
</p>
<p id="n3">
    <input id="n4" type="text" />
</p>
<span id="n5">多层嵌套1</span>
<span id="n6">多层嵌套2</span>

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

// 在n2元素外包裹strong元素：<strong>{#n2}</strong>
$("#n2").wrap(&#39;<strong/>&#39;);// 在n4元素外包裹form元素：<form name="myForm">{#n4}</form>
$("#n4").wrap(&#39;<form name="myForm"></form>&#39;);
// 在每个p元素外包裹div元素：<div data_id="index">{p}</div>
$("p").wrap( function(index){
    return &#39;<div data_id="&#39; + index + &#39;"></div>&#39;;   
} );
// 在n5元素外包裹嵌套的div元素：<div><p><em><b>{#n5}</b></em></p></div>
$("#n5").wrap( &#39;<div><p><em><b></b></em></p></div>&#39; );
// 在n6元素外包裹嵌套的div元素：<div><p> <em><b></b></em>${#n5}</p></div>
// wrap()会从外层div依次往内部查找，以确定n5元素的所在位置
// wrap()将从外往内检查每层嵌套的第一个元素，如果该元素没有子元素或者第一个子元素不是Element节点，就停止向内查找
// 由于参数的&#39;<p>&#39;后面有空格(文本节点)，也就是说p元素的第一个子元素不是Element类型，因此直接将n6插入到p元素内部的末尾位置
$("#n6").wrap( &#39;<div><p> <em><b></b></em></p></div>&#39; );
wrap()会将包裹元素的开始标记和结束标记分别置于匹配元素的两侧，不会额外添加任何空白字符，上述代码执行后的完整html代码如下(格式未作任何调整)：
<div data_id="0"><p id="n1">
    <strong><span id="n2">span#n2</span></strong>    
</p></div>
<div data_id="1"><p id="n3">
    <form name="myForm"><input id="n4" type="text"></form>
</p></div>
<div><p><em><b><span id="n5">多层嵌套1</span></b></em></p></div>
<div><p> <em><b></b></em><span id="n6">多层嵌套2</span></p></div>

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