JavaScript查询媒体信息|Window matchMedia() 方法

由 hcduguo

Window 对象参考手册

定义与用法

matchMedia() 返回一个新的 MediaQueryList 对象，表示指定的媒体查询字符串解析后的结果。

matchMedia() 方法的值可以是任何一个 CSS @media 规则 的特性, 如 min-height, min-width, orientation 等。

MediaQueryList 对象有以下两个属性：

  • media：查询语句的内容。
  • matches：用于检测查询结果，如果文档匹配 media query 列表，值为 true，否则为 false。

MediaQueryList 对象还可以监听事件。通过监听，在查询结果发生变化时，就调用指定的回调函数。

方法描述
addListener(functionref)添加一个新的监听器函数，该函数在媒体查询的结果发生变化时执行。
removeListener(functionref)从媒体查询列表中删除之前添加的监听器。      如果指定的监听器不在列表中，则不执行任何操作。

语法格式

window.matchMedia(mediaQueryString)

mediaQueryString: 必需，一个字符串。表示将返回一个新 MediaQueryList 对象的媒体查询。

示例代码

判断屏幕（screen/viewport）窗口大小：

if (window.matchMedia("(max-width: 700px)").matches) {
    /* 窗口小于或等于 700 像素 */
} else {
    /*窗口大于 700 像素 */
}

亲自试试

浏览器支持

方法Google ChromeInternet ExplorerFirefoxSafariOpera
matchMedia()9.010.06.05.112.1

表格中的数字表示支持该方法的第一个浏览器版本号。

更多示例

判断屏幕（screen/viewport）窗口大小，在小于等于 700 像素时修改背景颜色为黄色，大于 700 像素时修改背景颜色为粉红色：

function myFunction(x) {
    if (x.matches) { // 媒体查询
        document.body.style.backgroundColor = "yellow";
    } else {
        document.body.style.backgroundColor = "pink";
    }
}
 
var x = window.matchMedia("(max-width: 700px)")
myFunction(x) // 执行时调用的监听函数
x.addListener(myFunction) // 状态改变时添加监听器

亲自试试

Window 对象参考手册

相关