MediaList

Baseline Widely available

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

Das MediaList Interface repräsentiert die Medienabfragen eines Stylesheets, z.B. diejenigen, die mit dem media-Attribut eines <link>-Elements festgelegt werden.

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

Instanzeigenschaften

MediaList.mediaText

Ein Stringifier, der eine Zeichenkette zurückgibt, die die MediaList als Text repräsentiert, und es Ihnen auch ermöglicht, eine neue MediaList festzulegen.

MediaList.length Schreibgeschützt

Gibt die Anzahl der Medienabfragen in der MediaList zurück.

Instanzmethoden

MediaList.appendMedium()

Fügt eine Medienabfrage zur MediaList hinzu.

MediaList.deleteMedium()

Entfernt eine Medienabfrage aus der MediaList.

MediaList.item()

Ein Getter, der eine Zeichenkette zurückgibt, die eine Medienabfrage als Text darstellt, basierend auf dem Indexwert der Medienabfrage in der MediaList. Diese Methode kann auch mit der Klammer-Syntax ([]) aufgerufen werden.

MediaList.toString()

Gibt eine Zeichenkettenrepräsentation dieser Medienliste im selben Format zurück wie die MediaList.mediaText-Eigenschaft des Objekts.

Beispiele

Das folgende Beispiel würde eine textliche Darstellung der MediaList des ersten Stylesheets ausgeben, das auf das aktuelle Dokument angewendet wird.

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