Spec-Zone.ru › Web APIs

SVGStringList

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

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

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

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

SVGStringList определяет список строк.

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

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

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

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

Имя Тип Описание
numberOfItems unsigned long Количество элементов в списке.
length unsigned long Зеркальное отражение значения в numberOfItems, для согласованности с другими интерфейсами. Нестандартный

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

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

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

Исключения:

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

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

Исключения:

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

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

Исключения:

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

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

Исключения:

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

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

Исключения:

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

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

Исключения:

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

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

Исключения:

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

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

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

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

Рабочий стол Мобильный
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
SVGStringList 1 12
12С версии 13, SVGStringList индексируется как массив, что является нестандартным поведением.
≤12.1 3 18
14SVGStringList индексируется как массив, что является нестандартным поведением.
≤12.1 1 1.0 3
appendItem 1 12 12 ≤12.1 3 18 14 ≤12.1 1 1.0 3
clear 1 12 12 ≤12.1 3 18 14 ≤12.1 1 1.0 3
getItem 1 12 12 ≤12.1 3 18 14 ≤12.1 1 1.0 3
initialize 1 12 12 ≤12.1 3 18 14 ≤12.1 1 1.0 3
insertItemBefore 1 12 12 ≤12.1 3 18 14 ≤12.1 1 1.0 3
length 35 79 12 ≤12.1 13.1 35 14 ≤12.1 13.4 3.0 37
numberOfItems 1 12 12 ≤12.1 3 18 14 ≤12.1 1 1.0 3
removeItem 1 12 12 ≤12.1 3 18 14 ≤12.1 1 1.0 3
replaceItem 1 12 12 ≤12.1 3 18 14 ≤12.1 1 1.0 3

© 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/SVGStringList

Spec-Zone.ru

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