MediaList

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

MediaList 接口表示样式表的媒体查询，例如通过 <link> 元素的 media 属性设置的那些。

注意：MediaList 是一个实时列表；使用下方列出的属性或方法更新列表将立即更新文档的行为。

实例属性

MediaList.mediaText: 一个 stringifier，它返回表示 MediaList 的文本字符串，并且还允许您设置一个新的 MediaList。
MediaList.length 只读: 返回 MediaList 中媒体查询的数量。

MediaList.appendMedium(): 将媒体查询添加到 MediaList。
MediaList.deleteMedium(): 从 MediaList 中移除媒体查询。
MediaList.item(): 一个 getter，它接收媒体查询在 MediaList 中的索引值，并返回表示该媒体查询的文本字符串。此方法也可以使用方括号 ([]) 语法调用。
MediaList.toString(): 返回此媒体列表的字符串表示形式，格式与对象的 MediaList.mediaText 属性相同。

以下内容会将应用于当前文档的第一个样式表的 MediaList 的文本表示形式记录到控制台。

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

规范
CSS 对象模型 (CSSOM) # the-medialist-interface

此页面最后修改于 2025年6月24日，由 MDN 贡献者编辑。