Detaillierte Erläuterung der Verwendung der jQuery.wrapAll()-Funktion

Die Funktion wrapAll() wird verwendet, um alle übereinstimmenden Elemente mit einem einzigen Element zu umschließen.

Diese Funktion gehört zum jQuery-Objekt (Instanz).

Syntax

Diese Funktion wurde in jQuery 1.2 hinzugefügt.

jQueryObject.wrapAll( Wrapper)

Parameter

Parameterbeschreibung

Wrapper String/Element/jQuery/Function-Typ wird verwendet Der Knoten, der das übereinstimmende Element umschließt.

Wenn der Parameter-Wrapper ein String ist, wird er als jQuery-Selektor oder HTML-String betrachtet und jQuery trifft sein eigenes Urteil.

Wenn wrapper kein Funktionstyp ist, verschiebt wrapAll() alle passenden Elemente an die Position des ersten passenden Elements und umschließt sie dann alle mit dem angegebenen einzelnen Element.

jQuery 1.4 neue Unterstützung: Parameter-Wrapper kann eine Funktion sein. wrapAll() durchläuft diese Funktion und führt sie basierend auf allen übereinstimmenden Elementen aus, und diese in der Funktion zeigt auf das entsprechende DOM-Element.

wrapAll() übergibt außerdem einen Parameter an die Funktion, nämlich den Index des aktuellen Elements im passenden Element. Der Rückgabewert der -Funktion ist der zum Umschließen verwendete Knoteninhalt (kann ein HTML-String, ein DOM-Element oder ein jQuery-Objekt sein).

Hinweis: Wenn der Wrapper mit mehreren Elementen übereinstimmt, wird nur das erste Element als Wrapper-Element verwendet.

Hinweis: Wenn der Wrapper ein mehrstufiges verschachteltes Element ist (z. B. „e388a4556c0f65e1904146cc1a846bee5a8028ccc7a7e27417bff9f05adf593272ac96585ae54b6ae11f849d2649d9e694b3e26ee717c64999d7867364b1b4a3“), führt wrapAll() eine Prüfung von außen durch nach innen Der erste Knoten jeder Verschachtelungsebene. Wenn der Knoten keine untergeordneten Knoten hat oder der erste untergeordnete Knoten kein Elementknoten ist (z. B. ein Textknoten, ein Kommentarknoten usw.), beenden Sie die Suche nach innen und hängen Sie das aktuell passende Element direkt an der Endposition im Inneren an (append()). der aktuelle Knoten.

Rückgabewert

Der Rückgabewert der Funktion wrapAll() ist vom Typ jQuery und gibt das aktuelle jQuery-Objekt selbst zurück (um die Programmierung im Kettenstil zu erleichtern).

Hinweis: Auch wenn das Wrapper-Element ein Element auf der aktuellen Seite ist, verschwindet das Element nicht von seiner ursprünglichen Position. Weil wrapAll() eine Kopie (Klon) des Elements verwendet, um als Umhüllungselement zu fungieren.

Beispiel und Beschreibung

Die Funktion wrapAll() wird verwendet, um alle übereinstimmenden Elemente mit einem einzigen Element zu umschließen:

<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>

Nehmen Sie den folgenden HTML-Code als Beispiel:

<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>

Der folgende jQuery-Beispielcode wird verwendet, um die spezifische Verwendung der Funktion „wrapAll()“ zu demonstrieren:

// 在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;);

Führen Sie den Code aus (bitte kopieren Sie andere Codes auf die Demoseite). run)

wrapAll() platziert das Start-Tag und das End-Tag des umschlossenen Elements auf beiden Seiten aller übereinstimmenden Elemente, ohne zusätzliche Leerzeichen hinzuzufügen. Der vollständige HTML-Code nach der Ausführung des obigen Codes lautet wie folgt folgt (das Format wurde in keiner Weise angepasst):

<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>

Das Folgende ist der jQuery-Beispielcode, bei dem der Parameter-Wrapper eine Funktion ist:

<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]

Das obige ist der detaillierte Inhalt vonDetaillierte Erläuterung der Verwendung der jQuery.wrapAll()-Funktion. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!