MediaList: mediaText-Eigenschaft

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 mediaText-Eigenschaft der MediaList-Schnittstelle ist ein Stringifier, der eine Zeichenkette zurückgibt, die die MediaList als Text darstellt und es Ihnen auch ermöglicht, eine neue MediaList festzulegen.

Wert

Eine Zeichenkette, die die Medienabfragen eines Stylesheets darstellt. Jede wird durch ein Komma getrennt, zum Beispiel screen and (min-width: 480px), print.

Wenn Sie neue Medienabfragen im Dokument festlegen möchten, muss der Zeichenkettenwert die verschiedenen Abfragen durch Kommas getrennt haben, z.B. screen, print. Beachten Sie, dass die MediaList eine Live-Liste ist; durch das Aktualisieren der Liste über mediaText wird sofort das Verhalten des Dokuments aktualisiert.

Wenn auf den Wert null gesetzt, wird dieser null-Wert in die leere Zeichenkette ("") umgewandelt, sodass ml.mediaText = null gleichbedeutend mit ml.mediaText = "" ist.

Beispiele

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

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

Spezifikationen

Specification
CSS Object Model (CSSOM)
# dom-medialist-mediatext

Browser-Kompatibilität

BCD tables only load in the browser