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.

Die MediaList-Schnittstelle repräsentiert die Media Queries eines Stylesheets, z. B. solche, die mit dem media-Attribut eines <link>-Elements gesetzt wurden.

Hinweis: MediaList ist eine Live-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 darstellt, und es Ihnen auch ermöglicht, eine neue MediaList festzulegen.

MediaList.length Nur lesbar

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 eine Zeichenkette zurückgibt, die eine Media Query als Text darstellt, basierend auf dem Indexwert der Media Query in der MediaList. Diese Methode kann auch mit der Klammer-Syntax ([]) aufgerufen werden.

Beispiele

Das Folgende würde eine textuelle Darstellung der MediaList des ersten auf das aktuelle Dokument angewendeten Stylesheets in die Konsole protokollieren.

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