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 über das media Attribut eines <link>-Elements gesetzt werden.

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

Instanz-Eigenschaften

MediaList.mediaText

Ein stringifier, der eine Zeichenkette zurückgibt, die die MediaList als Text darstellt, und Ihnen auch ermöglicht, eine neue MediaList festzulegen.

MediaList.length Schreibgeschützt

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

Instanz-Methoden

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 innerhalb der MediaList. Diese Methode kann auch mit der Klammer-Syntax ([]) aufgerufen werden.

MediaList.toString()

Gibt eine Zeichenketten-Darstellung dieser Medienliste im gleichen Format wie die MediaList.mediaText Eigenschaft des Objekts.

Beispiele

Das Folgende würde eine textuelle Darstellung der MediaList des ersten Stylesheets, das auf das aktuelle Dokument angewendet wird, in die Konsole ausgeben.

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

BCD tables only load in the browser