Интерфейс MediaList

public interface MediaList

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

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

См. также Спецификацию объектной модели документа (DOM) уровня 2: стили.

С версии:: 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, 2025, 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/25/docs/api/jdk.xml.dom/org/w3c/dom/stylesheets/MediaList.html