Как предотвратить прокрутку страницы при модальном окне
Открытое модальное окно не должно двигать фон страницы. Для простого случая добавьте на body класс со свойством overflow: hidden. Если нужно сохранить позицию страницы, зафиксируйте body и верните прокрутку после закрытия окна. В статье разобраны компенсация полосы прокрутки, сенсорные жесты, мобильный Safari, нативный <dialog> и готовые функции JavaScript.
- Блокировка через overflow: hidden
- Как убрать сдвиг от полосы прокрутки
- Фиксация body в мобильном Safari
- Прокрутка внутри окна и обработка касаний
- Нативный dialog и блокировка фона
- Как выбрать способ блокировки прокрутки
- Готовые функции lockScroll() и unlockScroll()
- Как проверить модальное окно перед публикацией
Блокировка через overflow: hidden
Добавьте класс на body при открытии окна. Свойство overflow: hidden отключит прокрутку документа, пока класс остается на элементе.
body.modal-open {
overflow: hidden;
}
.modal {
max-height: 100dvh;
overflow-y: auto;
overscroll-behavior: contain;
}Содержимое окна прокручивается внутри блока. Ограничение max-height подходит для длинного текста лучше фиксированной высоты.
document.body.classList.add('modal-open');
// При закрытии окна
document.body.classList.remove('modal-open');Откройте окно на длинной странице. Фон останется неподвижным, а длинный текст внутри модального блока продолжит прокручиваться.
Как убрать сдвиг от полосы прокрутки
После отключения прокрутки полоса исчезает, и документ получает дополнительную ширину. Из-за этого содержимое может сместиться вправо.
Вычислите ширину полосы до блокировки. Формула использует разницу между шириной окна и шириной корневого элемента документа.
const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
const currentPadding = parseFloat(getComputedStyle(document.body).paddingRight) || 0;
document.body.style.paddingRight = `${currentPadding + scrollbarWidth}px`;
document.body.classList.add('modal-open');На мобильных устройствах и при накладной полосе значение часто равно нулю. Поэтому лишний отступ в таких случаях не появится.
document.body.classList.remove('modal-open');
document.body.style.paddingRight = '';Если проект поддерживает scrollbar-gutter: stable, это свойство заранее резервирует место под полосу. Тогда класс блокировки не меняет ширину содержимого.
Фиксация body в мобильном Safari
В современных версиях Safari overflow: hidden часто решает задачу. Фиксация body нужна, когда жесты все еще двигают фон или позицию страницы важно восстановить точно.
Задайте телу ширину и модель расчета размеров. box-sizing: border-box включает компенсационный отступ в ширину, поэтому body не получает горизонтального переполнения.
body.is-scroll-locked {
position: fixed;
top: var(--scroll-lock-top);
left: 0;
right: 0;
width: 100%;
box-sizing: border-box;
}Сохраните исходное inline-значение padding-right. При открытии прибавьте к вычисленному отступу ширину полосы, а при закрытии верните сохраненное значение.
let scrollY = 0;
let originalPaddingRight = '';
function lockScroll() {
scrollY = window.scrollY;
originalPaddingRight = document.body.style.paddingRight;
const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
const currentPadding = parseFloat(getComputedStyle(document.body).paddingRight) || 0;
document.body.style.setProperty('--scroll-lock-top', `-${scrollY}px`);
document.body.style.paddingRight = `${currentPadding + scrollbarWidth}px`;
document.body.classList.add('is-scroll-locked');
}
function unlockScroll() {
const top = document.body.style.getPropertyValue('--scroll-lock-top');
document.body.classList.remove('is-scroll-locked');
document.body.style.removeProperty('--scroll-lock-top');
document.body.style.paddingRight = originalPaddingRight;
window.scrollTo(0, parseInt(top || '0', 10) * -1);
}Откройте окно в середине страницы, затем закройте его. Страница вернется к прежней позиции без горизонтального скачка.
Прокрутка внутри окна и обработка касаний
Сделайте область с содержимым отдельным прокручиваемым контейнером. Свойство overscroll-behavior: contain не передает прокрутку странице после достижения края окна.
.modal-backdrop {
position: fixed;
inset: 0;
}
.modal {
position: fixed;
max-height: 100dvh;
}
.modal__content {
max-height: calc(100dvh - 2rem);
overflow-y: auto;
overscroll-behavior: contain;
}Расположите подложку и окно соседними элементами. Без проверки цели безусловный preventDefault() на предке отменит жест и сломает прокрутку вложенного содержимого.
<div class="modal-backdrop"></div>
<section class="modal">
<div class="modal__content">Текст окна</div>
</section>Отменяйте жест только при непосредственном касании подложки. Параметр passive: false разрешает вызвать preventDefault(), потому что в пассивном обработчике отмена прокрутки не работает.
const backdrop = document.querySelector('.modal-backdrop');
backdrop.addEventListener('touchmove', (event) => {
if (event.target === backdrop) {
event.preventDefault();
}
}, { passive: false });Прокрутите длинный текст внутри окна. Жест на тексте должен двигать контейнер, а жест по свободной подложке не должен двигать страницу.
Нативный dialog и блокировка фона
Метод showModal() делает остальную страницу недоступной для взаимодействия. Для прокрутки добавьте условие на открытый диалог.
body:has(dialog[open]) {
overflow: hidden;
}
dialog {
max-height: 100dvh;
overflow: auto;
overscroll-behavior: contain;
}const dialog = document.querySelector('dialog');
const openButton = document.querySelector('[data-open-dialog]');
const closeButton = document.querySelector('[data-close-dialog]');
openButton.addEventListener('click', () => {
dialog.showModal();
});
closeButton.addEventListener('click', () => {
dialog.close();
});Псевдокласс :has() и элемент <dialog> поддерживаются современными браузерами. Для старого браузера замените селектор классом на body и переключайте его при открытии и закрытии окна.
Как выбрать способ блокировки прокрутки
Выбирайте способ по поведению окна. Простому окну хватит класса, а точное восстановление позиции требует фиксации страницы.
| Способ | Где работает | Побочные эффекты | Нужен JavaScript |
|---|---|---|---|
overflow: hidden | Обычные модальные окна | Исчезновение полосы может сдвинуть содержимое | Для переключения класса |
position: fixed и top | Когда нужно сохранить позицию страницы, включая мобильные сценарии | Нужно задать ширину и восстановить прокрутку | Да |
<dialog> и :has() | Современные браузеры с нативным диалогом | Для старых браузеров нужен запасной вариант | Для открытия и закрытия |
overscroll-behavior: contain | Внутренний прокручиваемый контейнер окна | Само по себе не блокирует документ | Нет |
Готовые функции lockScroll() и unlockScroll()
Этот комплект фиксирует страницу, учитывает исходный отступ, компенсирует ширину полосы и возвращает позицию после закрытия.
body.is-scroll-locked {
position: fixed;
top: var(--scroll-lock-top);
left: 0;
right: 0;
width: 100%;
box-sizing: border-box;
}
.modal__content {
max-height: calc(100dvh - 2rem);
overflow-y: auto;
overscroll-behavior: contain;
}<button type="button" data-open-modal>Открыть окно</button>
<section class="modal" hidden>
<button type="button" data-close-modal>Закрыть</button>
<div class="modal__content">Длинный текст окна</div>
</section>Разместите разметку до скрипта или запустите скрипт после создания этих элементов. Тогда кнопки получат обработчики без ошибки обращения к null.
let scrollY = 0;
let originalPaddingRight = '';
function lockScroll() {
scrollY = window.scrollY;
originalPaddingRight = document.body.style.paddingRight;
const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
const currentPadding = parseFloat(getComputedStyle(document.body).paddingRight) || 0;
document.body.style.setProperty('--scroll-lock-top', `-${scrollY}px`);
document.body.style.paddingRight = `${currentPadding + scrollbarWidth}px`;
document.body.classList.add('is-scroll-locked');
}
function unlockScroll() {
const top = document.body.style.getPropertyValue('--scroll-lock-top');
document.body.classList.remove('is-scroll-locked');
document.body.style.removeProperty('--scroll-lock-top');
document.body.style.paddingRight = originalPaddingRight;
window.scrollTo(0, parseInt(top || '0', 10) * -1);
}
const modal = document.querySelector('.modal');
const openButton = document.querySelector('[data-open-modal]');
const closeButton = document.querySelector('[data-close-modal]');
openButton.addEventListener('click', () => {
lockScroll();
modal.hidden = false;
});
closeButton.addEventListener('click', () => {
modal.hidden = true;
unlockScroll();
});Откройте окно после прокрутки длинной страницы. Фон должен остановиться, содержимое окна – прокручиваться, а после закрытия страница должна вернуться к прежней позиции.
Как проверить модальное окно перед публикацией
- Прокрутите страницу до середины и откройте окно. Фон должен оставаться неподвижным, а длинный текст – прокручиваться внутри модального блока.
- Закройте окно и снова откройте его после другой прокрутки. Страница должна возвращаться к прежней позиции без горизонтального скачка.
- Отдельно проверьте жесты на сенсорном экране. Подложка не должна передавать прокрутку документу, а содержимое окна должно продолжать двигаться.
- В большинстве случаев хватает
overflow: hiddenиoverscroll-behavior. Фиксацияbodyнужна, когда позицию страницы нужно восстановить точно.
Популярное за неделю
- Как создать сайт самому в 2026: 4 способа + пошаговая инструкция 34 мин чтения
- Лучшие конструкторы для создания сайтов — плюсы, минусы и сравнения 22 мин чтения
- Как создать скрипт сокращения ссылок на PHP 3 мин чтения
- js переход на другую страницу: методы, примеры и сравнение 5 мин чтения
- Фотогалерея для сайта: способы реализации и рабочий код 11 мин чтения
- 15 плагинов календарей и событий для сайта 9 мин чтения
Комментарии