overscroll-behavior

CSS-свойство overscroll-behavior — это сокращение для свойств overscroll-behavior-x (en-US) и overscroll-behavior-y (en-US), которые позволяют управлять поведением прокрутки при достижении границы области прокрутки.

/* Значения-ключевые слова */
overscroll-behavior: auto; /* по умолчанию */
overscroll-behavior: contain;
overscroll-behavior: none;

/* Двойное значение */
overscroll-behavior: auto contain;

/* Глобальные значения */
overflow: inherit;
overflow: initial;
overflow: unset;

По умолчанию мобильные браузеры, как правило, обеспечивают эффект «отскока» или даже обновляют страницу при достижении её верхней или нижней части (или другой области прокрутки). Возможно, вы также замечали, что когда поверх страницы с прокруткой расположено диалоговое окно с прокруткой, то при достижении границы прокрутки диалогового окна нижележащая страница начинает прокручиваться. Это называется цепочкой прокрутки (scroll chaining, англ.)

В некоторых случаях такое поведение нежелательно. Вы можете использовать overscroll-behavior, чтобы избавиться от нежелательных цепочек прокрутки и поведения страниц браузера по принципу «потяните, чтобы обновить» (pull to refresh, англ.), характерного, например, для приложений Facebook и Twitter.

Начальное значениеauto
Применяется кне заменяемые блочные и inline-block элементы
Наследуетсянет
Обработка значениякак и у каждого из подсвойств этого свойства:
Animation typediscrete

Синтаксис

Свойство overscroll-behavior задаётся в виде одного или двух ключевых слов, выбранных из списка значений ниже.

Два ключевых слова определяют значение overscroll-behavior по осям x и y соответственно. Если задано только одно значение, то предполагается, что и x, и y одинаковы.

Значения

auto
Поведение по умолчанию.
contain
Поведение для overscroll-behavior применяется внутри элемента, для которого установлено это значение (например, эффекты «отскока» или обновления), но не возникают цепочки прокрутки для соседних областей прокрутки, например, нижележащие элементы не будут прокручиваться.
none
Не происходит цепочки прокрутки в соседних областях прокрутки, и по умолчанию предотвращается достижение границы области прокрутки.

Формальный синтаксис

[ (en-US) contain | (en-US) none | (en-US) auto ] (en-US){ (en-US)1,2} (en-US)

Примеры

В нашем примере overscroll-поведения (см. также код по ссылке ) представлен полностраничный список поддельных контактов и диалоговое окно с чатом.

Обе эти области прокручиваются; обычно, если вы прокручиваете окно чата до тех пор, пока не достигнете границы прокрутки, нижележащее окно контактов тоже начнёт прокручиваться, что нежелательно. Предотвратить такое поведение можно, используя overscroll-behavior-y (overscroll-behavior также подойдет) для окна чата, как показано ниже:

.messages {
  height: 220px;
  overflow: auto;
  overscroll-behavior-y: contain;
} 

Мы также хотим избавиться от стандартного overscroll-эффекта при прокрутке контактов вверх или вниз (например, Chrome на Android обновляет страницу при прокрутке за пределы верхней границы). Это можно предотвратить, установив для элемента <body> значение overscroll-behavior: none:

body {
  margin: 0;
  overscroll-behavior: none;
}

Спецификации

Пока CSSWG не опубликует свой собственный вариант, спецификация может быть найдена толькона Github в репозитории WICG.

Specification Status Comment
Unknown
Определение 'overscroll-behavior' в этой спецификации.
Неизвестно  

Browser compatibility

BCD tables only load in the browser

См. также