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