Как предотвратить прокрутку страницы при модальном окне

Открытое модальное окно не должно двигать фон страницы. Для простого случая добавьте на body класс со свойством overflow: hidden. Если нужно сохранить позицию страницы, зафиксируйте body и верните прокрутку после закрытия окна. В статье разобраны компенсация полосы прокрутки, сенсорные жесты, мобильный Safari, нативный <dialog> и готовые функции JavaScript.

Блокировка через 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();
});

Откройте окно после прокрутки длинной страницы. Фон должен остановиться, содержимое окна – прокручиваться, а после закрытия страница должна вернуться к прежней позиции.

Как проверить модальное окно перед публикацией

  1. Прокрутите страницу до середины и откройте окно. Фон должен оставаться неподвижным, а длинный текст – прокручиваться внутри модального блока.
  2. Закройте окно и снова откройте его после другой прокрутки. Страница должна возвращаться к прежней позиции без горизонтального скачка.
  3. Отдельно проверьте жесты на сенсорном экране. Подложка не должна передавать прокрутку документу, а содержимое окна должно продолжать двигаться.
  4. В большинстве случаев хватает overflow: hidden и overscroll-behavior. Фиксация body нужна, когда позицию страницы нужно восстановить точно.

Комментарии

Оставьте свой комментарий
Пока никто не оставил комментариев