MediaQueryListEvent

Baseline 已广泛支持

此功能已成熟,并可在许多设备和浏览器版本上使用。自 2020 年 9 月起,所有浏览器均已提供此功能。

MediaQueryListEvent 对象存储了有关 MediaQueryList 对象发生变化的信息——当 change 事件引用的函数被触发时,该对象作为事件对象可用。

Event MediaQueryListEvent

构造函数

MediaQueryListEvent()

创建一个新的 MediaQueryListEvent 实例。

实例属性

MediaQueryListEvent 接口继承自其父接口 Event 的属性。

MediaQueryListEvent.matches 只读

一个布尔值,如果 document 当前匹配媒体查询列表,则为 true,否则为 false

MediaQueryListEvent.media 只读

一个表示序列化媒体查询的字符串。

实例方法

MediaQueryListEvent 接口继承自其父接口 Event 的方法。

示例

js
const para = document.querySelector("p"); // This is the UI element where to display the text
const mql = window.matchMedia("(width <= 600px)");

mql.addEventListener("change", (event) => {
  if (event.matches) {
    // The viewport is 600 pixels wide or less
    para.textContent = "This is a narrow screen — less than 600px wide.";
    document.body.style.backgroundColor = "red";
  } else {
    // The viewport is more than 600 pixels wide
    para.textContent = "This is a wide screen — more than 600px wide.";
    document.body.style.backgroundColor = "blue";
  }
});

规范

规范
CSSOM 视图模块
# the-mediaquerylist-interface

浏览器兼容性

另见