Spec-Zone.ru › jQuery

jQuery.unique()

jQuery.unique( array )Возвращает: Массивверсия устаревшая: 3.0

Описание: Сортирует массив элементов DOM, на месте, удаляя дубликаты. Обратите внимание, что это работает только с массивами элементов DOM, а не со строками или числами.

  • версия добавлена: 1.1.3jQuery.unique( array )

    • array
      Тип: Массив
      Массив элементов DOM.

Начиная с jQuery 3.0, этот метод устарел и является просто алиасом jQuery.uniqueSort(). Используйте вместо него этот метод.

Функция $.unique() ищет в массиве объектов, сортирует массив и удаляет дублирующие узлы. Узел считается дублирующим, если он является абсолютно таким же узлом, как и один уже в массиве; два разных узла с одинаковыми атрибутами не считаются дубликатами. Эта функция работает только с обычными JavaScript-массивами элементов DOM и главным образом используется внутри jQuery. Вам, вероятно, никогда не понадобится ее использовать.

Начиная с jQuery 1.4 результаты всегда возвращаются в порядке документа.

Пример:

Удаляет любые дублирующие элементы из массива div.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.unique demo</title>
  <style>
  div {
    color: blue;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<div>There are 6 divs in this document.</div>
<div></div>
<div class="dup"></div>
<div class="dup"></div>
<div class="dup"></div>
<div></div>
 
<script>
// unique() must take a native array
var divs = $( "div" ).get();
 
// Add 3 elements of class dup too (they are divs)
divs = divs.concat( $( ".dup" ).get() );
$( "div" ).eq( 1 ).text( "Pre-unique there are " + divs.length + " elements." );
 
divs = jQuery.unique( divs );
$( "div" ).eq( 2 ).text( "Post-unique there are " + divs.length + " elements." )
  .css( "color", "red" );
</script>
 
</body>
</html>

Демо:

© The jQuery Foundation and other contributors
Licensed under the MIT License.
https://api.jquery.com/jQuery.unique

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API