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

MediaQueryList.matches

· 52CE 我爱测

MediaQueryList 接口的 **`matches`** 只读属性是一个布尔值,如果 document 当前匹配媒体查询列表,该属性返回 `true`,否则返回 `false`。

CSSOM

MediaQueryList 接口的 matches 只读属性是一个布尔值,如果 document 当前匹配媒体查询列表,该属性返回 true,否则返回 false。

通过侦听发生在 MediaQueryList 的 MediaQueryList.change_event 事件,当 matches 的值发生变化时,你可以收到通知。

值

一个布尔值,如果 document 目前匹配媒体查询列表,该值为 true,反之为 false。

示例

该示例通过使用 orientation 媒体查询特性来创建一个媒体查询,以检测视口横纵方向的变化:

function addMQListener(mq, callback) {
  if (mq.addEventListener) {
    mq.addEventListener("change", callback);
  } else {
    mq.addListener(callback);
  }
}

addMQListener(window.matchMedia("(orientation:landscape)"), (event) => {
  if (event.matches) {
    /* 现在是横向 */
  } else {
    /* 现在是纵向 */
  }
});

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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