wrap-metodi
wrap-metodi käärii
elementit määritettyyn tagiin.
Syntaksi
Menetelmän parametrina voi olla teksti (mahdollisesti tageineen), DOM-elementti tai jQuery-olio:
.wrap(teksti tai tagi);
Näin valitut elementit kääritään sisältöön, joka palautetaan käyttäjän määrittämästä funktiosta. Funktiota kutsutaan erikseen jokaiselle valitulle elementille, ja se saa parametrinaan elementin sijainnin joukossa:
.wrap(function(numero joukossa));
Esimerkki
Kääritään kaikki luokan www kappaleet
div-tagilla:
<p class="www">teksti</p>
<p class="www">teksti</p>
<p class="www">teksti</p>
<p>teksti</p>
$('.www').wrap(document.createElement('div'));
HTML-koodi näyttää tältä:
<div><p class="www">teksti</p></div>
<div><p class="www">teksti</p></div>
<div><p class="www">teksti</p></div>
<p>teksti</p>
Esimerkki
Parametrina voi välittää paitsi tagin nimen, myös seuraavan rakenteen:
<p class="www">teksti</p>
<p class="www">teksti</p>
<p class="www">teksti</p>
<p>teksti</p>
$('.www').wrap('<div></div>');
HTML-koodi näyttää tältä:
<div><p class="www">teksti</p></div>
<div><p class="www">teksti</p></div>
<div><p class="www">teksti</p></div>
<p>teksti</p>
Esimerkki
Avautuvaan tagiin voi kirjoittaa mitä tahansa attribuutteja,
jolloin kääminen tapahtuu näiden attribuuttien
kanssa. Kääritään luokan www kappaleet
div-elementillä, jolla on luokka zzz:
<p class="www">teksti</p>
<p class="www">teksti</p>
<p class="www">teksti</p>
<p>teksti</p>
$('.www').wrap('<div class="zzz"></div>');
HTML-koodi näyttää tältä:
<div class="zzz"><p class="www">teksti</p></div>
<div class="zzz"><p class="www">teksti</p></div>
<div class="zzz"><p class="www">teksti</p></div>
<p>teksti</p>