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 接口表示样式表的媒体查询,例如使用了 media 属性的<link> 元素。

备注: MediaList 是一个实时列表;使用以下属性或方法更新列表会立刻更新文档的表现。

属性

MediaList.mediaText

一个字符串转化器,返回一个DOMString,以文本形式表示 MediaList,也可以通过这个方法设置新的 MediaList

MediaList.length 只读

返回 MediaList 中媒体查询的数量。

方法

MediaList.appendMedium()

MediaList 中添加一个媒体查询。

MediaList.deleteMedium()

MediaList 中移除一个媒体查询。

MediaList.item()

一个获取函数,返回一个CSSOMString,表示文本形式的媒体查询,需要提供媒体查询在 MediaList 中的索引位置。

示例

下述例子会在控制台记录 MediaList 的文本表示,其来自应用到当前文档的第一个样式表。

js
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