{"canonical_url":"https://engineer.company/uk/glossary/viewport/","content_markdown":"# Viewport\n\n## Що це таке\n\nViewport — це прямокутник, у якому браузер розкладає документ і в який його\nмалює: на екрані це область усередині власних панелей вікна, на папері — область\nсторінки на кожному аркуші. CSS постійно міряє відносно нього. Початковий\nвмісний блок, тобто коробка, у якій розкладається кореневий елемент, бере його\nрозмір, медіазапит на `width` чи `height` питає саме про нього, а одиниці `vw` і\n`vh` — це його соті частки. На телефоні слово потребує уточнення, і специфікації\nпропонують кілька: viewport розкладки, візуальний, малий, великий і динамічний.\n\nНа комп'ютері viewport і вікно майже збігаються. На телефоні вони розходяться.\nОскільки дуже багато документів створено для настільних вікон, мобільні браузери\nрозкладають сторінку, яка не дає вказівок, на фіксовану ширину, що імітує\nнастільне вікно, — за специфікацією CSS Viewport зазвичай від 980 до 1024\nCSS-пікселів, — а тоді зменшують результат, щоб він умістився на склі. Сторінка\nвідмовляється від цього одним елементом у своєму `head`, і цей елемент приймає\n`width`, `height`, три межі масштабу, `user-scalable` та `interactive-widget`:\n\n```html\n\u003cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1\" /\u003e\n```\n\nМасштабування ділить viewport надвоє. Viewport розкладки — той, відносно якого\nCSS розкладає сторінку, і масштабування щипком його не зачіпає, тож рядки\nпереносяться там само, що й раніше. Візуальний viewport — це частина сторінки,\nяка саме зараз є на склі: він меншає, коли читач збільшує масштаб, і зсувається,\nколи той пересуває сторінку пальцем. Усталено екранна клавіатура зменшує лише\nвізуальний viewport. Значення `interactive-widget=resizes-content` просить\nбраузер змінити й розкладку, а `overlays-content` — лишити обидва як є.\n\nТелефони ще й мають панелі браузера, що ховаються. Адресний рядок займає місце,\nколи сторінка завантажується, і відступає, коли читач гортає, тож видима висота\nзмінюється під сторінкою, яка стоїть на місці. CSS Values 4 дає для цього три\nрозміри. Великий viewport виходить із того, що всі панелі, здатні сховатися,\nсховано, малий — що всі вони показані, а динамічний стежить за тим, як є\nнасправді. Одиниці мають ті самі префікси, `lvh`, `svh` і `dvh`, разом із\nвідповідними ширинами, а звичайні `vh` і `vw` визначено через великий viewport.\nІнтерфейс, що лягає поверх вмісту й не зсуває його, найчастіше екранна\nклавіатура, залишає всі ці довжини незмінними.\n\n## Чому це важливо\n\nАдаптивний дизайн стоїть на viewport. Точка зламу за шириною в таблиці стилів — це\nзапитання про його ширину, тож сторінку без елемента `meta` телефон розкладе на\nширину настільного вікна й зменшить, аж доки текст стане нечитабельним, хоч би\nяк ретельно було написано медіазапити.\n\nВисота — складна вісь. Ширина може змінюватися через поворот телефона або зміну розміру вікна. Висота\nтакож може змінюватися, коли ховається панель, коли відкривається клавіатура і коли телефон\nобертають, тож усе, що має розмір за висотою екрана, мусить сказати, яку саме\nвисоту воно має на увазі. За малого viewport вміст можна розмістити так, щоб він уміщався за показаних висувних панелей. Коли панелі ховаються, залишається\nсмуга невикористаного місця. Великий заповнює екран і ставить\nвміст за панелі, поки ті видно. Динамічний ураховує зміни стану панелей, але специфікація сама\nпопереджає, що він може змінювати розмір вмісту під час гортання, а це зсуває\nвсе, що нижче.\n\nЕкрани ще й мають кути. Телефон із заокругленими кутами чи вирізом для камери —\nне прямокутник, і з усталеним значенням `auto` вся сторінка лишається на ньому\nвидимою. Додавши `viewport-fit=cover`, сторінка просить, щоб viewport став\nпрямокутником, описаним навколо всього фізичного екрана, і бере на себе\nобов'язок тримати текст подалі від вирізу за допомогою змінних\n`env(safe-area-inset-*)`. На прямокутному дисплеї ці відступи мусять дорівнювати\nнулю, тож одне правило для полів підходить екранам обох видів.\n\nФіксоване позиціювання теж тримається на viewport. Фіксовану коробку розміщують\nвідносно viewport розкладки, якому CSS Positioned Layout дає розмір динамічного\nviewport, тому смуги згоди на cookie, модальні тла й повноекранні меню стоять\nнерухомо, поки сторінка прокручується. Кожен такий елемент розраховує, що цю\nроль не перебрав якийсь предок, а `transform`, `will-change` і `contain` здатні\nїї перебрати.\n\nДрук — це viewport, якого таблиця стилів для екрана ніколи не зустрічає. На\nпапері одиниці viewport вимірюють область сторінки, запит на `width` питає про\nблок сторінки, а фіксований елемент повторюється на кожному аркуші.\n\n## Як це виглядає на практиці\n\nСторінки цього сайту оголошують `width=device-width, initial-scale=1,\nviewport-fit=cover`, тож їх розкладають на ширину телефона, і вони тягнуться від\nкраю до краю, також під вирізом. Таблиця стилів платить за другу половину: бічні\nполя мають значення `max(1rem, env(safe-area-inset-left))` і таке саме правило\nдля правого боку, тож текст тримається на rem від краю й відсувається далі\nтільки там, де є виріз. На низьких екранах в альбомній орієнтації нижня межа\nзростає до `max(2rem, 7vw, env(safe-area-inset-left))`, бо на телефоні без\nвирізу відступи дорівнюють нулю, а один rem виявився надто близько до краю.\n\nПовноекранні секції беруть висоту зі спільної змінної, якій задано `100dvh` із\nзапасним `100vh`, і коментар поруч пояснює чому: `100vh` може бути вищим за\nвидиму частину, поки адресний рядок висунуто, і через це з-під головного блока\nвизирала наступна секція. Два елементи свідомо обходять цю змінну. Знак у шапці\nмає розмір у статичних `vh`, бо знак, прив'язаний до динамічного viewport,\nзмінював би розмір, щойно ховаються панелі браузера, і перекомпоновував би\nголовний блок посеред прокручування. Фіксоване тло на сенсорних екранах має\nвисоту `100lvh`, тож його розмір лишається сталим, коли адресний рядок\nз'являється й зникає, а лежить воно на окремому шарі композиції, бо сенсорні\nбраузери розривали його на світлі й темні смуги під час інерційного\nпрокручування.\n\nУ попередньому макеті головної сторінки кожен блок послуг мав мінімальну висоту `100dvh`, тож займав один екран, поки його вміст був нижчим за екран. Коментарі в таблиці стилів, перевірені в листопаді 2026 року, фіксують тест за 852 на 393 пікселі: висота вмісту блока сягала 412, і блоки стикалися впритул. У тому макеті поля всередині `100dvh`, задані через `box-sizing: border-box`, не додавали висоти на високому екрані й відкривали проміжок лише тоді, коли вміст переповнював блок.\n\nНа задокументованому етапі впровадження воріт якості в серпні 2026 року\nперевірки йшли слідом за медіазапитами.\n[Браузерні ворота якості сайту](/uk/portfolio/a-safety-net-that-no-longer-costs-half-an-hour/)\nтоді перевіряли двадцять дві форми вікна, зібрані в одну спільну таблицю з усіх\nмедіазапитів таблиці стилів, і лише перевірка розкладки від цього подовжилася з\n95 до 405 секунд.\n\nДрук показав, як різняться рушії.\n[Таблиця стилів для друку](/uk/portfolio/built-a-637-line-print-stylesheet/)\nфіксує, що один рушій обчислює одиниці viewport від блока сторінки, а інший —\nвід вікна, тож у другому сторінка, надрукована з широкого вікна, втрачала\nтретину кожного рядка. Таблиця стилів самої шапки описує медіазапитний бік того\nсамого розриву: друк зберігав орієнтацію, висоту й ширину вікна, тож аркуші,\nнадруковані з широкого й вузького вікна, мали шапки, що різнилися на 47\nпікселів, доки `screen and` на початку запиту не обмежило правило вікнами.\n\nПастку з вмісним блоком теж задокументовано.\n[Робота над зменшеним рухом](/uk/portfolio/made-the-reduced-motion-setting-honest/)\nпоказала, що кожна з п'яти властивостей перетворює елемент на вмісний блок для\nвсього, що позиціюється відносно viewport, і саме це непомітно стиснуло шар, на\nякий натискають, щоб щось закрити, так, що він укривав лише частину екрана.\n\n## Де виникають проблеми\n\n**Телефон показує крихітну настільну сторінку.** Без елемента `meta` для\nviewport браузер розкладає сторінку на настільну ширину й зменшує її, а\nмедіазапити бачать саме цю ширину. Додайте `width=device-width, initial-scale=1`\nі лишіть масштабування ввімкненим: `user-scalable=no` забирає в читача його\nвласний спосіб збільшити дрібний текст.\n\n**Повноекранна секція виходить за нижній край екрана.** `100vh` — це великий\nviewport, тож поки адресний рядок висунуто, низ секції, а з ним і будь-яка\nрозміщена там кнопка, ховається за ним. Беріть `svh`, щоб елемент не перекривали розгорнуті панелі браузера, а `dvh` — лише там, де зміна розміру посеред прокручування\nприйнятна.\n\n**Повноекранний шар стискається до блока всередині сторінки.** Предок із\n`transform`, із `will-change`, що його називає, або з певними налаштуваннями containment може стати вмісним\nблоком для `position: fixed`, і шар бере розмір цього предка. Виносьте такі шари\nза межі будь-якого трансформованого елемента.\n\n**Надрукована сторінка втрачає кінець кожного рядка.** Одиниці viewport і запити\nна розміри вікна просочуються в друк, і рушій, який обчислює їх від вікна,\nрозкладає аркуш так, ніби це екран. Тримайте одиниці viewport подалі від усього,\nщо друкується, і ставте `screen and` перед запитами, призначеними для вікон.\n\n## Що почитати далі\n\n- [CSS Viewport Module Level 1](https://www.w3.org/TR/css-viewport-1/) — елемент\n  `meta` для viewport і три варіанти поведінки `interactive-widget`.\n- [CSS Values and Units Level 4: viewport-percentage lengths](https://www.w3.org/TR/css-values-4/#viewport-relative-lengths)\n  — малий, великий і динамічний розміри viewport та всі одиниці, побудовані на\n  них.\n- [CSS Positioned Layout Level 3](https://www.w3.org/TR/css-position-3/) —\n  фіксоване позиціювання, властивості, що його перехоплюють, і те, як воно\n  поводиться на папері.\n- [CSS Environment Variables Level 1](https://www.w3.org/TR/css-env-1/) —\n  відступи безпечної зони й правило, яке робить їх нульовими на прямокутному\n  екрані.\n- [Media Queries Level 4](https://www.w3.org/TR/mediaqueries-4/) — `width`,\n  `height` і `orientation`, виміряні за viewport на екрані й за блоком сторінки\n  під час друку.\n\n\u003chttps://engineer.company/uk/glossary/viewport/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Чим viewport розкладки відрізняється від візуального, що вимірюють vh, dvh і lvh на телефоні й чому фіксовані шари та друк поводяться дивно.","formats":{"gemtext":"https://engineer.company/uk/glossary/viewport/index.gmi","gopher":"https://engineer.company/uk/glossary/viewport/gophermap","html":"https://engineer.company/uk/glossary/viewport/","json":"https://engineer.company/uk/glossary/viewport/index.json","markdown":"https://engineer.company/uk/glossary/viewport/index.md","pdf":"https://engineer.company/uk/glossary/viewport/index.pdf"},"kind":"page","language":"uk","title":"Що таке viewport?","url":"https://engineer.company/uk/glossary/viewport/","version":1}