Интерфейс MediaList

public interface MediaList

Интерфейс MediaList предоставляет абстракцию упорядоченного набора медиа, не определяя и не ограничивая способ реализации этого набора. Пустой список эквивалентен списку, содержащему медиа "all".

Элементы в наборе MediaList доступны по целочисленному индексу, начиная с 0.

См. также Спецификацию Document Object Model (DOM) Level 2 Style.

С:: 1.4, DOM Level 2

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`appendMedium(String newMedium)`	Добавляет медиа `newMedium` в конец списка.
`void`	`deleteMedium(String oldMedium)`	Удаляет медиа, указанное по `oldMedium` из списка.
`int`	`getLength()`	Количество медиа в списке.
`String`	`getMediaText()`	Представление списка медиа в виде строки, пригодной для парсинга.
`String`	`item(int index)`	Возвращает `index`-й элемент в списке.
`void`	`setMediaText(String mediaText)`	Представление списка медиа в виде строки, пригодной для парсинга.

Подробное описание методов

getMediaText

String getMediaText()

Представление списка медиа в виде строки, пригодной для парсинга. Это список медиа, разделённый запятыми.

setMediaText

void setMediaText(String mediaText) throws DOMException

Представление списка медиа в виде строки, пригодной для парсинга. Это список медиа, разделённый запятыми.

Исключения:: DOMException - SYNTAX_ERR: Возникает, если в указанной строке есть синтаксическая ошибка, и она не может быть обработана.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если список медиа является только для чтения.

getLength

int getLength()

Количество медиа в списке. Диапазон допустимых значений медиа от 0 до length-1 включительно.

item

String item(int index)

Возвращает index-й элемент в списке. Если index больше или равно количеству медиа в списке, возвращается null.

Параметры:: index - Индекс в коллекции.
Возвращает:: Медиа на index позиции в MediaList, или null, если это не допустимый индекс.

deleteMedium

void deleteMedium(String oldMedium) throws DOMException

Удаляет медиа, указанное по oldMedium из списка.

Параметры:: oldMedium - Медиа для удаления из списка медиа.
Исключения:: DOMException - NO_MODIFICATION_ALLOWED_ERR: Возникает, если список является только для чтения.
NOT_FOUND_ERR: Возникает, если oldMedium не находится в списке.

appendMedium

void appendMedium(String newMedium) throws DOMException

Добавляет медиа newMedium в конец списка. Если newMedium уже используется, оно сначала удаляется.

Параметры:: newMedium - Новое медиа для добавления.
Исключения:: DOMException - INVALID_CHARACTER_ERR: Если медиа содержит символы, недопустимые в базовом языке стилей.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если список является только для чтения.

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/jdk.xml.dom/org/w3c/dom/stylesheets/MediaList.html