Записи с меткой "CSS Анимация"
@-webkit-keyframes
Синтаксис
@-webkit-keyframes <имя анимации> {
<селектор кадра 1> {
<свойство 1>:<значение 1>;
<свойство 2>:<значение 1>;
}
<селектор кадра 2> {
<свойство 1>:<значение 2>;
<свойство 2>:<значение 2>;
}
.....................
<селектор кадра n> {
<свойство 1>:<значение n>;
<свойство 2>:<значение n>;
}
}
-
<имя анимации> — задает имя анимации в виде строки в одинарных кавычках (это имя потом используется при вызове анимации в качестве значения свойства -webkit-animation-name)
-
<селектор кадра> — задает селекторы которые определяют ключевые кадры. Они могут принимать значения:
-
from — внутри этого селектора описывается значения анимированных свойств в начальный момент анимации (также можно описать начальный кадр анимации, используя эквивалентный селектор 0%)
-
to — внутри этого селектора описывается значения анимированных свойств в конечный момент анимации (также можно описать конечный кадр анимации, используя эквивалентный селектор 100%)
-
<процент> — описывает значения анимированных свойств в данный момент времени (момент времени отсчитывается в процентном отношении от значения свойства -webkit-animation-duration)
-
<свойство> — анимируемое CSS свойство
-
<значение> — значения анимированного свойств в момент, описываемый селектором кадра
Пример кода
div {
top:50px;
left:0px;
-webkit-animation-name:'movement';
-webkit-animation-duration:10s;
}
@-webkit-keyframes 'movement' {
from {
top:50px;
left:0px;
}
50% {
top:150px;
left:100px;
}
to {
top:400px;
left:300px;
}
}
Swiper API
Полный HTML-макет Swiper
<!-- Slider main container -->
<div class="swiper">
<!-- Additional required wrapper -->
<div class="swiper-wrapper">
<!-- Slides -->
<div class="swiper-slide">Slide 1</div>
<div class="swiper-slide">Slide 2</div>
<div class="swiper-slide">Slide 3</div>
...
</div>
<!-- If we need pagination -->
<div class="swiper-pagination"></div>
<!-- If we need navigation buttons -->
<div class="swiper-button-prev"></div>
<div class="swiper-button-next"></div>
<!-- If we need scrollbar -->
<div class="swiper-scrollbar"></div>
</div>
Стили
Пакет Swiper содержит различные наборы стилей CSS, Less и SCSS:
Стили CSS
Стили CSS для версии пакета:
swiper-bundle.css— все стили Swiper, включая стили всех модулей (например, навигации, постраничной навигации и т. д.)swiper-bundle.min.css- такой же, как предыдущий, но уменьшенный
Стили CSS для версии пакета (импорт пакета):
swiper/css— все стили Swiper, включая стили всех модулей (например, навигации, постраничной навигации и т. д.)swiper/css/bundle- такой же, как предыдущий, но уменьшенный
Стили CSS для базовой версии и модулей (импорт пакетов):
swiper/css- только основные стили Swiperswiper/css/a11y- стили, необходимые для модуля A11yswiper/css/autoplay- стили, необходимые для модуля автозапускаswiper/css/controller- стили, необходимые для модуля контроллераswiper/css/effect-cards- стили, необходимые для модуля Cards Effectswiper/css/effect-coverflow- стили, необходимые для модуля Coverflow Effectswiper/css/effect-creative- стили, необходимые для модуля Creative Effectswiper/css/effect-cube- стили, необходимые для модуля Cube Effectswiper/css/effect-fade- стили, необходимые для модуля эффекта затуханияswiper/css/effect-flip- стили, необходимые для модуля Flip Effectswiper/css/free-mode- стили, необходимые для модуля свободного режимаswiper/css/grid- стили, необходимые для модуля Gridswiper/css/hash-navigation- стили, необходимые для модуля навигации по хэшуswiper/css/history- стили, необходимые для модуля Историиswiper/css/keyboard- стили, необходимые для модуля клавиатурыswiper/css/manipulation- стили, необходимые для модуля манипулированияswiper/css/mousewheel- стили, необходимые для модуля Mousewheelswiper/css/navigation- стили, необходимые для навигационного модуляswiper/css/pagination- стили, необходимые для модуля разбивки на страницыswiper/css/parallax- стили, необходимые для модуля Parallaxswiper/css/scrollbar- стили, необходимые для модуля полосы прокруткиswiper/css/thumbs- стили, необходимые для модуля Thumbsswiper/css/virtual- стили, необходимые для виртуального модуляswiper/css/zoom- стили, необходимые для модуля масштабирования
Меньше стилей
Меньшие стили - это отдельные стили для базовой версии и модулей (импорт пакетов):
swiper/less- только основные стили Swiperswiper/less/bundle— все стили Swiper, включая стили всех модулей (например, навигации, постраничной навигации и т. д.)swiper/less/a11y- стили, необходимые для модуля A11yswiper/less/autoplay- стили, необходимые для модуля автозапускаswiper/less/controller- стили, необходимые для модуля контроллераswiper/less/effect-cards- стили, необходимые для модуля Cards Effectswiper/less/effect-coverflow- стили, необходимые для модуля Coverflow Effectswiper/less/effect-creative- стили, необходимые для модуля Creative Effectswiper/less/effect-cube- стили, необходимые для модуля Cube Effectswiper/less/effect-fade- стили, необходимые для модуля эффекта затуханияswiper/less/effect-flip- стили, необходимые для модуля Flip Effectswiper/less/free-mode- стили, необходимые для модуля свободного режимаswiper/less/grid- стили, необходимые для модуля Gridswiper/less/hash-navigation- стили, необходимые для модуля навигации по хэшуswiper/less/history- стили, необходимые для модуля Историиswiper/less/keyboard- стили, необходимые для модуля клавиатурыswiper/less/manipulation- стили, необходимые для модуля манипулированияswiper/less/mousewheel- стили, необходимые для модуля Mousewheelswiper/less/navigation- стили, необходимые для навигационного модуляswiper/less/pagination- стили, необходимые для модуля разбивки на страницыswiper/less/parallax- стили, необходимые для модуля Parallaxswiper/less/scrollbar- стили, необходимые для модуля полосы прокруткиswiper/less/thumbs- стили, необходимые для модуля Thumbsswiper/less/virtual- стили, необходимые для виртуального модуляswiper/less/zoom- стили, необходимые для модуля масштабирования
Стили SCSS
Стили SCSS также являются отдельными стилями для основной версии и модулей (импортируемых пакетов):
swiper/scss- только основные стили Swiperswiper/scss/bundle— все стили Swiper, включая стили всех модулей (например, навигации, постраничной навигации и т. д.)swiper/scss/a11y- стили, необходимые для модуля A11yswiper/scss/autoplay- стили, необходимые для модуля автозапускаswiper/scss/controller- стили, необходимые для модуля контроллераswiper/scss/effect-cards- стили, необходимые для модуля Cards Effectswiper/scss/effect-coverflow- стили, необходимые для модуля Coverflow Effectswiper/scss/effect-creative- стили, необходимые для модуля Creative Effectswiper/scss/effect-cube- стили, необходимые для модуля Cube Effectswiper/scss/effect-fade- стили, необходимые для модуля эффекта затуханияswiper/scss/effect-flip- стили, необходимые для модуля Flip Effectswiper/scss/free-mode- стили, необходимые для модуля свободного режимаswiper/scss/grid- стили, необходимые для модуля Gridswiper/scss/hash-navigation- стили, необходимые для модуля навигации по хэшуswiper/scss/history- стили, необходимые для модуля Историиswiper/scss/keyboard- стили, необходимые для модуля клавиатурыswiper/scss/manipulation- стили, необходимые для модуля манипулированияswiper/scss/mousewheel- стили, необходимые для модуля Mousewheelswiper/scss/navigation- стили, необходимые для навигационного модуляswiper/scss/pagination- стили, необходимые для модуля разбивки на страницыswiper/scss/parallax- стили, необходимые для модуля Parallaxswiper/scss/scrollbar- стили, необходимые для модуля полосы прокруткиswiper/scss/thumbs- стили, необходимые для модуля Thumbsswiper/scss/virtual- стили, необходимые для виртуального модуляswiper/scss/zoom- стили, необходимые для модуля масштабирования
Инициализировать Swiper
Теперь, когда у нас есть HTML-код Swiper, нам нужно инициализировать его с помощью следующей функции:
новый Swiper (swiperContainer, параметры) - инициализирует swiper с помощью опций
- swiperContainer — HTMLElement или строка (с CSS-селектором) HTML-элемента контейнера свипера. Обязательно.
- параметры - объект - объект с параметрами Swiper. Необязательно.
- Метод возвращает инициализированный экземпляр Swiper
Например:
const swiper = new Swiper('.swiper', {
speed: 400,
spaceBetween: 100,
});
Послеинициализации Swiper можно получить доступ к экземпляру Swiper в его HTMLElement. Этоswiperсвойство HTML-элемента контейнера Swiper:
const swiper = document.querySelector('.swiper').swiper;
// Now you can use all slider methods like
swiper.slideNext();
Параметры
Давайте посмотрим на список всех доступных параметров:
| Имя | Тип | По умолчанию | Описание |
|---|---|---|---|
| a11y | Любой |
Объект с параметрами a11y или логический
|
|
| allowSlideNext | логическое значение | верно |
Установите значение |
| allowSlidePrev | логическое значение | верно |
Установите значение |
| Разрешить касание | логическое значение | верно |
Если |
| Автоматический рост | логическое значение | ложь |
Задайте значение |
| автоматическое воспроизведение | Любой |
Объект с параметрами автозапуска или логическим значением
|
|
| точки останова | объект |
Позволяет задавать разные параметры для разных точек останова (размеров экрана). Не все параметры можно изменить в точках останова, только те, которые не требуют другого макета и логики, например
|
|
| База контрольных точек | «контейнер»|«окно» | "окно" |
База для точек останова (бета-версия). Может быть |
| Эффект карты | Любой |
Объект с картами-параметры эффекта
|
|
| Центрирующие оползни | логическое значение | ложь |
Если этот параметр включен, слайды центрируются, если количество слайдов меньше |
| центрироВанные оползни | логическое значение | ложь |
Если |
| Центрированные скользящие границы | логическое значение | ложь |
Если |
| containerModifierClass | строка | "swiper-" |
Начало CSS-класса модификатора, который можно добавить в контейнер Swiper в зависимости от различных параметров |
| контроллер | Любой |
Объект с параметрами контроллера или логическим значением
|
|
| Эффект coverflowEffect | Любой |
Объект с параметрами эффекта Coverflow.
|
|
| createElements | логическое значение | ложь |
При включении Swiper автоматически обернет слайды элементом swiper-wrapper и создаст необходимые элементы для навигации, разбивки на страницы и полосы прокрутки, если они включены (с соответствующим объектом параметров или с логическим значением |
| Творческий эффект | Любой |
Объект с параметрами креативного эффекта
|
|
| cssMode | логическое значение | ложь |
При включении он будет использовать современный CSS Scroll Snap API. Он поддерживает не все функции Swiper, но потенциально может значительно повысить производительность в простых конфигурациях. Это то, что не поддерживается, когда оно включено:
Если вы используете его с другими эффектами, особенно с 3D-эффектами, необходимо обернуть содержимое слайда элементом
|
| Эффект куба | Любой |
Объект с параметрами кубического эффекта
|
|
| направление | «по горизонтали»|«по вертикали» | "горизонтальный" |
Может быть |
| Обнаружение кромки | строка|логическое значение | ложь |
Включите события Swiper для работы с возвратом свайпом в приложении. Если установлено значение |
| edgeSwipeThreshold | номер | 20 |
Область (в пикселях) от левого края экрана для отпускания сенсорных событий при свайпе назад в приложении |
| эффект | строка | "слайд" |
Эффект перехода. Может быть |
| включен | логическое значение | верно |
Независимо от того, был ли Swiper изначально включен. Если Swiper отключен, он скроет все элементы навигации и не будет реагировать на какие-либо события и взаимодействия |
| eventsPrefix | строка | `swiper` |
Префикс имени события для всех событий DOM, генерируемых элементом Swiper (веб-компонентом) |
| Эффект затухания | Любой |
Объект с параметрами эффекта затухания
|
|
| flipEffect | Любой |
Объект с параметрами эффекта переворота
|
|
| Фокусируемые элементы | строка | «ввод, выбор, опция, текстовое поле, кнопка, видео, метка» |
Селектор CSS для элементов, на которые можно навести курсор. Свайпинг будет отключен для таких элементов, если они «наведены» |
| followFinger | логическое значение | верно |
Если функция отключена, то ползунок будет анимироваться только при отпускании, он не будет двигаться, пока вы удерживаете на нём палец |
| Бесплатный режим | Любой |
Включает функции бесплатного режима. Объект с параметрами бесплатного режима или логическое значение
|
|
| grabCursor | логическое значение | ложь |
Эта опция может немного улучшить удобство использования Swiper на компьютере. Если |
| сетка | Любой |
Объект с параметрами сетки для включения ползунка «многострочный».
|
|
| Хэшнавигация | Любой |
Включает навигацию по хэш-ссылкам для слайдов. Объект с параметрами хэш-навигации или логическое значение
|
|
| высота | нулевой|номер | null |
Высота Swiper (в пикселях). Параметр позволяет задать высоту Swiper. Полезно только в том случае, если вы инициализируете Swiper, когда он скрыт, а также в средах SSR и Test для правильной инициализации Swiper
|
| история | Любой |
Включает функцию сохранения состояния истории, при которой у каждого слайда будет свой URL-адрес. В этом параметре необходимо указать URL-адрес основного слайда, например Объект с параметрами навигации по истории или логическим значением
|
|
| инициализация | логическое значение | верно |
Следует ли инициализировать Swiper автоматически при создании экземпляра. Если эта функция отключена, то вам нужно инициализировать Swiper вручную, вызвав |
| initialSlide | номер | 0 |
Порядковый номер начального слайда. |
| Инжектные стили | строка[] |
Внедрите стили текста в теневой DOM. Только для использования с элементом Swiper |
|
| injectStylesUrls | строка[] |
Внедрите стили |
|
| клавиатура | Любой |
Позволяет перемещаться по слайдам с помощью клавиатуры. Объект с параметрами клавиатуры или логическое значение
|
|
| lazyPreloadPrevNext | номер | 0 |
Количество следующих и предыдущих слайдов для предварительной загрузки. Применимо только при использовании отложенной загрузки. |
| Класс lazyPreloaderClass | строка | "swiper-ленивый предварительный загрузчик" |
Имя CSS-класса ленивого предварительного загрузчика |
| Длинные наконечники | логическое значение | верно |
Установите значение |
| longSwipesMs | номер | 300 |
Минимальная продолжительность (в миллисекундах) для перехода к следующему/предыдущему слайду при длительном смахивании |
| Стратегия длинных свайпов | номер | 0.5 |
Соотношение для перехода к следующему / предыдущему слайду при длительном пролистывании |
| цикл | логическое значение | ложь |
Установите значение Из-за особенностей работы режима цикла (он меняет порядок слайдов) общее количество слайдов должно быть:
|
| loopAddBlankSlides | логическое значение | верно |
Автоматически добавляет пустые слайды, если вы используете сетку или |
| loopAdditionalSlides | номер | 0 |
Позволяет увеличить количество закольцованных слайдов |
| loopPreventsSliding | логическое значение | верно |
Если эта функция включена, то кнопки «Далее» и «Назад» не будут работать, пока слайдер анимируется в режиме цикла |
| maxBackfaceHiddenSlides | номер | 10 |
Если общее количество слайдов меньше указанного здесь значения, то Swiper включит
|
| модули | любой[] |
Массив с модулями Swiper
|
|
| колесо мыши | Любой |
Позволяет перемещаться по слайдам с помощью колёсика мыши. Объект с параметрами колёсика мыши или логическое значение
|
|
| навигация | Любой |
Объект с параметрами навигации или логическим значением
|
|
| вложенный | логическое значение | ложь |
Установите |
| Промывка носа | логическое значение | верно |
Включать / отключать прокрутку элементов, соответствующих классу, указанному в |
| noSwipingClass | строка | "swiper-без пролистывания" |
Укажите |
| noSwipingSelector | строка |
Может использоваться вместо |
|
| normalizeSlideIndex | логическое значение | верно |
Нормализует индекс слайда. |
| Наблюдаем за родителями | логическое значение | ложь |
Установите значение |
| Наблюдает за детьми | логическое значение | ложь |
Установите значение |
| наблюдатель | логическое значение | ложь |
Задайте значение |
| вкл . | объект |
Регистрация обработчиков событий |
|
| На любом | функция(обработчик) |
Добавьте прослушиватель событий, который будет запускаться при всех событиях
|
|
| oneWayMovement | логическое значение | ложь |
Если эта функция включена, слайды будут прокручиваться только вперёд (в одну сторону) независимо от направления прокрутки |
| разбивка на страницы | Любой |
Объект с параметрами разбивки на страницы или логическим значением
|
|
| параллакс | Любой |
Объект с параметрами параллакса или boolean
|
|
| Пассивные прослушиватели | логическое значение | верно |
По умолчанию для повышения производительности прокрутки на мобильных устройствах будут использоваться пассивные слушатели событий. Но если вам нужно использовать |
| Предотвращение щелчков | логическое значение | верно |
Установите значение |
| Предотвращение распространения Clicksprop | логическое значение | верно |
Установите значение |
| Предотвращение взаимодействия при переходе | логическое значение | ложь |
Если эта функция включена, она не позволит менять слайды с помощью свайпа или кнопок навигации/пагинации во время перехода |
| сопротивление | логическое значение | верно |
Установите значение |
| Сопротивление | номер | 0.85 |
Эта опция позволяет вам контролировать коэффициент сопротивления |
| Сервер изменения размера | логическое значение | верно |
Если эта функция включена, она будет использовать ResizeObserver (если поддерживается браузером) для контейнера Swiper, чтобы определять изменение размера контейнера (вместо отслеживания изменения размера окна) |
| перемотка назад | логическое значение | ложь |
Установите значение
|
| Длина круга | логическое значение | ложь |
Задайте |
| runCallbacksOnInit | логическое значение | верно |
При инициализации свипера запускаются события Transition/SlideChange/Start/End. Такие события будут запускаться при инициализации, если ваш initialSlide не равен 0 или вы используете режим цикла |
| полоса прокрутки | Любой |
Объект с параметрами полосы прокрутки или логическим значением
|
|
| setWrapperSize | логическое значение | ложь |
Если вы включите эту опцию, плагин установит ширину/высоту оболочки Swiper, равную общему размеру всех слайдов. В основном эту опцию следует использовать в качестве запасного варианта совместимости для браузеров, которые плохо поддерживают макет flexbox |
| Короткие замахи | логическое значение | верно |
Установите значение |
| simulateTouch | логическое значение | верно |
Если |
| slideActiveClass | строка | "swiper-slide-активный" |
Имя CSS-класса текущего активного слайда
|
| slideBlankClass | строка | "swiper-slide-пустой" |
Имя CSS-класса пустого слайда, добавляемого в режиме цикла (при включении
|
| slideClass | строка | "swiper-слайд" |
Имя CSS-класса слайда
|
| slideFullyVisibleClass | строка | "swiper-слайд-полностью-виден" |
Имя CSS-класса для полностью (когда весь слайд находится в области просмотра) видимого слайда
|
| slideNextClass | строка | "swiper-slide-next" |
Имя CSS-класса слайда, которое находится сразу после текущего активного слайда
|
| slidePrevClass | строка | 'swiper-slide-предыдущий' |
CSS-класс slide, который находится прямо перед текущим активным слайдом
|
| slideToClickedSlide | логическое значение | ложь |
Установите значение |
| slideVisibleClass | строка | "видимый слайд swiper" |
Имя CSS-класса текущего / частично видимого слайда
|
| slidesoffset после | номер | 0 |
Добавьте (в пикселях) дополнительное смещение слайда в конце контейнера (после всех слайдов) |
| slidesOffsetBefore | номер | 0 |
Добавьте (в пикселях) дополнительное смещение слайда в начале контейнера (перед всеми слайдами) |
| slidesPerGroup | номер | 1 |
Задайте количество слайдов для определения и включения группового скольжения. Полезно использовать с slidesPerView > 1 |
| slidesPerGroupAuto | логическое значение | ложь |
Этот параметр предназначен для использования только с |
| slidesPerGroupSkip | номер | 0 |
Параметр работает следующим образом: Если Если |
| Просмотр слайдов | номер|"авто" | 1 |
Количество слайдов на один просмотр (количество слайдов, одновременно отображаемых в контейнере слайдера).
|
| Расстояние между | строка|номер | 0 |
Расстояние между слайдами в пикселях.
|
| Скорость | номер | 300 |
Продолжительность перехода между слайдами (в мс) |
| Манипулятор прокрутки | Любой | null |
Строка с CSS-селектором или HTML-элементом контейнера с разбивкой на страницы, которая будет работать как единственный доступный обработчик для прокрутки |
| swiperElementNodeName | строка | "SWIPER-КОНТЕЙНЕР" |
Имя узла элемента swiper; используется для определения рендеринга веб-компонента |
| пороговое значение | номер | 5 |
Пороговое значение в пикселях. Если «расстояние касания» будет меньше этого значения, то свиппер не будет перемещаться |
| большие пальцы | Любой |
Объект с параметрами компонента thumbs
|
|
| Touchangle'а | номер | 45 |
Допустимый угол (в градусах) для запуска сенсорного перемещения |
| touchEventsTarget | 'контейнер'|'обёртка' | "оболочка" |
Целевой элемент для прослушивания событий касания. Может быть |
| touchMoveStopPropagation | логическое значение | ложь |
Если эта функция включена, то распространение события «касание» будет остановлено |
| Сенсорное управЛение | номер | 1 |
Коэффициент соприкосновения |
| touchReleaseOnEdges | логическое значение | ложь |
Включите отработку событий касания в крайних положениях ползунка (начало, конец), чтобы обеспечить дальнейшую прокрутку страницы. Эта функция работает только с событиями касания (а не с событиями указателя), поэтому она будет работать на устройствах iOS/Android и не будет работать на устройствах Windows с событиями указателя. Также |
| touchStartForcePreventDefault | логическое значение | ложь |
Принудительно всегда предотвращать событие по умолчанию для |
| touchStartPreventDefault | логическое значение | верно |
Если он отключен, |
| Уникальные возможности | логическое значение | верно |
Если включено (по умолчанию) и параметры элементов навигации передаются в виде строки (например, |
| Обновите размер окна | логическое значение | верно |
Swiper будет пересчитывать положение слайдов при изменении размера окна (ориентации) |
| url | нулевая|строка | null |
Требуется для активного обнаружения слайдов при рендеринге на стороне сервера и включенной истории |
| Пользовательский агент | нулевая|строка | null |
строка userAgent. Требуется для определения браузера/устройства при рендеринге на стороне сервера |
| виртуальный | Любой |
Включает функцию виртуальных слайдов. Объект с параметрами виртуальных слайдов или логическое значение
|
|
| Виртуальный перевод | логическое значение | ложь |
Если вы включите эту опцию, слайдер будет работать как обычно, за исключением того, что он не будет перемещаться, а значения реального перемещения на обёртке не будут заданы. Полезно, если вам нужно создать собственный переход слайдов |
| watchOverflow | логическое значение | верно |
При включении Swiper будет отключён и скроет кнопки навигации, если для скольжения недостаточно слайдов. |
| watchSlidesProgress | логическое значение | ложь |
Включите эту функцию, чтобы рассчитать прогресс и видимость каждого слайда (слайды в области просмотра будут иметь дополнительный класс видимости) |
| ширина | нулевой|номер | null |
Ширина Swiper (в пикселях). Параметр позволяет задать ширину Swiper. Полезно только в том случае, если вы инициализируете Swiper, когда он скрыт, а также в средах SSR и Test для правильной инициализации Swiper
|
| КЛАСС -оболочка | строка | "swiper-оболочка" |
Имя CSS-класса оболочки слайдов
|
| масштабирование | Любой |
Включает функцию масштабирования. Объект с параметрами масштабирования или логическое значение
|
Методы и свойства
После инициализации Slider мы получаем его инициализированный экземпляр в переменной (например, переменнаяswiperв приведённом выше примере) с полезными методами и свойствами:
Мероприятия
Swiper содержит множество полезных событий, которые вы можете прослушать. События можно назначать двумя способами:
-
Использование
onпараметра при инициализации swiper:const swiper = new Swiper('.swiper', { // ... on: { init: function () { console.log('swiper initialized'); }, }, }); -
Использование
onметода после инициализации swiper.const swiper = new Swiper('.swiper', { // ... }); swiper.on('slideChange', function () { console.log('slide changed'); });
thisключевое слово в обработчике событий всегда указывает на экземпляр Swiper| Имя | Аргументы | Описание |
|---|---|---|
| activeIndexChange | (swiper) |
Событие будет срабатывать при активном изменении индекса |
| afterInit | (swiper) |
Событие будет запущено сразу после инициализации |
| beforeDestroy | (swiper) |
Событие будет запущено непосредственно перед уничтожением Swiper |
| Перед запуском | (swiper) |
Событие будет запущено непосредственно перед инициализацией |
| beforeLoopFix | (swiper) |
Событие будет запущено непосредственно перед "исправлением цикла" |
| Перед обработкой | (swiper) |
Событие будет запущено перед обработчиком изменения размера |
| beforeSlideChangeStart | (swiper) |
Событие будет запущено до начала перехода к смене слайда |
| Перед началом перехода | (swiper, скорость, внутренний) |
Событие будет запущено до начала перехода |
| точка останова | (swiper, параметры точки останова) |
Событие будет запущено при изменении точки останова |
| Измененное направление | (swiper) |
Событие будет запущено при изменении направления |
| нажмите | (swiper, событие) |
Событие будет запущено, когда пользователь нажмёт/коснётся Swiper. Получает |
| уничтожить | (swiper) |
Событие будет запущено при уничтожении swiper |
| Двойной щелчок | (swiper, событие) |
Событие будет запущено, когда пользователь дважды щелкнет по Swiper |
| Двойной щелчок | (swiper, событие) |
Событие будет запущено, когда пользователь дважды коснётся контейнера Swiper. Получает |
| fromEdge | (swiper) |
Событие будет запущено, когда Swiper перейдет из начальной или конечной позиции |
| инициализация | (swiper) |
Сработал сразу после инициализации Swiper.
|
| блокировка | (swiper) |
Событие будет запущено, когда swiper заблокирован (когда |
| Исправление цикла | (swiper) |
Событие будет запущено после "исправления цикла" |
| Мгновенный скачок | (swiper) |
Событие будет запущено при отскоке импульса |
| Обновление наблюдения | (swiper) |
Событие будет запущено, если observer включен и он обнаруживает мутации DOM |
| изменение ориентации | (swiper) |
Событие будет запущено при изменении ориентации (например, альбомная -> портретная) |
| прогресс | (swiper, прогресс) |
Событие будет запущено при изменении прогресса Swiper. В качестве аргументов оно получает прогресс, который всегда находится в диапазоне от 0 до 1 |
| Начало работы | (swiper) |
Событие будет запущено, когда Swiper достигнет своего начала (начальной позиции) |
| reachEnd | (swiper) |
Событие будет запущено, когда Swiper достигнет последнего слайда |
| Реальный обмен данными | (swiper) |
Событие будет запущено при реальном изменении индекса |
| изменение размера | (swiper) |
Событие будет запущено при изменении размера окна непосредственно перед обработкой Swiper onresize |
| setTransition | (swiper, переход) |
Событие будет срабатывать каждый раз, когда свиппер запускает анимацию. Получает в качестве аргумента текущую продолжительность перехода (в миллисекундах) |
| setTranslate | (swiper, перевести) |
Событие будет запущено, когда обёртка Swiper изменит своё положение. Получает текущее значение перевода в качестве аргумента |
| Изменение слайдов | (swiper) |
Событие будет запущено при изменении текущего активного слайда |
| slideChangeTransitionEnd | (swiper) |
Событие будет запущено после анимации другого слайда (следующего или предыдущего). |
| slideChangeTransitionStart | (swiper) |
Событие будет запущено в начале перехода на другой слайд (следующий или предыдущий). |
| slideNextTransitionEnd | (swiper) |
То же, что и «slideChangeTransitionEnd», но только для направления «вперёд» |
| slideNextTransitionStart | (swiper) |
То же, что и «slideChangeTransitionStart», но только для направления «вперёд» |
| slidePrevTransitionEnd | (swiper) |
То же, что и «slideChangeTransitionEnd», но только для «обратного» направления |
| slidePrevTransitionStart | (swiper) |
То же, что и «slideChangeTransitionStart», но только в направлении «назад» |
| slideResetTransitionEnd | (swiper) |
Событие будет запущено в конце анимации при переходе на следующий слайд |
| slideResetTransitionStart | (swiper) |
Событие будет запущено в начале анимации перехода на текущий слайд |
| sliderFirstMove | (swiper, событие) |
Событие будет запущено при первом касании / перетаскивании |
| sliderMove | (swiper, событие) |
Событие будет запущено, когда пользователь коснётся Swiper и проведёт по нему пальцем. Получает |
| slidesGridLengthChange | (swiper) |
Событие будет запущено при изменении сетки слайдов |
| Изменение длины слайда | (swiper) |
Событие будет запущено при изменении количества слайдов |
| Обновлено слайд-шоу | (swiper) |
Событие будет запущено после того, как слайды и их размеры будут рассчитаны и обновлены |
| snapGridLengthChange | (swiper) |
Событие будет запущено при изменении привязки сетки |
| snapIndexChange | (swiper) |
Событие будет запущено при изменении индекса привязки |
| нажмите | (swiper, событие) |
Событие будет запущено, когда пользователь нажмёт/коснётся Swiper. Получает |
| toEdge | (swiper) |
Событие будет запущено, когда Swiper перейдет в начальную или конечную позицию |
| touchEnd | (swiper, событие) |
Событие будет запущено, когда пользователь отпустит Swiper. Получает |
| touchMove | (swiper, событие) |
Событие будет запущено, когда пользователь коснётся Swiper и проведёт по нему пальцем. Получает |
| touchMoveOpposite | (swiper, событие) |
Событие будет запущено, когда пользователь коснётся Swiper и проведёт пальцем в направлении, противоположном параметру направления. Получает |
| Сенсорный запуск | (swiper, событие) |
Событие будет запущено, когда пользователь коснётся Swiper. Получает |
| Завершение перехода | (swiper) |
Событие будет запущено после перехода. |
| Начало перехода | (swiper) |
Событие будет запущено в начале перехода. |
| разблокировать | (swiper) |
Событие будет запущено, когда swiper будет разблокирован (когда |
| Обновить | (swiper) |
Событие будет запущено после вызова swiper.update() |
Модули
Параметры навигации
Методы навигации
Навигационные события
Пользовательские свойства CSS Навигации
{
--swiper-navigation-size: 44px;
--swiper-navigation-top-offset: 50%;
--swiper-navigation-sides-offset: 10px;
--swiper-navigation-color: var(--swiper-theme-color);
}
Параметры разбивки на страницы
Методы разбивки на страницы
События разбивки на страницы
Пользовательские свойства CSS Разбиения на страницы
{
--swiper-pagination-color: var(--swiper-theme-color);
--swiper-pagination-left: auto;
--swiper-pagination-right: 8px;
--swiper-pagination-bottom: 8px;
--swiper-pagination-top: auto;
--swiper-pagination-fraction-color: inherit;
--swiper-pagination-progressbar-bg-color: rgba(0, 0, 0, 0.25);
--swiper-pagination-progressbar-size: 4px;
--swiper-pagination-bullet-size: 8px;
--swiper-pagination-bullet-width: 8px;
--swiper-pagination-bullet-height: 8px;
--swiper-pagination-bullet-inactive-color: #000;
--swiper-pagination-bullet-inactive-opacity: 0.2;
--swiper-pagination-bullet-opacity: 1;
--swiper-pagination-bullet-horizontal-gap: 4px;
--swiper-pagination-bullet-vertical-gap: 6px;
}
Параметры полосы прокрутки
Методы полосы прокрутки
События полосы прокрутки
Пользовательские свойства CSS полосы прокрутки
{
--swiper-scrollbar-border-radius: 10px;
--swiper-scrollbar-top: auto;
--swiper-scrollbar-bottom: 4px;
--swiper-scrollbar-left: auto;
--swiper-scrollbar-right: 4px;
--swiper-scrollbar-sides-offset: 1%;
--swiper-scrollbar-bg-color: rgba(0, 0, 0, 0.1);
--swiper-scrollbar-drag-bg-color: rgba(0, 0, 0, 0.5);
--swiper-scrollbar-size: 4px;
}
Параметры автозапуска
Методы автозапуска
Автоматическое воспроизведение событий
Параметры свободного режима
Параметры сетки
Модуль манипуляций добавляет полезные методы Swiper для управления слайдами. Его имеет смысл использовать только с версией Swiper Core, он не предназначен для использования с Swiper React или Vue.
Методы манипулирования
Swiper поддерживает эффекты перехода с эффектом параллакса для вложенных элементов swiper/slides. Поддерживаются два типа элементов с эффектом параллакса:
- Прямые дочерние элементы
swiper. Эффект параллакса для таких элементов будет зависеть от общего положения ползунка. Полезно для параллакс-фонов - Вложенные элементы слайдов. Эффект параллакса для таких элементов будет зависеть от хода слайда
Чтобы включить эффект параллакса, необходимо инициализировать Swiper с помощью переданного параметраparallax:trueи добавить один из следующих (или их сочетание) атрибутов к нужным элементам:
data-swiper-parallax- включить преобразование-перевод параллаксного перехода. Этот атрибут может принимать:number- значение в пикселях (как для заголовка, подзаголовка в примере выше) для перемещения элемента в зависимости от прогресса. В этом случае такой элемент будет перемещён на ± это значение в пикселях в зависимости от положения слайда (следующий или предыдущий)percentage- (как для «параллакс-фона») для перемещения элемента в зависимости от прогресса и его размера. В этом случае такой элемент будет перемещён на ± этот процент от его размера (ширины в горизонтальном направлении и высоты в вертикальном направлении) в зависимости от положения слайда (следующий или предыдущий). Таким образом, если ширина элемента составляет 400 пикселей, а вы указали data-swiper-parallax = «50%», то он будет перемещён на ± 200 пикселей
data-swiper-parallax-xто же самое, но для направления по оси xdata-swiper-parallax-yто же самое, но для направления по оси ydata-swiper-parallax-scale— коэффициент масштабирования элемента параллакса, когда он находится в «неактивном» (не на активном слайде) состоянииdata-swiper-parallax-opacity— непрозрачность элемента параллакса, когда он находится в «неактивном» (не на активном слайде) состоянииdata-swiper-parallax-duration- настраиваемая продолжительность перехода для элементов parallax
<div class="swiper">
<!-- Parallax background element -->
<div
class="parallax-bg"
style="background-image:url(path/to/image.jpg)"
data-swiper-parallax="-23%"
></div>
<div class="swiper-wrapper">
<div class="swiper-slide">
<!-- Each slide has parallax title -->
<div class="title" data-swiper-parallax="-100">Slide 1</div>
<!-- Parallax subtitle -->
<div class="subtitle" data-swiper-parallax="-200">Subtitle</div>
<!-- And parallax text with custom transition duration -->
<div
class="text"
data-swiper-parallax="-300"
data-swiper-parallax-duration="600"
>
<p>Lorem ipsum dolor sit amet, ...</p>
</div>
<!-- Opacity parallax -->
<div data-swiper-parallax-opacity="0.5">I will change opacity</div>
<!-- Scale parallax -->
<div data-swiper-parallax-scale="0.15">I will change scale</div>
</div>
...
</div>
</div>
Параметры Параллакса
| Имя | Тип | По умолчанию | Описание |
|---|---|---|---|
| включен | логическое значение | ложь |
Включите, если вы хотите использовать «параллаксовые» элементы внутри слайдера |
Начиная с версии 9 у Swiper нет специального API для отложенной загрузки, так как он полагается на встроенную функцию отложенной загрузки браузера. Чтобы использовать отложенную загрузку, нам нужно просто установитьloading="lazy"для изображений и добавить элемент предварительной загрузки:
<div class="swiper">
<div class="swiper-wrapper">
<!-- Lazy image -->
<div class="swiper-slide">
<img src="path/to/picture-1.jpg" loading="lazy" />
<div class="swiper-lazy-preloader"></div>
</div>
<!-- Lazy image with srcset -->
<div class="swiper-slide">
<img
src="path/to/logo-small.png"
srcset="path/to/logo-large.png 2x"
loading="lazy"
/>
<div class="swiper-lazy-preloader"></div>
</div>
</div>
</div>
Как вы видите:
- Ленивое изображение должно иметь
loading="lazy"атрибут - Добавьте на слайд анимированный индикатор загрузки, который будет удалён автоматически после загрузки изображения:
<div class="swiper-lazy-preloader"></div>
Или белый для темного макета:
<div class="swiper-lazy-preloader swiper-lazy-preloader-white"></div>
Чтобы это сработало, убедитесь, что параметрeffectустановлен на'fade'
crossFadeследует заменить наtrue, чтобы не видеть содержимое позади или под ним.Параметры эффекта затухания
| Имя | Тип | По умолчанию | Описание |
|---|---|---|---|
| Перекрестное затухание | логическое значение | ложь |
Позволяет слайдам перекрестно исчезать |
Чтобы это сработало, убедитесь, что параметрeffectустановлен на'coverflow'
Параметры эффекта Coverflow
Чтобы это сработало, убедитесь, что параметрeffectустановлен на'flip'
Параметры эффекта переворота
| Имя | Тип | По умолчанию | Описание |
|---|---|---|---|
| Ограничение скорости | логическое значение | верно |
Ограничение вращения краевых слайдов |
| Тени для слайдов | логическое значение | верно |
Позволяет создавать тени на слайдах |
Чтобы это сработало, убедитесь, что параметрeffectустановлен на'cube'
Параметры эффекта куба
Чтобы это сработало, убедитесь, что параметрeffectустановлен на'cards'
Параметры эффекта карт
Чтобы это сработало, убедитесь, что параметрeffectустановлен на'creative'
Параметры креативного эффекта
В дополнение к компонентуControllerSwiper поставляется с компонентом Thumbs, который предназначен для более корректной работы с дополнительным свайпером Thumbs, чем компонент Controller, используемый для синхронизации двух свайперов.
Параметры Thumbs
Методы Thumbs
| Свойства | ||
|---|---|---|
| swiper.swiper | Любой |
Swiper экземпляр thumbs swiper |
| Методы | ||
| swiper.init() |
Инициализировать большие пальцы |
|
| swiper.обновление (начальное) |
Обновите thumbs |
|
Swiper поддерживает функцию масштабирования изображений (аналогичную той, что вы видите в iOS при просмотре одной фотографии), когда вы можете увеличить изображение с помощью жеста сжатия или уменьшить/увеличить его двойным нажатием. В этом случае требуется дополнительная настройка:
<div class="swiper">
<div class="swiper-wrapper">
<div class="swiper-slide">
<div class="swiper-zoom-container">
<img src="path/to/image1.jpg" />
</div>
</div>
<div class="swiper-slide">
<div class="swiper-zoom-container">
<img src="path/to/image2.jpg" />
</div>
</div>
<div class="swiper-slide">Plain slide with text</div>
<div class="swiper-slide">
<!-- Override maxRatio parameter -->
<div class="swiper-zoom-container" data-swiper-zoom="5">
<img src="path/to/image1.jpg" />
</div>
</div>
</div>
</div>
- Все изображения, которые можно увеличивать, должны быть заключены в элемент div с классом
swiper-zoom-container. - По умолчанию предполагается, что вы увеличиваете масштаб одного из элементов
img,pictureилиcanvas. Если вы хотите увеличить масштаб какого-то другого пользовательского элемента, просто добавьте к нему классswiper-zoom-target. Например:<div class="swiper"> <div class="swiper-wrapper"> <div class="swiper-slide"> <div class="swiper-zoom-container"> <!-- custom zoomable element --> <div class="swiper-zoom-target" style="background-image: url(...)" ></div> </div> </div> </div> </div> - Вы можете переопределить параметр
maxRatioдля конкретных слайдов, используя атрибутdata-swiper-zoomв контейнере масштабирования.
Параметры масштабирования
Методы масштабирования
Масштабирование событий
| Имя | Аргументы | Описание |
|---|---|---|
| Изменение масштаба | (swiper, масштабирование, imageEl, slideEl) |
Событие будет запущено при изменении масштаба |
Параметры управления клавиатурой
Методы управления клавиатурой
| Свойства | ||
|---|---|---|
| swiper.включен | логическое значение |
Включено ли управление с клавиатуры |
| Методы | ||
| swiper.отключить() |
Отключить управление с клавиатуры |
|
| swiper.enable() |
Включить управление с клавиатуры |
|
События клавиатуры
| Имя | Аргументы | Описание |
|---|---|---|
| Нажатие клавиши | (swiper, ключевой код) |
Событие будет запущено при нажатии клавиши |
Параметры управления колесиком мыши
Методы управления колесиком мыши
| Свойства | ||
|---|---|---|
| swiper.включен | логическое значение |
Включено ли управление колесиком мыши |
| Методы | ||
| swiper.отключить() |
Отключить управление колесиком мыши |
|
| swiper.enable() |
Включить управление колесиком мыши |
|
События Колеса мыши
Модуль «Виртуальные слайды» позволяет хранить в DOM только необходимое количество слайдов. Это очень полезно с точки зрения производительности и проблем с памятью, если у вас много слайдов, особенно слайдов с тяжёлым деревом DOM или изображениями.
slidesPerView: 'auto'Параметры виртуальных слайдов
Методы виртуальных слайдов
Виртуальные слайды Dom
Начиная с версии 9, виртуальные слайды Swiper могут работать со слайдами, изначально отображаемыми в DOM. При инициализации они удаляются из DOM, кэша, а затем повторно используются те, которые необходимы:
<div class="swiper">
<div class="swiper-wrapper">
<div class="swiper-slide">Slide 1</div>
<div class="swiper-slide">Slide 2</div>
...
<div class="swiper-slide">Slide 100</div>
</div>
</div>
<script>
const swiper = new Swiper('.swiper', {
virtual: {
enabled: true,
},
});
</script>
Хэш-навигация предназначена для создания ссылки на конкретный слайд, которая позволяет загрузить страницу с открытым конкретным слайдом.
Чтобы это работало, вам нужно включить его, передав параметрhashNavigation:trueи добавив хэши слайдов в атрибутdata-hash:
<div class="swiper">
<div class="swiper-wrapper">
<div class="swiper-slide" data-hash="slide1">Slide 1</div>
<div class="swiper-slide" data-hash="slide2">Slide 2</div>
<div class="swiper-slide" data-hash="slide3">Slide 3</div>
<div class="swiper-slide" data-hash="slide4">Slide 4</div>
<div class="swiper-slide" data-hash="slide5">Slide 5</div>
...
</div>
</div>
const swiper = new Swiper('.swiper', {
//enable hash navigation
hashNavigation: true,
});
Параметры хэш-навигации
Хэширование событий Навигации
| Имя | Аргументы | Описание |
|---|---|---|
| Хэш-обмен | (swiper) |
Событие будет запущено при изменении хэша окна |
| Набор хэшей | (swiper) |
Событие будет запущено, когда swiper обновит хэш |
История Параметров навигации
Параметры контроллера
Методы контроллера
| Свойства | ||
|---|---|---|
| swiper.control | Любой |
Передайте сюда другой экземпляр Swiper или массив с экземплярами Swiper, которыми должен управлять этот Swiper |
Параметры доступности
Пользовательская сборка
У вас есть два варианта создания пользовательской версии Swiper.
Использование модулей JS
Если вы используете в своём проекте сборщик с поддержкой модулей JS, вы можете импортировать только те модули, которые вам нужны:
// Import Swiper and modules
import Swiper from 'swiper';
import { Navigation, Pagination, Scrollbar } from 'swiper/modules';
// Now you can use Swiper
const swiper = new Swiper('.swiper', {
// Install modules
modules: [Navigation, Pagination, Scrollbar],
speed: 500,
navigation: {
nextEl: '.swiper-button-next',
prevEl: '.swiper-button-prev',
},
// ...
});
Экспортируются следующие модули:
Virtual- Модуль виртуальных слайдовKeyboard- Модуль управления клавиатуройMousewheel- Модуль управления колесиком мышиNavigation- Навигационный модульPagination- Модуль разбиения на страницыScrollbar- Модуль полосы прокруткиParallax- Модуль ПараллаксаFreeMode- Модуль Свободного режимаGrid- Модуль сеткиManipulation- Модуль управления слайдами (только для базовой версии)Zoom- Модуль масштабированияController- Модуль контроллераA11y- Модуль специальных возможностейHistory- Модуль навигации по историиHashNavigation- Модуль навигации по хэшуAutoplay- Модуль автозапускаEffectFade- Модуль эффекта затуханияEffectCube- Модуль эффекта кубаEffectFlip- Модуль эффекта переворотаEffectCoverflow- Модуль эффекта CoverflowEffectCards- Модуль эффектов картEffectCreative- Модуль создания креативных эффектовThumbs- Модуль Thumbs
Использование скрипта сборки
Swiper поставляется с конструктором gulp, который позволяет создавать пользовательские версии библиотек, включающие только необходимые модули. Нам нужно следующее:
-
Загрузите и распакуйтерепозиторий Swiper GitHubв локальную папку
-
Установить Node.js (если не установлен)
-
Теперь нам нужно установить необходимые зависимости. Перейдите в папку с загруженным и распакованным репозиторием Swiper и выполните в терминале:
$ npm install -
Открыть
scripts/build-config.jsфайл:module.exports = { // remove modules you don't need modules: [ 'virtual', 'keyboard', 'mousewheel', 'navigation', 'pagination', 'scrollbar', 'parallax', 'zoom', 'controller', 'a11y', 'history', 'hash-navigation', 'autoplay', 'thumbs', 'free-mode', 'grid', 'manipulation', 'effect-fade', 'effect-cube', 'effect-flip', 'effect-coverflow', 'effect-creative', 'effect-cards', ], }; -
Теперь мы готовы создать пользовательскую версию Swiper:
$ npm run build:prod -
Вот и всё. Сгенерированные файлы CSS и JS и их сжатые версии будут доступны в папке
dist/
Определения TypeScript
Swiper полностью типизирован, он экспортируетSwiperиSwiperOptionsтипы:
// main.ts
import Swiper from 'swiper';
import { SwiperOptions } from 'swiper/types';
const swiperParams: SwiperOptions = {
slidesPerView: 3,
spaceBetween: 50,
};
const swiper = new Swiper('.swiper', swiperParams);
Вы также можете просмотреть автоматически сгенерированныеопределения TypeScriptдля всех типов, параметров, свойств и методов.
WOW.js - Анимация при прокрутке страницы
<link rel="stylesheet" href="css/animate.min.css">
<script src="js/wow.min.js"></script>
<div class="wow bounceInUp">Здесь уже ваш контент, картинки и прочее</div>data-wow-duration: Изменение длительности анимации;
data-wow-delay: Задержка перед стартом анимации;
data-wow-offset: Дистанция от нижнего края браузера для начала анимации;
data-wow-iteration: Сколько раз повторять анимацию?
<section class="wow slideInLeft" data-wow-duration="2s" data-wow-delay="5s"></section>
<section class="wow slideInRight" data-wow-offset="10" data-wow-iteration="10"></section>
wow = new WOW({
boxClass: 'wow',
animateClass: 'animated',
offset: 0
});
WOW.init();
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>WOW</title>
<link rel="stylesheet" href="css/libs/animate.css">
<link rel="stylesheet" href="css/site.css">
<style>
.wow:first-child {
visibility: hidden;
}
</style>
<!--[if IE]>
<script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
</head>
<body>
<div id="container">
<header>
<h1>WOW.js</h1>
</header>
<div id="main">
<section class="wow fadeInDown" style="background-color: #f1c40f;"></section>
<section class="wow pulse" style="background-color: #e74c3c;" data-wow-iteration="infinite" data-wow-duration="1500ms"></section>
<section class="section--purple wow slideInRight" data-wow-delay="2s"></section>
<section class="section--blue wow bounceInLeft" data-wow-offset="300"></section>
<section class="section--green wow slideInLeft" data-wow-duration="4s"></section>
<button id="moar">LOAD MOAR!!</button>
</div>
</div>
<script src="dist/wow.js"></script>
<script>
wow = new WOW(
{
animateClass: 'animated',
offset: 100,
callback: function(box) {
console.log("WOW: animating <" + box.tagName.toLowerCase() + ">")
}
}
);
wow.init();
document.getElementById('moar').onclick = function() {
var section = document.createElement('section');
section.className = 'section--purple wow fadeInDown';
this.parentNode.insertBefore(section, this);
};
</script>
</body>
</html>
JavaScript / jQuery
Стили CSS
АНИМАЦИЯ AOS
Установка
Базовые модели
<link rel="stylesheet" href="https://unpkg.com/aos@next/dist/aos.css" /><script src="https://unpkg.com/aos@next/dist/aos.js"></script>
<script>
AOS.init();
</script>
Использование менеджеров пакетов
-
yarn add aos@next -
или
-
npm install --save aos@next
import AOS from 'aos';
import 'aos/dist/aos.css'; // You can also use <link> for styles
// ..
AOS.init();
Чтобы заставить ее работать, вам нужно убедиться, что в вашем процессе сборки настроен загрузчик стилей, и все это правильно. Однако, если вы используете Parcel, он будет работать из коробки, как предусмотрено.
Как ее использовать?
1. Инициализируйте AOS:
AOS.init();
// ниже перечислены настройки по умолчанию
// Вы также можете передать необязательный объект настроек;)(инициализация
AOS.init({
disable: false, // принимает следующие значения: 'телефон', 'планшет', 'мобильный', логическое значение, выражение или функция
startEvent: 'DOMContentLoaded', // имя события, отправленного в документе, которое AOS должен инициализировать в
initClassName: 'aos-init', // классприменяется после инициализации
animatedClassName: 'aos-animate', // класс, применяемый к анимации
useClassNames: false, // если true, добавит содержимое `data-aos` в качестве классов в scroll
disableMutationObserver: false, // отключает автоматическое обнаружение мутаций (дополнительно)
debounceDelay: 50, // задержка при отмене, используемая при изменении размера окна (дополнительно)
throttleDelay: 99, // задержка при дросселировании, используемая при прокрутке страницы (дополнительно)
// Настройки, которые можно переопределить для каждого элемента, с помощью `атрибуты data-aos-*`:
offset: 120, // смещение (в пикселях) от исходной точки
delay: 0, // значения от 0 до 3000, с шагом 50 мс
duration: 400, // значения от 0 до 3000, с шагом 50 мс
easing: 'ease', // ослабление анимации AOS по умолчанию
once: false, // должна ли анимация выполняться только один раз - при прокрутке вниз
mirror: false, // должны ли элементы анимироваться при прокрутке мимо них
anchorPlacement: 'top-bottom', // определяет, какое положение элемента относительно окна должно вызывать анимацию
});
2. Установите анимацию с помощью data-aos атрибута:
<div data-aos="fade-in"></div><div
data-aos="fade-up"
data-aos-offset="200"
data-aos-delay="50"
data-aos-duration="1000"
data-aos-easing="ease-in-out"
data-aos-mirror="true"
data-aos-once="false"
data-aos-anchor-placement="top-center"
>
</div>
Привязка
Существует также параметр, который можно использовать только для каждого элемента:
-
data-aos-anchor- элемент, смещение которого будет использоваться для запуска анимации вместо фактического.
<div data-aos="fade-up" data-aos-anchor=".other-element"></div>Таким образом, вы можете запускать анимацию для одного элемента, одновременно переходя к другому, что полезно при анимации фиксированных элементов.
API
-
init- инициализировать AOS
-
refresh- пересчитать все смещения и положения элементов (вызывается при изменении размера окна)
-
refreshHard- повторно инициализировать массив с элементами AOS и триггером refresh(вызывается при изменениях DOM, связанных с aosэлементами)
AOS.refresh();refreshметод вызывается при изменении размера окна и т. Д., Поскольку он не требует создания нового хранилища с элементами AOS и должен быть как можно более легким.
События JS
document.addEventListener('aos:in', ({ detail }) => {
console.log('animated in', detail);
});
document.addEventListener('aos:out', ({ detail }) => {
console.log('animated out', detail);
});
<div data-aos="fade-in" data-aos-id="super-duper"></div>-
aos:in:super-duper
-
aos:out:super-duper
Рецепты:
Добавление пользовательских анимаций:
[data-aos="new-animation"] {
opacity: 0;
transition-property: transform, opacity;
&.aos-animate {
opacity: 1;
}
@media screen and (min-width: 768px) {
transform: translateX(100px);
&.aos-animate {
transform: translateX(0);
}
}
}
<div data-aos="new-animation"></div>Элемент будет анимировать непрозрачность только на мобильных устройствах, но с шириной 768 пикселей он также будет перемещаться справа налево.
Добавление пользовательского упрощения:
[data-aos] {
body[data-aos-easing="new-easing"] &,
&[data-aos][data-aos-easing="new-easing"] {
transition-timing-function: cubic-bezier(.250, .250, .750, .750);
}
}
Настройка расстояния анимации по умолчанию
$aos-distance: 200px; // It has to be above import
@import 'node_modules/aos/src/sass/aos.scss';
Однако вам необходимо настроить процесс сборки, чтобы он мог импортировать стили node_modulesзаранее.
Интеграция внешней библиотеки анимации CSS (например, Animate.css):
<div data-aos="fadeInUp"></div>AOS.init({
useClassNames: true,
initClassName: false,
animatedClassName: 'animated',
});
Вышеупомянутый элемент получит два класса: animatedи fadeInUp. Используя различные комбинации трех вышеуказанных настроек, вы сможете интегрировать любую внешнюю библиотеку анимации CSS.
[data-aos] {
visibility: hidden;
}
[data-aos].animated {
visibility: visible;
}
Предостережения:
настройка:duration, delay
Длительность и задержка принимают значения от 50 до 3000 с шагом 50 мс, это потому, что они обрабатываются css, и чтобы не делать css длиннее, чем он уже есть, я реализовал только подмножество. Я считаю, что они должны охватывать большинство случаев.
body[data-aos-duration='4000'] [data-aos],
[data-aos][data-aos][data-aos-duration='4000'] {
transition-duration: 4000ms;
}
Этот код добавит длительность 4000 мс, доступную для установки в элементах AOS, или для установки в качестве глобальной продолжительности при инициализации сценария AOS. Обратите внимание, что double [data-aos][data-aos]- это не ошибка, это уловка, чтобы сделать индивидуальные настройки более важными, чем глобальные, без необходимости писать там уродливое "!важно" :)
<div data-aos="fade-in" data-aos-duration="4000"></div>Предопределенные параметры
Анимация
-
Fade animations:
-
fade
-
fade-up
-
fade-down
-
fade-left
-
fade-right
-
fade-up-right
-
fade-up-left
-
fade-down-right
-
fade-down-left
-
Flip animations:
-
flip-up
-
flip-down
-
flip-left
-
flip-right
-
Slide animations:
-
slide-up
-
slide-down
-
slide-left
-
slide-right
-
Zoom animations:
-
zoom-in
-
zoom-in-up
-
zoom-in-down
-
zoom-in-left
-
zoom-in-right
-
zoom-out
-
zoom-out-up
-
zoom-out-down
-
zoom-out-left
-
zoom-out-right
-
Anchor placements:
-
top-bottom
-
top-center
-
top-top
-
center-bottom
-
center-center
-
center-top
-
bottom-bottom
-
bottom-center
-
bottom-top
-
Easing functions:
-
linear
-
ease
-
ease-in
-
ease-out
-
ease-in-out
-
ease-in-back
-
ease-out-back
-
ease-in-out-back
-
ease-in-sine
-
ease-out-sine
-
ease-in-out-sine
-
ease-in-quad
-
ease-out-quad
-
ease-in-out-quad
-
ease-in-cubic
-
ease-out-cubic
-
ease-in-out-cubic
-
ease-in-quart
-
ease-out-quart
-
ease-in-out-quart
JavaScript / jQuery
Стили CSS
Правило @view-transition в CSS3
Правило @view-transition в CSS3 — это инструмент для создания плавных анимаций при переходе между разными HTML-страницами (в многостраничных приложениях, MPA). Оно работает в связке с View Transitions API — встроенным браузерным механизмом, который делает снимки DOM «до» и «после» обновления и анимирует переход между ними.
Как это работает
При навигации браузер фиксирует текущее состояние страницы, выполняет обновление DOM, затем фиксирует новое состояние и запускает CSS-анимацию, интерполируя между ними.
Ключевое условие для кросс-документных переходов: обе страницы (исходная и целевая) должны находиться на одном origin (совпадать по протоколу, домену и порту). Иначе переход не сработает.
Базовый синтаксис:
@view-transition {
navigation: auto;
}
navigation: auto;
— разрешает переход при навигации. Браузер по умолчанию применяет кроссфейд (затухание) между старой и новой страницей.
navigation: none;
— отключает плавные переходы (значение по умолчанию).
Важный нюанс: чтобы переход сработал, правило @view-transition
нужно добавить на обе страницы. Если правило есть только на одной, переход не произойдёт.
Кастомизация анимации
По умолчанию браузер сам решает, как анимировать переход (часто это кроссфейд). Но вы можете полностью переопределить анимацию, используя специальные псевдоэлементы и @keyframes
::view-transition-old(root)
— стили для элементов старой страницы (состояние «до» обновления).
::view-transition-new(root)
— стили для элементов новой страницы (состояние «после» обновления).
Пример:
/* Анимация, когда старая страница уходит */
::view-transition-old(root) {
animation: slideOut 0.3s ease-in-out both;
}
/* Анимация, когда появляется новая страница */
::view-transition-new(root) {
animation: slideIn 0.3s ease-in-out both;
}
/* Определение самих анимаций */
@keyframes slideOut {
to { transform: translateX(-100%); }
}
@keyframes slideIn {
from { transform: translateX(100%); }
}
Ещё один приём: можно дать общее имя перехода элементам, которые должны плавно перемещаться между страницами (например, общему изображению в карточке товара и на детальной странице). Для этого используется свойство view-transition-name
Поддержка браузерами
Правило @view-transition относится к CSS View Transitions Module Level 2, который поддерживает:
- Chrome 126+
- Edge 126+
- Safari 18.2+
В Firefox поддержка Level 2 пока в разработке.
Важное замечание: если браузер не поддерживает эту функцию, сайт продолжит работать в обычном режиме — @view-transition работает как прогрессивное улучшение.
Дополнительные возможности
Ограниченные переходы (Scoped Transitions). В Chrome 148+ появилась возможность ограничивать переход конкретным поддеревом DOM, а не всей страницей.
Учёт prefers-reduced-motion. Для доступности можно ограничить анимации для пользователей, которые предпочитают их отключать:
@media (prefers-reduced-motion: reduce) {
@view-transition {
navigation: none;
}
}
Вывод
@view-transition — мощный инструмент для создания плавных и выразительных переходов между страницами без необходимости писать много JavaScript. Главное — не забыть добавить это правило на обе стороны навигации и продумать анимации для общих элементов.
Стили CSS . Полностью рабочий пример
@media (prefers-reduced-motion: no-preference) {
@view-transition {
navigation: auto;
types: pixelate-dissolve;
}
}
html:active-view-transition-type(pixelate-dissolve)::view-transition-old(root) {
animation: pixelate-out 1.4s ease forwards;
}
html:active-view-transition-type(pixelate-dissolve)::view-transition-new(root) {
animation: pixelate-in 1.4s ease forwards;
}
@keyframes pixelate-out {
0% {
filter: blur(0px);
opacity: 1;
}
100% {
filter: blur(40px);
opacity: 0;
}
}
@keyframes pixelate-in {
0% {
filter: blur(40px);
opacity: 0;
}
100% {
filter: blur(0px);
opacity: 1;
}
}