大网数据广告活动
Web 标准与前端开发

Window.matchMedia()

· 52CE 我爱测

Window 的 **`matchMedia()`** 方法返回一个新的 MediaQueryList 对象,表示指定的媒体查询字符串解析后的结果。返回的 `MediaQueryList` 可被用于判定 Document 是否匹配媒体查询,或者监控一个 `document` 来判定它匹配了或者停止匹配了此媒体查询。

Window 的 matchMedia() 方法返回一个新的 MediaQueryList 对象,表示指定的媒体查询字符串解析后的结果。返回的 MediaQueryList 可被用于判定 Document 是否匹配媒体查询,或者监控一个 document 来判定它匹配了或者停止匹配了此媒体查询。

语法

matchMedia(mediaQueryString)

参数

  • mediaQueryString
    • : 一个被用于媒体查询解析的字符串。

返回值

一个用来媒体查询的新的MediaQueryList对象

使用说明

你可以使用返回的媒体查询来执行即时检查和事件驱动检查,以查看文档是否与媒体查询匹配。

要执行一次瞬时检查以查看文档是否与媒体查询匹配,请查看MediaQueryList.matches属性的值,当 document 满足媒体查询条件的时候将会返回true。

如果你需要始终了解 document 是否与媒体查询匹配,则可以查看将要传递给对象的MediaQueryList.change_event 事件。Window.devicePixelRatio上的文章中有一个很好的例子。

示例

此示例运行媒体查询(max-width: 600px)并在span;中显示MediaQueryList的matches属性值。如果视口的宽度小于或等于 600 像素,则输出将为 true,而如果窗口的宽度大于此宽度,则将输出 false。

JavaScript

let mql = window.matchMedia("(max-width: 600px)");

document.querySelector(".mq-value").innerText = mql.matches;

JavaScript 代码只需将要匹配的媒体查询字符串传递到Window.matchMedia进行编译,然后设置<span>的HTMLElement.innerText为MediaQueryList.media属性结果的值,以便它表明此 document 在此刻页面加载完成时是否与媒体查询所匹配。

HTML

<span class="mq-value"></span>

一个简单的 <span> 来接收输出。

.mq-value {
  font:
    18px arial,
    sans-serif;
  font-weight: bold;
  color: #88f;
  padding: 0.4em;
  border: 1px solid #dde;
}

结果

示例

参考更多的例子来 通过代码使用媒体查询 。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。