Window.matchMedia()

在此页

句法
用法注意事项
范例
规范
浏览器兼容性
另请参阅
相关话题

Window 接口的 matchMedia() method returns a new MediaQueryList object that can then be used to determine if the document matches the media query string, as well as to monitor the document to detect when it matches (or stops matching) that media query.

句法

mqList = window.matchMedia(mediaQueryString)

参数

mediaQueryString: A string specifying the media query to parse into a MediaQueryList .

返回值

新的 MediaQueryList object for the media query. Use this object's properties and events to detect matches and to monitor for changes to those matches over time.

用法注意事项

You can use the returned media query to perform both instantanteous and event-driven checks to see if the document matches the media query.

To perform a one-time, instantaneous check to see if the document matches the media query, look at the value of the 匹配 property, which will be true if the document meets the media query's requirements.

If you need to be kept aware of whether or not the document matches the media query at all times, you can instead watch for the change event to be delivered to the object. There's a good example of this in the article on Window.devicePixelRatio .

范例

This example runs the media query (max-width: 600px) and displays the value of the resulting MediaQueryList 's 匹配 property in a <span> ; as a result, the output will say "true" if the viewport is less than or equal to 600 pixels wide, and will say "false" if the window is wider than that.

JavaScript

let mql = window.matchMedia('(max-width: 600px)');
document.querySelector(".mq-value").innerText = mql.matches;

The JavaScript code simply passes the media query to match into matchMedia() to compile it, then sets the <span> 's innerText to the value of the results' 匹配 property, so that it indicates whether or not the document matches the media query at the moment the page was loaded.

HTML

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

简单 <span> to receive the output.

CSS

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

结果

见 Testing media queries programmatically for additional code examples.

规范

规范	状态	注释
CSSOM (CSS 对象模型) 视图模块 The definition of 'Window.matchMedia()' in that specification.	工作草案	初始定义

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`matchMedia`	Chrome 9	Edge 12	Firefox 6	IE 10	Opera 12.1	Safari 5.1	WebView Android ≤37	Chrome Android 18	Firefox Android 6	Opera Android 12.1	Safari iOS 5	Samsung Internet Android 1.0

在此页

句法

参数

返回值

用法注意事项

范例

JavaScript

HTML

CSS

结果

规范

浏览器兼容性

图例

另请参阅

元数据

相关话题