CustomScrollView
Компонент, который унифицирует браузерную полосу прокрутки на всех платформах.
Прокручиваемый контент
Контент, который требует полосы прокрутки, необходимо передавать в свойство children.
Параметры прокрутки
overscrollBehavior
Свойство overscrollBehavior отвечает за поведение при достижении границы области прокрутки.
Подробнее с поведением и значениями можно ознакомиться в документации overscrollBehavior ↗.
scrollBehavior
Свойство scrollBehavior отвечает за анимацию прокрутки.
Подробнее с поведением и значениями можно ознакомиться в документации scroll-behavior ↗.
Скрытие полосы прокрутки
Свойство scrollbarHidden позволяет управлять видимостью полосы прокрутки.
true— полоса прокрутки скрыта;false— полоса прокрутки видна (по умолчанию).
Горизонтальная полоса прокрутки
Свойство enableHorizontalScroll позволяет отображать горизонтальную полосу прокрутки.
true— горизонтальная полоса прокрутки видна;false— горизонтальная полоса прокрутки скрыта (по умолчанию).
Обработчики событий
Компонент позволяет обрабатывать событие scroll, возникающее при прокрутке контента, через свойство onScroll.
useCustomScrollViewTint
Хук, который добавляет тени к краям прокручиваемой области через CSS-маску (maskImage).
Маска реагирует на положение прокрутки: тень появляется только у тех краёв, за которыми
есть ещё контент.
Хук возвращает объект с тремя свойствами, которые нужно передать прокручиваемому элементу:
getRootRef— референс на прокручиваемый элемент;onScroll— обработчик событияscroll;style— объект стилей сmaskImageиmaskComposite(необходимо применить к прокручиваемому элементу).
Свойства и методы
| Свойство | Описание |
|---|---|
enableHorizontalScroll | booleanВключение отображения горизонтального скролла. По умолчанию: false |
getRootRef | Ref<HTMLDivElement>По умолчанию: - |
overscrollBehavior | "none" | "auto" | "contain"Поведение overscroll, подробнее можно почитать в документации ↗. По умолчанию: auto |
scrollbarHidden | booleanСкрытие скроллбара. По умолчанию: false |
scrollBehavior | "auto" | "smooth"Поведение scroll-behavior, подробнее можно почитать в документации ↗. По умолчанию: auto |