Интерфейс MediaList

public interface MediaList

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

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

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

Since:: 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

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

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

getLength

int getLength()

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

item

String item(int index)

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

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

deleteMedium

void deleteMedium(String oldMedium) throws DOMException

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

Parameters:: oldMedium - Медиа для удаления из списка медиа.
Throws:: DOMException - NO_MODIFICATION_ALLOWED_ERR: Вызывается, если этот список является только для чтения.
NOT_FOUND_ERR: Вызывается, если oldMedium не содержится в списке.

appendMedium

void appendMedium(String newMedium) throws DOMException

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

Parameters:: newMedium - Новое медиа для добавления.
Throws:: 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://download.java.net/java/early_access/jdk24/docs/api/jdk.xml.dom/org/w3c/dom/stylesheets/MediaList.html