MediaList

NN 6 IE s.o DOM 2

L´objet MediaList est une représentation abstraite dans le DOM W3C d´une collection de noms de chaînes pour les supports spécifiés pour un objet styleSheet spécifique. La propriété media d´un objet styleSheet renvoie une valeur qui est un objet MediaList (IE 6 pour Windows renvoie incorrectement une valeur sous forme de chaîne). Les types de support (tels que print, screen, aural, etc.) sont spécifiés pour la feuille de style avec l´attribut media d´un élément link ou une règle @media dans un élément style. A partir des navigateurs de version 6, la prise en charge des supports au-delà des types print et screen (et le type par défaut, all) est assez limitée; les détails de cet objet ne sont donc pas encore très importants.

Propriétés spécifiques à l´objet

length

mediaText

Méthodes spécifiques à l´objet

appendMedium()

deleteMedium()

item()

Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

length	NN 6 IE s.o DOM 2
	Lecture seule
Renvoie le nombre d´éléments de la collection.

Exemple

var howMany = document.styleSheets[0].media.length;

Valeur
Nombre entier.

mediaText	NN 6 IE s.o DOM 2
	Lecture seule
Renvoie la totalité de la chaîne de noms de supports, séparés par des virgules.

Exemple

var allMedia = document.styleSheets[0].media.mediaText;

Valeur
Chaîne.

appendMedium(), deleteMedium()	NN 7 IE s.o DOM 2
appendMedium("mediumType") deleteMedium("mediumType")
Ajoute ou supprime un type de support de la liste. Dans Netscape 6.2, les méthodes sont incorrectement intitulées append() et delete().

Paramètres

Chaîne indiquant les types de support reconnus (par exemple screen ou print).

Valeur renvoyée
Aucune.

item()	NN 6 IE s.o DOM 2
item(index)
Renvoie une chaîne de nom de support de la collection pour l´élément qui correspond à la valeur d´index dans l´ordre du code source.

Paramètres

Un nombre entier à base zéro correspondant à l´élément spécifié dans l'ordre du code source.

Valeur renvoyée
Chaîne.