Méthode wrapAll

La méthode wrapAll encapsule tous les éléments d'un ensemble dans une balise donnée. Si ces éléments se trouvent à des endroits différents, jQuery les place d'abord côte à côte, puis les encapsule dans la balise souhaitée.

Syntaxe

Le paramètre de la méthode peut être du texte (éventuellement avec des balises), un élément DOM ou un objet jQuery :

javascript.wrapAll(quelque chose pour envelopper);

Nous pouvons également utiliser une fonction pour chaque élément :

javascript.wrapAll(function(numéro dans l'ensemble))

Exemple

Encapsulons les paragraphes avec la classe www dans la balise div :

html<p class="www">text</p>
<p class="www">text</p>
<p class="www">text</p>
<p>text</p>
javascript$('.www').wrapAll('<div></div>');

Le code HTML deviendra alors :

html<div>
  <p class="www">text</p>
  <p class="www">text</p>
  <p class="www">text</p>
</div>
<p>text</p>

Voir aussi

  • les méthodes wrap, wrapInner, unwrap,
    permettant de travailler avec l'encapsulation des éléments