aboutsummaryrefslogtreecommitdiff
path: root/files/pl/web/guide/css/sprawdzanie_media_queries/index.html
blob: 140d3a17962e6b1754660a420212a1e45ea4862b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
---
title: Sprawdzanie media queries
slug: Web/Guide/CSS/Sprawdzanie_media_queries
translation_of: Web/CSS/Media_Queries/Testing_media_queries
---
<p>{{SeeCompatTable}}</p>

<p>DOM dostarcza funkcje, dzięki którym możliwym jest sprawdzenie wyników media query. Jest to możliwe przy użyciu interfejsu {{domxref("MediaQueryList") }} i jego funkcji oraz właściwości. Po utworzeniu obiektu {{domxref("MediaQueryList") }} możesz zbadać wynik zapytania (query) lub (dodatkowo) otrzymywać powiadomienie, gdy rezultat się zmieni.</p>

<h2 id="Creating_a_media_query_list" name="Creating_a_media_query_list">Tworzenie listy media query</h2>

<p>Zanim będziesz mógł ocenić wynik zapytania, musisz utworzyć obiekt {{domxref("MediaQueryList") }}, <span class="short_text" id="result_box" lang="pl"><span class="hps">reprezentujący</span></span> media query. Aby to uczynić użyj metody {{domxref("window.matchMedia") }}.</p>

<p>Na przykład, jeśli chcesz ustalić czy orientacja urządzenia jest pionowa czy pozioma, możesz skorzystać z takiego zapytania jak poniżej:</p>

<pre>var mql = window.matchMedia("(orientation: portrait)"); /* sprawdzamy czy orientacja obiektu, jest pionowa; zwraca obiekt MediaQueryList */
</pre>

<h2 id="Checking_the_result_of_a_query" name="Checking_the_result_of_a_query">Sprawdzanie rezultatu zapytania (query)</h2>

<p>Po wykonaniu powyższej metody, mamy dostęp do obiektu {{domxref("MediaQueryList") }}, który ma kilka przydatnych metod i właściwości. Jedną z nich jest cecha <code>matches</code>, która zwraca <code>prawdę</code> lub <code>fałsz</code>.</p>

<pre class="brush: js">if (mql.matches) {
  /* wykryta orientacja pionowa */
} else {
  /* wykryta orientacja pozioma */
}
</pre>

<h2 id="Receiving_query_notifications" name="Receiving_query_notifications">Otrzymywanie powiadomień</h2>

<p>W przypadku, gdy chciałbyś na bieżąco dostawać alerty o stanie zapytania (query), skorzystaj z funkcji <code>addListener()</code>, która jest zdecydowanie wydajniejsza aniżeli sprawdzanie "ręcznie" co jakiś czas. By skorzystać z tego ułatwienia, wywołaj tę funkcję na obiekcie {{domxref("MediaQueryList") }}, określając <span class="short_text" id="result_box" lang="pl"><span class="hps">obserwator, który implementuje</span></span> interfejs {{domxref("MediaQueryListListener") }}:</p>

<pre class="brush: js">var mql = window.matchMedia("(orientation: portrait)");
mql.addListener(zmianaOrientacji);
zmianaOrientacji(mql);
</pre>

<p>Powyższy kod tworzy media query list, a następnie dołącza listener. Zauważ, że po dodaniu listenera, przywołaliśmy listenera bezpośrednio - trzecia linijka. To pozwala nam określić aktualną orientację urządzenia.</p>

<p>Zaimplementowana metoda <code>zmianaOrientacji()</code> pozwala nam wykonać pewne czynności, gdy zmieni się położenie urządzenia.</p>

<pre class="brush: js">function zmianaOrientacji(mql) {
  if (mql.matches) {
    /* wykryta orientacja pionowa */
  } else {
    /* wykryta orientacja pozioma */
  }
}
</pre>

<h2 id="Ending_query_notifications" name="Ending_query_notifications">Wyłączenie powiadomień</h2>

<p>Gdy nie potrzebujesz już powiadomień dotyczących zmiany wartości zapytania, możesz wywołać metodę <code>removeListener()</code> dostępną w obiekcie {{domxref("MediaQueryList") }}:</p>

<pre>mql.removeListener(zmianaOrientacji);
</pre>

<h2 id="Browser_compatibility" name="Browser_compatibility">Zgodność z przeglądarką</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>9</td>
   <td>{{CompatGeckoDesktop("6.0") }}</td>
   <td>10</td>
   <td>12.1</td>
   <td>5.1</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>3.0</td>
   <td>{{CompatUnknown}}</td>
   <td>10</td>
   <td>12.1</td>
   <td>5</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="See_also" name="See_also">Zobacz także</h2>

<ul>
 <li><a href="/en-US/docs/CSS/Media_queries" title="CSS/Media queries">Media queries</a></li>
 <li>{{domxref("window.matchMedia()") }}</li>
 <li>{{domxref("MediaQueryList") }}</li>
 <li>{{domxref("MediaQueryListListener") }}</li>
</ul>