MediaList

基线广泛可用

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

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

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

属性

MediaList.mediaText: 一个字符串转化器，返回一个DOMString，以文本形式表示 MediaList，也可以通过这个方法设置新的 MediaList。
MediaList.length 只读: 返回 MediaList 中媒体查询的数量。

MediaList.appendMedium(): 向 MediaList 中添加一个媒体查询。
MediaList.deleteMedium(): 从 MediaList 中移除一个媒体查询。
MediaList.item(): 一个获取函数，返回一个CSSOMString，表示文本形式的媒体查询，需要提供媒体查询在 MediaList 中的索引位置。

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

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

规范
CSS Object Model (CSSOM) # the-medialist-interface

此页面最后更新于 2025年6月25日，由 MDN 贡献者更新。