---
title: MediaQueryList
slug: Web/API/MediaQueryList
translation_of: Web/API/MediaQueryList
---
<div>{{APIRef("CSSOM View")}}{{SeeCompatTable}}</div>

<p>一个<code>MediaQueryList</code>对象在一个{{ domxref("document") }}上维持着一系列的<a href="/zh-CN/docs/CSS/Media_queries" title="CSS/Media queries">媒体查询</a>，并负责处理当媒体查询在其document上发生变化时向监听器进行通知的发送。</p>

<p>如果你需要以编程方式来检测一个document上的媒体查询的值的变化，这个<code>MediaQueryList</code>对象使得通过观察其document而检测它的媒体查询的值的变化成为可能，而不是周期性地对这些媒体查询的值进行检查。</p>

<h2 id="Method_overview" name="Method_overview">方法概述</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td><code>void <a href="/zh-CN/docs/DOM/MediaQueryList#addListener()" title="DOM/MediaQueryList#addListener()">addListener</a>(MediaQueryListListener listener);</code></td>
  </tr>
  <tr>
   <td><code>void <a href="/zh-CN/docs/DOM/MediaQueryList#removeListener()" title="DOM/MediaQueryList#removeListener()">removeListener</a>(MediaQueryListListener listener);</code></td>
  </tr>
 </tbody>
</table>

<h2 id="Properties" name="Properties">属性</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td class="header">Property</td>
   <td class="header">Type</td>
   <td class="header">Description</td>
  </tr>
  <tr>
   <td><code>matches</code></td>
   <td><code>boolean</code></td>
   <td><code>如果当前</code>{{ domxref("document") }}匹配该媒体查询列表则其值为true；反之其值为false。<strong>只读。</strong></td>
  </tr>
  <tr>
   <td><code>media</code></td>
   <td><code>DOMString</code></td>
   <td>序列化的媒体查询列表。</td>
  </tr>
 </tbody>
</table>

<h2 id="Methods" name="Methods">方法</h2>

<h3 id="addListener()" name="addListener()">addListener()</h3>

<p>在媒体查询列表上增加一个新的监听器，如果列表中已经存在了这个指定的监听器，这个方法将失去作用。</p>

<pre>void addListener(
  MediaQueryListListener listener
);</pre>

<h4 id="Parameter_(for_addListener_method)" name="Parameter_(for_addListener_method)">参数 ( 针对addListener方法)</h4>

<dl>
 <dt><code>listener</code></dt>
 <dd>当其媒体查询的求值结果发生变化时，该{{ domxref("MediaQueryListListener") }} 对象将会被调用。</dd>
</dl>

<h3 id="removeListener()" name="removeListener()">removeListener()</h3>

<p>从媒体查询列表中移除一个监听器，如果列表中不存在这个指定的监听器，则这个方法将失去作用。</p>

<pre>void removeListener(
  MediaQueryListListener listener
);</pre>

<h4 id="Parameter_(for_removeListener_method)" name="Parameter_(for_removeListener_method)">参数 (针对removeListener方法)</h4>

<dl>
 <dt><code>listener</code></dt>
 <dd>该{{ domxref("MediaQueryListListener") }}对象将停止访问媒体查询的求值结果发生的变化。</dd>
</dl>

<h2 id="Browser_compatibility" name="Browser_compatibility">浏览器通用性</h2>

{{Compat("api.MediaQueryList")}}

<h2 id="Specification" name="Specification">详述</h2>

<ul>
 <li><a class="external" href="http://dev.w3.org/csswg/cssom-view/#the-mediaquerylist-interface" title="http://dev.w3.org/csswg/cssom-view/#the-mediaquerylist-interface">CSSOM视图模型: MediaQueryList接口</a></li>
</ul>

<h2 id="See_also" name="See_also">请参阅</h2>

<ul>
 <li><a href="/zh-CN/docs/CSS/Media_queries" title="CSS/Media queries">CSS媒体查询</a></li>
 <li><a href="https://developer.mozilla.org/zh-CN/docs/DOM/Using_media_queries_from_code" title="CSS/Using media queries from code">通过代码使用媒体查询</a></li>
 <li>{{ domxref("window.matchMedia()") }}</li>
 <li>{{ domxref("MediaQueryListListener") }}</li>
</ul>