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

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
MediaList
appendMedium
deleteMedium
item
length
mediaText
toString

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support