MediaList

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das MediaList-Interface repräsentiert die Media-Queries eines Stylesheets, z.B. jene, die unter Verwendung des media-Attributs eines <link>-Elements gesetzt sind.

Hinweis:>MediaList ist eine Live-Liste; das Aktualisieren der Liste mit den unten aufgeführten Eigenschaften oder Methoden wird das Verhalten des Dokuments sofort aktualisieren.

Instanzeigenschaften

MediaList.mediaText

Ein stringifier, der einen String zurückgibt, der die MediaList als Text darstellt, und es Ihnen auch ermöglicht, eine neue MediaList zu setzen.

MediaList.length Schreibgeschützt

Gibt die Anzahl der Media-Queries in der MediaList zurück.

Instanzmethoden

MediaList.appendMedium()

Fügt der MediaList eine Media-Query hinzu.

MediaList.deleteMedium()

Entfernt eine Media-Query aus der MediaList.

MediaList.item()

Ein Getter, der einen String zurückgibt, der eine Media-Query als Text darstellt, basierend auf dem Indexwert der Media-Query innerhalb der MediaList. Diese Methode kann auch mit der Klammer-Syntax ([]) aufgerufen werden.

MediaList.toString()

Gibt eine Zeichenfolgenrepräsentation dieser Media-Liste im gleichen Format wie die MediaList.mediaText-Eigenschaft des Objekts zurück.

Beispiele

Das folgende Beispiel gibt eine textuelle Darstellung der MediaList des ersten auf das aktuelle Dokument angewendeten Stylesheets in der Konsole aus.

js
const stylesheets = document.styleSheets;
let stylesheet = stylesheets[0];
console.log(stylesheet.media.mediaText);

Spezifikationen

Specification
CSS Object Model (CSSOM)
# the-medialist-interface

Browser-Kompatibilität