Spec-Zone.ru › jQuery

jQuery.uniqueSort()

jQuery.uniqueSort( array )Возвращает: Массив

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

  • версия добавлена: 1.12-and-2.2jQuery.uniqueSort( array )

    • array
      Тип: ArrayLikeObject
      Массив или похожий на массив объект DOM-элементов.

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

До jQuery 3.0 этот метод назывался jQuery.unique().

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

Пример:

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

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.uniqueSort 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>
// uniqueSort() 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-uniqueSort there are " + divs.length + " elements." );
 
divs = jQuery.uniqueSort( divs );
$( "div" ).eq( 2 ).text( "Post-uniqueSort 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.uniqueSort

Spec-Zone.ru

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