map-metodi

map-metodi kutsuu annettua funktiota jokaiselle kokoelman elementille. Se on erityisen kätevä elementtikokoelman arvojen hakemiseen tai asettamiseen. map-metodi palauttaa uudelleen muodostetun eri elementtien ja objektien kokoelman toisin kuin each-metodi, joka palauttaa alkuperäisen elementtikokoelman.

Syntaksi

Itse elementit ovat saatavilla funktiossa, muuttujassa this, ja niiden järjestysnumerot kokoelmassa — muuttujassa index:

javascript$(selektori).map(function(index, element));

Esimerkki

Tuodaan näytölle luettelo id-elementtien nimistä, eroteltuna pilkuilla. Käytetään myös get- ja join-metodeja:

html<p id="aaa">teksti1</p>
<p id="bbb">teksti2</p>
<p id="ccc">teksti3</p>
javascriptconsole.log(
  $('p').map(
    function() {
      return this.id; 
    }
  ).get().join()
);

Katso myös

  • filter-metodi,
    joka suodattaa elementit tietyn valitsimen mukaan
  • each-metodi,
    joka kutsuu annettua funktiota jokaiselle kokoelman elementille