MediaList

MediaList 接口表示样式表的媒体查询,例如使用了 media 属性的<link> 元素。

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

属性

MediaList.mediaText (en-US)

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

MediaList.length (en-US) 只读

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

方法

MediaList.appendMedium() (en-US)

MediaList 中添加一个媒体查询。

MediaList.deleteMedium() (en-US)

MediaList 中移除一个媒体查询。

MediaList.item() (en-US)

一个获取函数,返回一个CSSOMString (en-US),表示文本形式的媒体查询,需要提供媒体查询在 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