База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Window.matchMedia и MediaQueryList.matches

Провери с JavaScript дали дадена CSS медийна заявка е изпълнена в момента и реагирай само при промяна на резултата.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

const mediaQueryList = window.matchMedia(mediaQueryString);
const matchesNow = mediaQueryList.matches;

window.matchMedia(query) приема CSS медийна заявка като низ и при всяко извикване връща нов обект MediaQueryList, а не булева стойност. Подай само заявката, без @media и без блок с правила. Постави условията за характеристики на средата в скоби: (max-width: 600px) проверява дали ширината на областта за показване е най-много 600 CSS пиксела, включително граничната стойност.

Прочети list.matches без скоби. Това е булево свойство само за четене: връща true, ако списъкът с медийни заявки е празен или ако документът в момента отговаря на поне една заявка от списъка със запетаи като разделители, и false в противен случай. Стойността false не означава синтактична грешка. При повторно четене от същия обект получаваш актуалния резултат; запазена по-рано булева стойност не се обновява сама.

Ако ти трябва началното състояние, прочети list.matches, а за следващите промени използвай list.addEventListener("change", handler). Събитието се задейства при преход от true към false или обратно, а не при всяка промяна на размера. Прочети новия резултат от event.matches. Когато вече не ти трябват известия, извикай list.removeEventListener("change", handler) със същата функция.

Това е API на браузъра, а не част от ECMAScript 2024. Не приемай, че е наличен извън прозорец на браузъра. Ако искаш само да промениш стиловете, използвай @media в CSS: matchMedia() не прилага стилове самостоятелно.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>matchMedia example</title>
</head>
<body>
  <script>
    console.log(window.matchMedia("all").matches);
    console.log(window.matchMedia("not all").matches);
  </script>
</body>
</html>

Резултат

true
false

Отвори HTML файла в браузър и провери резултата в конзолата. `all` съвпада с всяка среда, а `not all` — с никоя, затова ще видиш първо `true`, а после `false`, независимо от ширината на областта за показване.

Свързани уроци

  • JavaScript · Урок 3 · Напреднало · Версия: 4
  • JavaScript · Урок 6 · Напреднало · Версия: 4
  • JavaScript · Урок 7 · Напреднало · Версия: 4
  • JavaScript · Урок 19 · Напреднало · Версия: 4
  • JavaScript · Урок 41 · Средно · Версия: 3
  • JavaScript · Урок 42 · Средно · Версия: 3
  • JavaScript · Урок 43 · Средно · Версия: 3

Източници