jQuery.map()

60
посл. ред. 23.12.2016

Функция jQuery.map() создаёт из переданного массива или объекта новый массив. Элементы нового массива определяются заданной функцией.

Функция jQuery.map() перебирает каждый элемент массива или каждое свойство объекта и запускает переданную вторым аргументом функцию. Эта функция может верунть одно из следующих значений:

  • одно значение, которое будет добавлено в результирующий массив;
  • массив значений, каждое из которых будет добавлено в результирующий массив;
  • null или undefined для перехода к следующему элементу (свойству), ничего не добавляя в конечный массив.

После завершения перебора элементов (свойств) jQuery.map() возвращает новый массив.

Варианты использования

jQuery.map(массив, функция) => Array
Запускает указанную функцию для каждого элемента массива (массивоподобного объекта) и возвращает новый массив. Переданная функция может принимать два аргумента: значение текущего элемента и его индекс.
jQuery.map(объект, функция) => Array
Запускает указанную функцию для каждого свойства объекта и возвращает новый массив. Переданная функция может принимать два аргумента: значение текущего свойства и его имя.

Примеры

<html>
<head>
  <title>Функции библиотеки jQuery</title>
  <script type="text/javascript" src="js/jquery.js"></script>
</head>
<body>
  <p></p>
  <p></p>
</body>
</html>
 
<script>
var array = ['to', 'string'];
$('p').first().text(array.toString());

var maped = $.map(array, function(elem) {
  return elem.split('');
});
$('p').last().text(maped.toString());
</script>

to,string

t,o,s,t,r,i,n,g