Método map

O método map chama uma função determinada para cada elemento do conjunto. É especialmente útil para obter ou definir valores de uma coleção de elementos. O método map retorna um conjunto reformado de elementos e objetos diferentes, ao contrário do método each, que retorna o conjunto original de elementos.

Sintaxe

Os próprios elementos estão disponíveis na função, na variável this, e seus números ordinais no conjunto — na variável index:

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

Exemplo

Vamos exibir uma lista de nomes id dos elementos, separados por vírgulas. Vamos usar também os métodos get e join:

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

Veja também

  • método filter,
    que filtra elementos por um seletor específico
  • método each,
    que chama uma função determinada para cada elemento do conjunto