Записи с меткой "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