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.

MediaList インターフェイスはスタイルシートのメディアクエリーを表します。例えば、 <link> 要素の media 属性で設定されるものです。

メモ: MediaList は生きたリストです。以下のプロパティやメソッドを使用して更新すると、直ちに文書の動作が更新されます。

プロパティ

MediaList.mediaText

文字列化プロパティであり、 MediaList をテキストとして表す文字列を返し、また新しい MediaList を設定することができます。

MediaList.length 読取専用

この MediaList にあるメディアクエリーの数を返します。

メソッド

MediaList.appendMedium()

MediaList にメディアクエリーを追加します。

MediaList.deleteMedium()

MediaList からメディアクエリーを削除します。

MediaList.item()

メディアクエリーをテキストとして返すゲッターです。メディアクエリーの MediaList 内での位置を指定します。

以下は、現在の文書に適用された最初のスタイルシートの MediaList のテキスト表現をコンソールにログ出力するものです。

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

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser