Spec-Zone.ru › Web APIs

SVGNumberList

Базовая Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Интерфейс списка чисел SVG

SVGNumberList определяет список объектов SVGNumber.

Объект SVGNumberList может быть обозначен как только для чтения, что означает, что попытки изменить объект приведут к возбуждению исключения.

SVGNumberList является индексируемым и может быть обращен к нему как к массиву.

Обзор интерфейса

Также реализует Нет
Методы
  • void clear()
  • SVGNumber initialize(in SVGNumber newItem)
  • SVGNumber getItem(in unsigned long index)
  • SVGNumber insertItemBefore(in SVGNumber newItem, in unsigned long index)
  • SVGNumber replaceItem(in SVGNumber newItem, in unsigned long index)
  • SVGNumber removeItem(in unsigned long index)
  • SVGNumber appendItem(in SVGNumber newItem)
Свойства
  • только для чтения unsigned long numberOfItems
  • только для чтения unsigned long length Нестандартный
Нормативный документ SVG 1.1 (2-е издание)

Свойства экземпляра

Имя Тип Описание
numberOfItems unsigned long Количество элементов в списке.
length unsigned long Количество элементов в списке.

Методы экземпляра

Имя и аргументы Возврат Описание
clear() void

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

Исключения:

  • исключение DOMException с кодом NO_MODIFICATION_ALLOWED_ERR возникает, когда список соответствует атрибуту только для чтения или когда сам объект является только для чтения.
initialize(in SVGNumber newItem) SVGNumber

Очищает все существующие текущие элементы из списка и повторно инициализирует список для хранения единственного элемента, указанного newItem. Если вставляемый элемент уже находится в списке, он удаляется из предыдущего списка перед вставкой в этот список. Вставляемый элемент — это сам элемент, а не его копия. Возвращаемым значением является вставленный в список элемент.

Исключения:

  • исключение DOMException с кодом NO_MODIFICATION_ALLOWED_ERR возникает, когда список соответствует атрибуту только для чтения или когда сам объект является только для чтения.
getItem(in unsigned long index) SVGNumber

Возвращает указанный элемент из списка. Возвращаемым элементом является сам элемент, а не его копия. Любые изменения, внесенные в элемент, немедленно отражаются в списке. Первый элемент имеет номер 0.

Исключения:

  • исключение DOMException с кодом NO_MODIFICATION_ALLOWED_ERR возникает, когда список соответствует атрибуту только для чтения или когда сам объект является только для чтения.
insertItemBefore(in SVGNumber newItem, in unsigned long index) SVGNumber

Вставляет новый элемент в список в указанную позицию. Первый элемент имеет номер 0.

Если newItem уже находится в списке, он удаляется из предыдущего списка перед вставкой в этот список. Вставляемый элемент — это сам элемент, а не его копия. Если элемент уже находится в этом списке, обратите внимание, что индекс элемента для вставки перед удалением элемента.

Если index равно 0, новый элемент вставляется в начало списка. Если индекс больше или равен numberOfItems, новый элемент добавляется в конец списка.

Исключения:

  • исключение DOMException с кодом NO_MODIFICATION_ALLOWED_ERR возникает, когда список соответствует атрибуту только для чтения или когда сам объект является только для чтения.
replaceItem(in SVGNumber newItem, in unsigned long index) SVGNumber

Заменяет существующий элемент в списке новым элементом. Если newItem уже находится в списке, он удаляется из предыдущего списка перед вставкой в этот список. Вставляемый элемент — это сам элемент, а не его копия. Если элемент уже находится в этом списке, обратите внимание, что индекс элемента для замены — это индекс перед удалением элемента.

Исключения:

  • исключение DOMException с кодом NO_MODIFICATION_ALLOWED_ERR возникает, когда список соответствует атрибуту только для чтения или когда сам объект является только для чтения.
  • исключение DOMException с кодом INDEX_SIZE_ERR возникает, если index больше или равно numberOfItems.
removeItem(in unsigned long index) SVGNumber

Удаляет существующий элемент из списка.

Исключения:

  • исключение DOMException с кодом NO_MODIFICATION_ALLOWED_ERR возникает, когда список соответствует атрибуту только для чтения или когда сам объект является только для чтения.
  • исключение DOMException с кодом INDEX_SIZE_ERR возникает, если index больше или равно numberOfItems.
appendItem(in SVGNumber newItem) SVGNumber

Вставляет новый элемент в конец списка. Если newItem уже находится в списке, он удаляется из предыдущего списка перед вставкой в этот список. Вставляемый элемент — это сам элемент, а не его копия.

Исключения:

  • исключение DOMException с кодом NO_MODIFICATION_ALLOWED_ERR возникает, когда список соответствует атрибуту только для чтения или когда сам объект является только для чтения.

Спецификации

Спецификация
Scalable Vector Graphics (SVG) 2
# InterfaceSVGNumberList

Совместимость браузеров

Рабочий стол Мобильный
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
SVGNumberList 6 12 1.5 ≤12.1 5 18 4 ≤12.1 4 1.0 4.4
appendItem 6 12 3 ≤12.1 6 18 4 ≤12.1 6 1.0 4.4
clear 6 12 3 ≤12.1 6 18 4 ≤12.1 6 1.0 4.4
getItem 6 12 3 ≤12.1 6 18 4 ≤12.1 6 1.0 4.4
initialize 6 12 3 ≤12.1 6 18 4 ≤12.1 6 1.0 4.4
insertItemBefore 6 12 3 ≤12.1 6 18 4 ≤12.1 6 1.0 4.4
length 35 79 5 ≤12.1 13.1 35 5 ≤12.1 13.4 3.0 37
numberOfItems 6 12 3 ≤12.1 6 18 4 ≤12.1 6 1.0 4.4
removeItem 6 12 3 ≤12.1 6 18 4 ≤12.1 6 1.0 4.4
replaceItem 6 12 3 ≤12.1 6 18 4 ≤12.1 6 1.0 4.4

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/SVGNumberList

Spec-Zone.ru

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