100+ SEO-подсказок от Дэвида Максвини

Cписок из более чем 100 SEO-советов и практических рекомендаций. Они разделены на несколько блоков, которые охватывают различные аспекты поисковой оптимизации – от внутренних факторов ранжирования до поведения пользователей, наращивания ссылочной массы и многого другого.

Часть 1: Разметка и структура сайта

1. Убедитесь, что контент четко виден – контент должен быть в центре внимания на любой веб-странице. Как минимум, заголовок страницы должен находиться в первом экране, то есть виден посетителям без прокрутки.
2. Избегайте большого количества объявлений в верхней части страницы – до тех пор, пока медийная реклама является существенным источником дохода для многих сайтов, засилье объявлений в верхней части страницы может негативно влиять на ранжирование в поисковых системах. Убедитесь, что реклама на сайте ненавязчива и четко отличается от контента.
3. Создайте иерархию контента – хорошо проработанная иерархия помогает содержать контент в порядке и позволяет алгоритмам ранжирования быстро охватывать весь сайт, повышая в выдаче самые важные страницы.
4. Убедитесь, что навигация удобна – она должна быть продуманной и понятной и для поисковых систем, и для пользователей.
5. Закрывайте от индексации любые платные/партнерские ссылки – к ним должен быть добавлен атрибут rel="nofollow".
<a href="http://www.example.com/" rel="nofollow">платная ссылка</a>
6. Используйте SEO-дружественные URL-адреса – они должны быть читабельными и иметь логическую структуру. Короткие URL, которые включают в себя целевые ключевые слова (разделенные дефисами) считаются лучшими для SEO.
7. Убедитесь, что контактная информация четко видна – ее легко найти, и в идеале она должна включать фактический адрес.
8. Не пренебрегайте политикой конфиденциальности и разделом с информацией о компании – это основные страницы, которые помогают завоевать доверие пользователей и поисковых систем.
9. Минимизируйте текстовые штампы – сведите объем дублированного текста в разметке (а именно в боковых панелях) к минимуму.
10. Если ваша цель – продвижение в регионах, указывайте свой адрес в разметке – добавьте ваш фактический адрес и контактные данные на страницу, если для продвижения используются геозависимые запросы.
11. С www или без него – что бы вы ни выбрали, убедитесь, что ваш сайт открывается только одним способом. Для этого стоит настроить основной домен в Вебмастере. И не забудьте  настроить 301-редирект.

Часть 2: Подбор ключевых слов

12. Грамотно подбирайте ключевые слова – они продолжают быть важной частью SEO. Используйте планировщики ключевых слов или дополнительные инструменты, такие как Яндекс Вордстат, чтобы оценить объем запросов и выбрать ключевые слова, по которым вы будете продвигаться.
13. Выберите для каждой страницы одно основное ключевое слово, под которое она будет оптимизирована. Избегайте канибализации ключевых слов (оптимизации нескольких страниц под один запрос).
14. Учитывайте намерения пользователей – даже если ключевое слово имеет высокую частотность, всегда задавайте себе вопрос, будет ли тот, кто вбивает в поисковик эту фразу, заинтересован в вашем продукте/услуге.
15. Используйте скрипт массовой проверки конкуренции в Google – allintitle:"ваше ключевое слово". Он поможет узнать количество веб-страниц, в title которых содержится этот ключ в прямом вхождении.
16. Учитывайте «ранжируемость» ключевого слова и то, насколько хорошо видна органическая выдача. Здесь необходимо учитывать целый ряд факторов:
  • Насколько сильна конкуренция – показываются ли такие авторитетные сайты, как Amazon, Forbes и т.д.?
  • Сколько ссылок ведут на топовые сайты?
  • Сдвигается ли органическая выдача вниз энциклопедическими графами, новостями, рекламными объявлениями и т.д. (см. ниже)?
17. Воруйте ключевые слова у конкурентов – выясните, какие именно ключи формируют поисковый трафик вашим конкурентам, с помощью Ahrefs Positions Explorer.
18. Отслеживайте свой рейтинг – контролируйте позиции вашего сайта в результатах поиска по целевым ключевым словам. С Ahrefs Rank Tracker вы можете просматривать данные за разные периоды времени, чтобы отслеживать прогресс.
19. Следите за показателем кликабельности (CTR) – если ваша страница ранжируется по целевому ключу, CTR должен выглядеть вот так (зависимость трафика от позиции в выдаче):
Вы можете воспользоваться отчетом поисковой аналитики в Google Вебмастере, чтобы проверить количество показов и CTR сразу по нескольким запросам. В приведенном ниже примере CTR ключевого слова на средней позиции 3.6 составляет 1.7%, что значительно ниже ожидаемого уровня (около 7%).
В этом случае стоит провести сплит-тестирование тега description (подробнее об этом ниже). Оно покажет, можно ли улучшить CTR и выиграть за счет дополнительного трафика.

Часть 3. Теги Title

<title>Это тег title</title>
20. Продвигайте ключи – ставьте целевые ключевые слова как можно ближе к началу тега title.
21. Избегайте усечения – в результатах поиска тегу title отводится всего 512 пикселей, все остальное усекается. Отличный способ этого избежать – сократить длину title до 55 символов, которые обычно укладываются в эту зону. Тем не менее, в редких случаях, использование прописных букв может все-таки привести к усечению.
22. Сделайте их кликабельными – газеты продаются благодаря заголовкам, а веб-страницы – благодаря title.
23. Выделяйтесь – если все теги title в вашей тематике выдержаны в одном формате, то уход от этого шаблона поможет стать заметнее в результатах выдачи.
24. Не стоит указывать ваш бренд – писать свое фирменное наименование в конце тегов title совершенно ни к чему – в любом случае, Google часто добавляет его автоматически – так вы только займете драгоценное место. Тем не менее:
25. Оптимизируйте главную страницу под ваш бренд. Главная страница – исключение из правила №24. Главная страница должна быть большей частью оптимизирована под ваш бренд.
26. Минимизируйте количество стоп-слов – поскольку длина тега ограничена, постарайтесь использовать в нем как можно меньше вводных и стоп-слов – союзов, местоимений, предлогов.
27. Не повторяйтесь. Не повторяйтесь. Не повторяйтесь. Раздражает, не так ли? Используйте каждое ключевое слово в title один раз и не повторяйте его.

Часть 4. Теги Description

<meta name="description" content="Это тег description. Он поможет вашему контенту выделиться в результатах поиска и повысить CTR"/>
28. Продавайте свой контент. Тег description – ваше рекламное объявление в результатах поиска. Напишите уникальные и убедительные описания для каждой страницы сайта, они расскажут о ваших достоинствах и привлекут пользователей.
29. Избегайте усечения – сократите description максимум до 155 символов, чтобы не допустить их усечения в результатах поиска.
30. Используйте ключевые слова в description – хоть они и не оказывают непосредственного влияния на ранжирование, ключи будут выделены жирным шрифтом в результатах поиска, а это поможет повысить CTR.
31. Проводите сплит-тестирование – экспериментируйте с разными форматами description, чтобы оптимизировать CTR.

Часть 5: Теги заголовков

32. Убедитесь, что каждая страница имеет уникальный тег H1.
33. Используйте основной ключ в теге H1 – он остается важным внутренним фактором ранжирования и должен содержать целевое ключевое слово страницы.
34. Включайте второстепенные и дополнительные ключевые слова – дополнительные теги заголовков (Н2, Н3) дают возможность для продвижения по вторичным и LSI-словам.
35. Избегайте использования тегов заголовков в разметке – во многих шаблонах теги заголовков используются в разметке для таких общих фраз, как "Подробнее". Их можно заменить элементом <div>.

Часть 6: Контент

36. Используйте основное ключевое слово в начале – по возможности вставляйте целевые ключевые слова в первый абзац текста на странице, чтобы закрепить тему.
37. «Большой контент» обеспечивает высокие рейтинги – многочисленные исследования привели к выводу, что существует зависимость между объемом контента и позицией в выдаче, хотя эксперты и предупреждают, что это в большей степени относится к качеству, нежели к фактической длине текстов. В любом случае, они должны быть тщательно продуманы и оптимизированы под ваши целевые ключевые слова.
38. Забудьте о плотности ключевых слов. Текст должен быть естественным, тогда ключевые слова впишутся в него органично. Просто убедитесь, что каждое из них упоминается хотя бы раз!
39. Используйте LSI-ключи – слова, семантически связанные с вашим основным ключевым словом. Они помогают определить тематику страницы и разницу между омонимами (одинаковыми словами, имеющими разное значение) в поисковых запросах. Составляя текст, вы в любом случае будете их использовать, но будет неплохо провести и предварительный анализ.
40. Добавляйте мультимедийный контент – изображения, видео, слайд-шоу и т.д. – это привлекает больше внимания, дает возможность делиться с друзьями и создавать дополнительные ссылки. Это также может дать вам преимущество в плане SEO.
41. Делайте внутреннюю перелинковку – это равномерно распределяет ссылочную массу по сайту и подталкивает посетителей к дальнейшему просмотру, снижая показатель отказов. Этим аспектом SEO часто преступно пренебрегают.
42. Делайте внешние ссылки на качественный, авторитетный и релевантный вашей тематике контент, это поможет сайту набрать больший вес и наладить отношения с владельцами других ресурсов в вашей нише. Лучше всего, чтобы внешние ссылки открывались в новом окне или вкладке.
43. Следите за актуальностью контента – регулярно обновляйте старую информацию, чтобы она всегда была свежей, актуальной и достойной ранжирования.
44. Приоритетом должно быть качество, а не частота – за исключением крупных изданий и новостных сайтов (которым каждый день необходим большой объем нового контента), большинство сайтов получат больше пользы, сосредоточив внимание именно на качестве. Лучше размещать 1 хорошую статью каждую неделю, чем посредственные – каждый день.
45. Настройте структурированные данные, чтобы извлечь выгоду из сниппетов в результатах поиска.
46. Сделайте оглавления для больших текстов – разместите внутренние ссылки на конкретные разделы на длинных страницах – они будут отображаться в результатах поиска.

Часть 7: Убираем все лишнее

47. Используйте канонические URL – добавьте тег <link> для указания предпочтительной версии адреса для страниц с одинаковым содержанием.
<link rel="canonical" href="http://example.com/the-defacto-version-of-the-page/">
Например, электронные торговые площадки, на которых установлена фильтрация категорий по различным параметрам, могут автоматически создавать несколько похожих URL-адресов.
48. Используйте тег noindex, follow для страниц, которые вы хотите закрыть от индексации.
<meta name="robots" content="noindex, follow">
Пример таких страниц – архивы тегов и авторов в WordPress, однако использовать этот тег следует с осторожностью.
49. Защитите конфиденциальный контент от пауков при помощи robots.txt – не предоставляйте Googlebot и другим роботам доступ к уязвимым частям вашего сайта (например, к админ-панели), блокируя их в robots.txt.

Часть 8: Опыт взаимодействия

50. Снижайте показатель отказов – для большинства сайтов оптимален низкий показатель отказов и большое количество просмотренных за одно посещение страниц.
Сейчас еще обсуждается, учитывает ли Google показатель отказов, в аналитических отчетах он указывается в качестве фактора ранжирования. Наверняка можно сказать, что измеряется время, через которое пользователь возвращается к результатам поиска, а также то, переходит ли он на другие сайты из выдачи.
Достаточно быстрый уход с вашей страницы и выбор другого сайта – сигнал о том, что ваша страница либо не удовлетворила поисковый запрос пользователя, или имеет плохой UX.
51. Используйте карту скроллинга – специальная программа покажет вам, как далеко пользователи прокручивают отдельные страницы, и поможет определить, почему их покидают, не дочитывая до конца.
52. Используйте карту кликов – узнайте, на какие именно элементы страницы кликают пользователи, чтобы правильно расположить навигационные элементы и оптимизировать число переходов по ним.
53. Минимизируйте всплывающие окна – хоть они и увеличивают число переходов, слишком большое количество всплывающих окон может отпугнуть посетителей.
54. Будьте осторожны с промежуточной рекламой – Google подтвердил, что будет наказывать сайты, которые показывают пользователям промежуточную и полноэкранную рекламу (ниже) на мобильных устройствах.
55. Убедитесь, что ваш сайт оптимизирован под мобильные устройства – в противном случае вы потеряете огромное количество трафика. Сделайте это приоритетом №1.
56. Учитывайте доступность сайта – он должен открываться и работать на любых устройствах, операционных системах, размерах экрана, и должен быть доступным для пользователей с ограниченными возможностями.
57. Примите во внимание читаемость – убедитесь, что текстовый контент легко читается и хорошо отформатирован. Проверьте его на орфографические и грамматические ошибки.
58. Установите дружественную страницу 404, которая даст пользователям простые и ясные инструкции и сведет к минимуму количество отказов.
59. Минимизируйте время простоя – убедитесь, что у вас надежный хостинг с минимальным (в идеале нулевым) временем простоя. Не скупитесь на хостинг.
60. Установите SSL – подумайте о перемещении сайта на SSL (Google немного повышает в выдаче сайты, доступные по протоколу https). Тем не менее, информация на страницах, на которых вводятся пользовательские данные, должна быть надежно зашифрована.

Часть 9. Инструменты для веб-мастеров

61. Ищите быстрых побед – используйте отчеты по поисковым запросам, чтобы найти ключевые слова с большим количеством показов и средней позицией в поиске 11+. Добавьте на эти страницы несколько внутренних ссылок или ключ в прямом вхождении – этого может быть достаточно, чтобы переместить запрос в ТОП-10 и мгновенно повысить трафик.
62. Проводите проверки на наличие ошибок – регулярно исправляйте все, что указано в отчете «Ошибки сканирования».
63. Создайте карту сайта, чтобы убедиться, что все страницы на вашем сайте можно найти и установить приоритет сканирования.

Part 10: Google Analytics

64. Зарегистрируйтесь в Google Analytics – точная статистика по трафику очень важна для того, чтобы отслеживать эффективность ваших маркетинговых кампаний.
65. Регулярно проверяйте статистику и реагируйте на любые изменения трафика, посадочных страниц и т.д.

Часть 11: Скорость загрузки сайта

66. Оптимизируйте скорость загрузки – она тоже является фактором ранжирования и, при прочих равных условиях, страницы с более быстрой загрузкой будут находиться выше в выдаче.
67. Тестируйте скорость загрузки вашего сайта.
68. Следуйте рекомендациям Google Page Speed Insights – запустите сайт через этот инструмент и исправьте ошибки там, где это необходимо.

Часть 12: Оптимизация изображений

69. Используйте их! Включайте в контент изображения, чтобы визуально сделать его более привлекательным. Высокое качество и пользовательские изображения также сделают ссылку отличной приманкой.
70. Добавьте соответствующие Alt-тексты к изображениям.
71. Используйте описательные имена файлов.
Правильно: <img src="photo-of-a-clown.jpg" alt="фото клоуна" />
Неправильно: <img src="1550111.jpg" alt="" />
72. Оптимизируйте размеры файлов – сжимайте изображения для уменьшения времени загрузки.

Часть 13: Наращивание ссылочной массы

73. Наращивайте! Входящие ссылки по-прежнему являются одним из основных факторов, которые Google учитывает при ранжировании веб-страниц.
74. Ссылки с авторитетных доменов передают больший вес – чем больше трастовость и авторитет домена, тем выгоднее для вашего рейтинга будет ссылка с него. Вы можете использовать рейтинг доменов в Ahrefs Site Explorer для быстрой оценки их авторитета. Также можно ориентироваться на показатели DA (Moz) и поток доверия (Majestic).
75. Ссылки с тематически релевантных сайтов помогают ранжированию – ссылки с качественных сайтов вашей ниши или страниц, которые тематически связаны с вашим контентом, также полезны для рейтинга.
76. Ссылки с внутреннего контента являются наиболее ценными.
77. Воруйте ссылки у конкурентов – анализ обратных ссылок ваших конкурентов – отличная отправная точка для любой кампании по наращиванию ссылочной массы. Используйте Ahrefs Site Explorer, чтобы найти обратные ссылки и захватить их для своего сайта.
78. Низкое качество ссылок или автоматизация процесса может привести к штрафам.
79. Диверсифицируйте ссылочный профиль – он должен включать несколько разных типов ссылок.
80. Диверсифицируйте анкоры – анкорные тексты все еще являются фактором ранжирования, однако важно их разнообразить. Желательно использовать прямые, разбавленные и естественные анкоры.
81. Регулярно проверяйте ссылочный профиль – проводите регулярный аудит и ищите подозрительные, неестественно выглядящие ссылки. Небольшое их количество не причинит вам никакого вреда, но если таких ссылок слишком много, это может быть признаком низкого качества наращивания ссылочной массы или даже негативного SEO от конкурентов. В этом случае ссылки нужно удалить.

Часть 14: Социальные медиа

82. Не игнорируйте социальные медиа! Официально они не оказывают прямого влияния на ранжирование (хотя на этот счет есть разные мнения), однако социальные сети помогают распространять контент среди потенциально заинтересованных пользователей. Кроме того, трафик из соцсетей может привести в действие другие факторы, которые напрямую влияют на ранжирование (трафик, поведенческие факторы, брендовые и URL-запросы).
83. Используйте социальные медиа, чтобы делиться контентом – ведите активные страницы в крупных соцсетях и обменивайтесь контентом со своей аудиторией.
84. Репосты в соцсетях (кроме Твиттера) демонстрируют доверие пользователей к вашему ресурсу. Это также учитывается и способствует дальнейшему распространению контента.
85. Поощряйте репосты вашего контента – разместите кнопки социальных сетей на видном месте, чтобы сделать обмен максимально удобным.
86. Используйте протокол Open Graph – добавляйте к вашим страницам специальные мета-теги, чтобы управлять внешним видом анонсов статей в соцсетях.
87. Настройте твиттер-карту, чтобы увеличить количество информации, содержащейся в одном твите.
88. Создавайте подробные пины в Pinterest, чтобы привлечь трафик из этой соцсети.

Часть 15: Восстановление после санкций

89. Ручные санкции за ссылочный спам – о них вас уведомят по электронной почте или сообщением в панели веб-мастера.
90. Проверяйте, не падает ли трафик после апдейтов поисковых систем – проседания трафика, совпадающие с апдейтами, могут быть признаком того, что вы попали под фильтр.
91. Избавьтесь от некачественного контента – чтобы не попасть под фильтр «Панда», найдите страницы с неинформативным или дублированным контентом и удалите их, либо закройте от индексации.
92. Удалите «плохие» ссылки – проведите аудит, отметьте все низкокачественные ссылки и попросите владельцев удалить их.
93. Дезавуируйте ссылки, которые нельзя удалить – если на ваши запросы об удалении не отвечают, добавьте низкокачественные ссылки или домены в специальный файл. Управлять несколькими такими файлами можно через Ahrefs.
94. Убедитесь, что ваш сайт не был взломан, и что на нем нет никаких подозрительных исходящих ссылок.
95. Запрашивайте повторную проверку в случае наложения ручных санкций, но только после того, как все выявленные проблемы будут устранены.
Примечание: восстановление после санкций – непростой процесс, вы должны быть очень осторожны при удалении ссылок, закрытии страниц от индексации и т.д. Если сомневаетесь, стоит нанять опытного SEO-консультанта. Следует также отметить, что в скором времени ожидается переход Google на непрерывное обновление алгоритмов «Пингвин» и «Панда», в связи с этим выявление конкретных санкций может стать сложнее.

Часть 16: Продвижение контентом

96. Найдите популярный в вашей нише контент и улучшайте/обновляйте его – не стоит создавать контент наугад, ищите то, что уже было популярным раньше, и совершенствуйте. Самое лучшее в такой стратегии то, что вы можете обратиться к тем, кто ссылался или делился оригинальным контентом ранее, и направить их на свой сайт.
97. Тратьте на продвижение контента как минимум столько же времени, сколько на его создание. Даже если у вас уже есть огромное количество фолловеров, не стоит об этом забывать. Некоторые эксперты по контент-маркетингу утверждают, что продвижение должно занимать львиную долю вашего времени.
98. E-mail рассылки по-прежнему остаются самым эффективным методом. Лучший способ заявить о себе – электронная почта (Но! См. совет № 108).
99. Интересный контент = больше ссылок – используйте как можно больше контента, которым хочется делиться, например, инфографику, чтобы увеличить количество репостов и ссылок.
100. Делитесь контентом партнеров. Ты – мне, я – тебе. Используйте принцип взаимности в полную силу.

Часть 17: СЕО-уборка

101. Удаляйте битые ссылки – они плохо влияют на пользовательский опыт и SEO.
102. Модерируйте комментарии и пользовательский контент в блогах, на форумах и т.д. Проверяйте их на спам и некачественные ссылки.

Часть 18: Общие SEO-советы и рекомендации

103. Не кладите все яйца в одну корзину – хороший интернет-маркетинг должен быть многогранным и включать сочетание SEO, социальных медиа и платного трафика. Никогда не полагайтесь только на один источник трафика для вашего бизнеса.
104. Учитесь столько, сколько вы можете. Знание – сила.
105. Обращайте внимание на обновления – в мире SEO все меняется, так что оставайтесь в курсе этих изменений.
106. Будьте терпеливы – эффективная раскрутка сайтов требует усердного труда и времени, но все усилия и ожидание того стоят. Исследования показали, что SEO по-прежнему обеспечивает наилучшую окупаемость среди всех маркетинговых каналов.
107. Избегайте черных методов – если что-то кажется вам слишком хорошим, чтобы быть правдой, скорее всего, это неправда (см. последний совет).
108. Не спамьте.
109. Не теряйте головы.

Open Graph

#Вариант 1

Обязательно добавить в head префиксы для валидности
<head prefix=
    "og: http://ogp.me/ns#
     fb: http://ogp.me/ns/fb#  
     product: http://ogp.me/ns/product#">
Сам код OpenGraph
<?php
$bOpenGraph = FALSE;
// Open Graph
if (is_object(Core_Page::instance()->object))
{
    $bInformationItem = Core_Page::instance()->object instanceof Informationsystem_Controller_Show;
    $bShopItem = Core_Page::instance()->object instanceof Shop_Controller_Show;
   
    if ($bInformationItem || $bShopItem)
    {
        echo'<meta property="og:site_name" content="inikSite.ru">';    // ЗАМЕНИТЬ НА URL СВОЕГО САЙТА
        if (Core_Page::instance()->object->item)
        {
   $bOpenGraph = TRUE;
         
            $aOpenGraph = array();            
            $oEntity = $bInformationItem
                ? Core_Entity::factory('Informationsystem_Item', Core_Page::instance()->object->item)
                : Core_Entity::factory('Shop_Item', Core_Page::instance()->object->item);
            
            $type = $bInformationItem
                ? 'article'
                : 'product';
            
            $aOpenGraph['og:type'] = $type;
            $aOpenGraph['og:title'] =  $oEntity->name;
            $aOpenGraph['og:description'] = strip_tags(Core_Str::cutSentences($oEntity->description));


            $oSite = Core_Entity::factory('Site', CURRENT_SITE);
            $oSite_Alias = $oSite->getCurrentAlias();
        
            if ($oSite_Alias)
            {
                $sSiteURL = $oSite_Alias->name;
                
                $protocol = Core_Page::instance()->structure->https
                    ? 'https://'
                    : 'http://';
            
                $aOpenGraph['og:url'] = $protocol . $sSiteURL
                    . Core_Page::instance()->structure->getPath()
                    . $oEntity->getPath();
            
                if ($oEntity->image_large != '')
                {
                    $aOpenGraph['og:image'] = $protocol . $sSiteURL . $oEntity->getLargeFileHref();
                              $aOpenGraph['og:image:width'] = $oEntity->image_large_width;
                              $aOpenGraph['og:image:height'] = $oEntity->image_large_height;
                }
               
               if ($bShopItem)
               {
                  $aOpenGraph['product:price:amount'] = $oEntity->price;
                  $aOpenGraph['product:price:currency'] = $oEntity->shop_currency->code;
               }
                     
            }
            
            foreach ($aOpenGraph as $sProperty => $sContent)
            {
         ?><meta property="<?php echo htmlspecialchars($sProperty)?>" content="<?php echo htmlspecialchars($sContent)?>" /><?php
      
         echo PHP_EOL;
            }
      }
      elseif (Core_Page::instance()->object->group)
      {
         $bOpenGraph = TRUE;


            $aOpenGraph = array();
            
            $oEntity = $bInformationItem
                ? Core_Entity::factory('Informationsystem_Group', Core_Page::instance()->object->group)
                : Core_Entity::factory('Shop_Group', Core_Page::instance()->object->group);
            
            $type = $bInformationItem
                ? 'article'
                : 'website';
            
            $aOpenGraph['og:type'] = $type;
            $aOpenGraph['og:title'] = $oEntity->name;
            $aOpenGraph['og:description'] = $oEntity->seo_description;


            $oSite = Core_Entity::factory('Site', CURRENT_SITE);
            $oSite_Alias = $oSite->getCurrentAlias();
        
            if ($oSite_Alias)
            {
                $sSiteURL = $oSite_Alias->name;
                
                $protocol = Core_Page::instance()->structure->https
                    ? 'https://'
                    : 'http://';
            
                $aOpenGraph['og:url'] = $protocol . $sSiteURL
                    . Core_Page::instance()->structure->getPath()
                    . $oEntity->getPath();
            
                if ($oEntity->image_large != '')
                {
                    $aOpenGraph['og:image'] = $protocol . $sSiteURL . $oEntity->getLargeFileHref();
                }else{
                    $aOpenGraph['og:image'] = 'https://inikSite.ru/images/logo.jpg';   // ЗАМЕНИТЬ НА ПУТЬ К ЛОГОТИПУ СВОЕГО САЙТА
                }
            }
            
            foreach ($aOpenGraph as $sProperty => $sContent)
            {
         ?><meta property="<?php echo htmlspecialchars($sProperty)?>" content="<?php echo htmlspecialchars($sContent)?>" /><?php
      
         echo PHP_EOL;
         }
      }
   }
}
   
if (!$bOpenGraph && Core_Page::instance()->structure)
{
   $aOpenGraph = array();
   
   $oEntity = Core_Page::instance()->structure;
   
   $type = 'website';
   
   $aOpenGraph['og:type'] = $type;
   $aOpenGraph['og:title'] = $oEntity->Site->name;
   $aOpenGraph['og:description'] = strip_tags(Core_Str::cutSentences($oEntity->seo_description));


   $oSite = Core_Entity::factory('Site', CURRENT_SITE);
   $oSite_Alias = $oSite->getCurrentAlias();


   if ($oSite_Alias)
   {
      $sSiteURL = $oSite_Alias->name;
      
      $protocol = Core_Page::instance()->structure->https
         ? 'https://'
         : 'http://';
   
      $aOpenGraph['og:url'] = $protocol . $sSiteURL
         . $oEntity->getPath();
   
     $aOpenGraph['og:image'] = 'https://inikSite.ru/images/logo.jpg';   // ЗАМЕНИТЬ НА ПУТЬ К ЛОГОТИПУ СВОЕГО САЙТА
               
   }
   
   foreach ($aOpenGraph as $sProperty => $sContent)
   {
      ?><meta property="<?php echo htmlspecialchars($sProperty)?>" content="<?php echo htmlspecialchars($sContent)?>" /><?php


      echo PHP_EOL;
   }
}
?>

#Вариант 2

<?php
    // Open Graph
    if (is_object(Core_Page::instance()->object))
    {
        $bInformationItem = Core_Page::instance()->object instanceof Informationsystem_Controller_Show;
        $bShopItem = Core_Page::instance()->object instanceof Shop_Controller_Show;
        if ($bInformationItem || $bShopItem)
        {
            if (Core_Page::instance()->object->item)
            {
                $aOpenGraph = array();
                
                $oEntity = $bInformationItem
                    ? Core_Entity::factory('Informationsystem_Item', Core_Page::instance()->object->item)
                    : Core_Entity::factory('Shop_Item', Core_Page::instance()->object->item);
                
                $type = $bInformationItem
                    ? 'article'
                    : 'website';
                
                $aOpenGraph['og:type'] = $type;
                $aOpenGraph['og:title'] = $oEntity->name;
                $aOpenGraph['og:description'] = strip_tags(Core_Str::cutSentences($oEntity->description));
                                

                if ($oEntity->image_large != '')
                {
                    $oSite = Core_Entity::factory('Site', CURRENT_SITE);
                    $oSite_Alias = $oSite->getCurrentAlias();
                
                    if ($oSite_Alias)
                    {
                        $sSiteURL = $oSite_Alias->name;
                        
                        $protocol = Core_Page::instance()->structure->https
                            ? 'https://'
                            : 'http://';
                            
                        $aOpenGraph['og:image'] = $protocol . $sSiteURL . $oEntity->getLargeFileHref();
                    }
                }
                
                foreach ($aOpenGraph as $sProperty => $sContent)
                {
                    ?><meta property="<?php echo htmlspecialchars($sProperty)?>" content="<?php echo htmlspecialchars($sContent)?>" /><?php
                    echo PHP_EOL;
                }
            }
        }
    }
?>

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- только основные стили Swiper
  • swiper/css/a11y- стили, необходимые для модуля A11y
  • swiper/css/autoplay- стили, необходимые для модуля автозапуска
  • swiper/css/controller- стили, необходимые для модуля контроллера
  • swiper/css/effect-cards- стили, необходимые для модуля Cards Effect
  • swiper/css/effect-coverflow- стили, необходимые для модуля Coverflow Effect
  • swiper/css/effect-creative- стили, необходимые для модуля Creative Effect
  • swiper/css/effect-cube- стили, необходимые для модуля Cube Effect
  • swiper/css/effect-fade- стили, необходимые для модуля эффекта затухания
  • swiper/css/effect-flip- стили, необходимые для модуля Flip Effect
  • swiper/css/free-mode- стили, необходимые для модуля свободного режима
  • swiper/css/grid- стили, необходимые для модуля Grid
  • swiper/css/hash-navigation- стили, необходимые для модуля навигации по хэшу
  • swiper/css/history- стили, необходимые для модуля Истории
  • swiper/css/keyboard- стили, необходимые для модуля клавиатуры
  • swiper/css/manipulation- стили, необходимые для модуля манипулирования
  • swiper/css/mousewheel- стили, необходимые для модуля Mousewheel
  • swiper/css/navigation- стили, необходимые для навигационного модуля
  • swiper/css/pagination- стили, необходимые для модуля разбивки на страницы
  • swiper/css/parallax- стили, необходимые для модуля Parallax
  • swiper/css/scrollbar- стили, необходимые для модуля полосы прокрутки
  • swiper/css/thumbs- стили, необходимые для модуля Thumbs
  • swiper/css/virtual- стили, необходимые для виртуального модуля
  • swiper/css/zoom- стили, необходимые для модуля масштабирования

Меньше стилей

Меньшие стили - это отдельные стили для базовой версии и модулей (импорт пакетов):

  • swiper/less- только основные стили Swiper
  • swiper/less/bundle— все стили Swiper, включая стили всех модулей (например, навигации, постраничной навигации и т. д.)
  • swiper/less/a11y- стили, необходимые для модуля A11y
  • swiper/less/autoplay- стили, необходимые для модуля автозапуска
  • swiper/less/controller- стили, необходимые для модуля контроллера
  • swiper/less/effect-cards- стили, необходимые для модуля Cards Effect
  • swiper/less/effect-coverflow- стили, необходимые для модуля Coverflow Effect
  • swiper/less/effect-creative- стили, необходимые для модуля Creative Effect
  • swiper/less/effect-cube- стили, необходимые для модуля Cube Effect
  • swiper/less/effect-fade- стили, необходимые для модуля эффекта затухания
  • swiper/less/effect-flip- стили, необходимые для модуля Flip Effect
  • swiper/less/free-mode- стили, необходимые для модуля свободного режима
  • swiper/less/grid- стили, необходимые для модуля Grid
  • swiper/less/hash-navigation- стили, необходимые для модуля навигации по хэшу
  • swiper/less/history- стили, необходимые для модуля Истории
  • swiper/less/keyboard- стили, необходимые для модуля клавиатуры
  • swiper/less/manipulation- стили, необходимые для модуля манипулирования
  • swiper/less/mousewheel- стили, необходимые для модуля Mousewheel
  • swiper/less/navigation- стили, необходимые для навигационного модуля
  • swiper/less/pagination- стили, необходимые для модуля разбивки на страницы
  • swiper/less/parallax- стили, необходимые для модуля Parallax
  • swiper/less/scrollbar- стили, необходимые для модуля полосы прокрутки
  • swiper/less/thumbs- стили, необходимые для модуля Thumbs
  • swiper/less/virtual- стили, необходимые для виртуального модуля
  • swiper/less/zoom- стили, необходимые для модуля масштабирования

Стили SCSS

Стили SCSS также являются отдельными стилями для основной версии и модулей (импортируемых пакетов):

  • swiper/scss- только основные стили Swiper
  • swiper/scss/bundle— все стили Swiper, включая стили всех модулей (например, навигации, постраничной навигации и т. д.)
  • swiper/scss/a11y- стили, необходимые для модуля A11y
  • swiper/scss/autoplay- стили, необходимые для модуля автозапуска
  • swiper/scss/controller- стили, необходимые для модуля контроллера
  • swiper/scss/effect-cards- стили, необходимые для модуля Cards Effect
  • swiper/scss/effect-coverflow- стили, необходимые для модуля Coverflow Effect
  • swiper/scss/effect-creative- стили, необходимые для модуля Creative Effect
  • swiper/scss/effect-cube- стили, необходимые для модуля Cube Effect
  • swiper/scss/effect-fade- стили, необходимые для модуля эффекта затухания
  • swiper/scss/effect-flip- стили, необходимые для модуля Flip Effect
  • swiper/scss/free-mode- стили, необходимые для модуля свободного режима
  • swiper/scss/grid- стили, необходимые для модуля Grid
  • swiper/scss/hash-navigation- стили, необходимые для модуля навигации по хэшу
  • swiper/scss/history- стили, необходимые для модуля Истории
  • swiper/scss/keyboard- стили, необходимые для модуля клавиатуры
  • swiper/scss/manipulation- стили, необходимые для модуля манипулирования
  • swiper/scss/mousewheel- стили, необходимые для модуля Mousewheel
  • swiper/scss/navigation- стили, необходимые для навигационного модуля
  • swiper/scss/pagination- стили, необходимые для модуля разбивки на страницы
  • swiper/scss/parallax- стили, необходимые для модуля Parallax
  • swiper/scss/scrollbar- стили, необходимые для модуля полосы прокрутки
  • swiper/scss/thumbs- стили, необходимые для модуля Thumbs
  • swiper/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 или логическийtrueдля включения с настройками по умолчанию.

const swiper = new Swiper('.swiper', {
  a11y: {
    prevSlideMessage: 'Previous slide',
    nextSlideMessage: 'Next slide',
  },
});
allowSlideNext логическое значение верно

Установите значениеfalseдля отключения перехода к следующему направлению (вправо или вниз)

allowSlidePrev логическое значение верно

Установите значениеfalseдля отключения перехода к предыдущему направлению скольжения (влево или вверх)

Разрешить касание логическое значение верно

Еслиfalse, то единственный способ переключиться на другой слайд — использовать внешние функции API, такие как slidePrev или slideNext

Автоматический рост логическое значение ложь

Задайте значениеtrueи обёртка слайдера будет подстраивать свою высоту под высоту активного слайда

автоматическое воспроизведение Любой

Объект с параметрами автозапуска или логическим значениемtrueдля включения с настройками по умолчанию

const swiper = new Swiper('.swiper', {
 autoplay: {
   delay: 5000,
 },
});
точки останова объект

Позволяет задавать разные параметры для разных точек останова (размеров экрана). Не все параметры можно изменить в точках останова, только те, которые не требуют другого макета и логики, напримерslidesPerView,slidesPerGroup,spaceBetween,grid.rows. Такие параметры, какloopиeffectне будут работать

const swiper = new Swiper('.swiper', {
  // Default parameters
  slidesPerView: 1,
  spaceBetween: 10,
  // Responsive breakpoints
  breakpoints: {
    // when window width is >= 320px
    320: {
      slidesPerView: 2,
      spaceBetween: 20
    },
    // when window width is >= 480px
    480: {
      slidesPerView: 3,
      spaceBetween: 30
    },
    // when window width is >= 640px
    640: {
      slidesPerView: 4,
      spaceBetween: 40
    }
  }
})
const swiper = new Swiper('.swiper', {
  slidesPerView: 1,
  spaceBetween: 10,
  // using "ratio" endpoints
  breakpoints: {
    '@0.75': {
      slidesPerView: 2,
      spaceBetween: 20,
    },
    '@1.00': {
      slidesPerView: 3,
      spaceBetween: 40,
    },
    '@1.50': {
      slidesPerView: 4,
      spaceBetween: 50,
    },
  }
});
База контрольных точек «контейнер»|«окно» "окно"

База для точек останова (бета-версия). Может бытьwindowилиcontainer. Если установлено значениеwindow(по умолчанию), то клавиши точек останова означают ширину окна. Если установлено значениеcontainer, то клавиши точек останова рассматриваются как ширина контейнера свипера

Эффект карты Любой

Объект с картами-параметры эффекта

const swiper = new Swiper('.swiper', {
  effect: 'cards',
  cardsEffect: {
    // ...
  },
});
Центрирующие оползни логическое значение ложь

Если этот параметр включен, слайды центрируются, если количество слайдов меньшеslidesPerView. Не предназначено для использования в режимеloopиgrid.rows

центрироВанные оползни логическое значение ложь

Еслиtrue, то активное слайд-шоу будет отображаться по центру, а не всегда слева.

Центрированные скользящие границы логическое значение ложь

Еслиtrue, то активный слайд будет центрирован без добавления пробелов в начале и в конце слайдера. ТребуетсяcenteredSlides: true. Не предназначено для использования сloopилиpagination

containerModifierClass строка "swiper-"

Начало CSS-класса модификатора, который можно добавить в контейнер Swiper в зависимости от различных параметров

контроллер Любой

Объект с параметрами контроллера или логическим значениемtrueдля включения с настройками по умолчанию

const swiper = new Swiper('.swiper', {
  controller: {
    inverse: true,
  },
});
Эффект coverflowEffect Любой

Объект с параметрами эффекта Coverflow.

const swiper = new Swiper('.swiper', {
  effect: 'coverflow',
  coverflowEffect: {
    rotate: 30,
    slideShadows: false,
  },
});
createElements логическое значение ложь

При включении Swiper автоматически обернет слайды элементом swiper-wrapper и создаст необходимые элементы для навигации, разбивки на страницы и полосы прокрутки, если они включены (с соответствующим объектом параметров или с логическим значениемtrue))

Творческий эффект Любой

Объект с параметрами креативного эффекта

const swiper = new Swiper('.swiper', {
  effect: 'creative',
  creativeEffect: {
    prev: {
      // will set `translateZ(-400px)` on previous slides
      translate: [0, 0, -400],
    },
    next: {
      // will set `translateX(100%)` on next slides
      translate: ['100%', 0, 0],
    },
  },
});
cssMode логическое значение ложь

При включении он будет использовать современный CSS Scroll Snap API. Он поддерживает не все функции Swiper, но потенциально может значительно повысить производительность в простых конфигурациях.

Это то, что не поддерживается, когда оно включено:

  • Эффект куба
  • speedпараметр может не иметь никакого эффекта
  • Все события, связанные с началом / завершением перехода (используйтеslideChangeвместо этого)
  • slidesPerGroupимеет ограниченную поддержку
  • simulateTouchне имеет эффекта, а «перетаскивание» с помощью мыши не работает
  • resistanceне имеет никакого эффекта
  • allowSlidePrev/Next
  • swipeHandler

Если вы используете его с другими эффектами, особенно с 3D-эффектами, необходимо обернуть содержимое слайда элементом<div className="swiper-slide-transform">. И если вы используете какие-либо пользовательские стили для слайдов (например, цвета фона, радиус границы, границу и т. д.), их следует задавать для элементаswiper-slide-transform.

<div class="swiper">
  <div class="swiper-wrapper">
    <div class="swiper-slide">
      <!-- wrap slide content with transform element -->
      <div class="swiper-slide-transform">
        ... slide content ...
      </div>
    </div>
    ...
  </div>
</div>
<script>
const swiper = new Swiper('.swiper', {
   effect: 'flip',
   cssMode: true,
 });
</script>
Эффект куба Любой

Объект с параметрами кубического эффекта

const swiper = new Swiper('.swiper', {
  effect: 'cube',
  cubeEffect: {
    slideShadows: false,
  },
});
направление «по горизонтали»|«по вертикали» "горизонтальный"

Может быть'horizontal'или'vertical'(для вертикального слайдера).

Обнаружение кромки строка|логическое значение ложь

Включите события Swiper для работы с возвратом свайпом в приложении. Если установлено значение'prevent', то вместо этого будет предотвращаться системная навигация с возвратом свайпом. Эта функция работает только с событиями «касания» (а не с событиями указателя), поэтому она будет работать на устройствах iOS/Android и не будет работать на устройствах Windows с событиями указателя (касания).

edgeSwipeThreshold номер 20

Область (в пикселях) от левого края экрана для отпускания сенсорных событий при свайпе назад в приложении

эффект строка "слайд"

Эффект перехода. Может быть'slide','fade','cube''coverflow','flip''creative',,,,, или'cards'

включен логическое значение верно

Независимо от того, был ли Swiper изначально включен. Если Swiper отключен, он скроет все элементы навигации и не будет реагировать на какие-либо события и взаимодействия

eventsPrefix строка `swiper`

Префикс имени события для всех событий DOM, генерируемых элементом Swiper (веб-компонентом)

Эффект затухания Любой

Объект с параметрами эффекта затухания

const swiper = new Swiper('.swiper', {
  effect: 'fade',
  fadeEffect: {
    crossFade: true
  },
});
flipEffect Любой

Объект с параметрами эффекта переворота

const swiper = new Swiper('.swiper', {
  effect: 'flip',
  flipEffect: {
    slideShadows: false,
  },
});
Фокусируемые элементы строка «ввод, выбор, опция, текстовое поле, кнопка, видео, метка»

Селектор CSS для элементов, на которые можно навести курсор. Свайпинг будет отключен для таких элементов, если они «наведены»

followFinger логическое значение верно

Если функция отключена, то ползунок будет анимироваться только при отпускании, он не будет двигаться, пока вы удерживаете на нём палец

Бесплатный режим Любой

Включает функции бесплатного режима. Объект с параметрами бесплатного режима или логическое значениеtrueдля включения с настройками по умолчанию.

const swiper = new Swiper('.swiper', {
  freeMode: true,
});

const swiper = new Swiper('.swiper', {
  freeMode: {
    enabled: true,
    sticky: true,
  },
});
grabCursor логическое значение ложь

Эта опция может немного улучшить удобство использования Swiper на компьютере. Еслиtrue, пользователь увидит курсор «захвата» при наведении на Swiper

сетка Любой

Объект с параметрами сетки для включения ползунка «многострочный».

const swiper = new Swiper('.swiper', {
  grid: {
    rows: 2,
  },
});
Хэшнавигация Любой

Включает навигацию по хэш-ссылкам для слайдов. Объект с параметрами хэш-навигации или логическое значениеtrueдля включения с настройками по умолчанию

const swiper = new Swiper('.swiper', {
  hashNavigation: {
    replaceState: true,
  },
});
высота нулевой|номер null

Высота Swiper (в пикселях). Параметр позволяет задать высоту Swiper. Полезно только в том случае, если вы инициализируете Swiper, когда он скрыт, а также в средах SSR и Test для правильной инициализации Swiper

Установка этого параметра приведет к тому, что Swiper перестанет реагировать

история Любой

Включает функцию сохранения состояния истории, при которой у каждого слайда будет свой URL-адрес. В этом параметре необходимо указать URL-адрес основного слайда, например"slides"и указать URL-адрес каждого слайда с помощью атрибутаdata-history.

Объект с параметрами навигации по истории или логическим значениемtrueдля включения с настройками по умолчанию

const swiper = new Swiper('.swiper', {
  history: {
    replaceState: true,
  },
});
<!-- will produce "slides/slide1" url in browser history -->
<div class="swiper-slide" data-history="slide1"></div>
инициализация логическое значение верно

Следует ли инициализировать Swiper автоматически при создании экземпляра. Если эта функция отключена, то вам нужно инициализировать Swiper вручную, вызвавswiper.init()

initialSlide номер 0

Порядковый номер начального слайда.

Инжектные стили строка[]

Внедрите стили текста в теневой DOM. Только для использования с элементом Swiper

injectStylesUrls строка[]

Внедрите стили<link>в теневой DOM. Только для использования с элементом Swiper

клавиатура Любой

Позволяет перемещаться по слайдам с помощью клавиатуры. Объект с параметрами клавиатуры или логическое значениеtrueдля включения с настройками по умолчанию

const swiper = new Swiper('.swiper', {
  keyboard: {
    enabled: true,
    onlyInViewport: false,
  },
});
lazyPreloadPrevNext номер 0

Количество следующих и предыдущих слайдов для предварительной загрузки. Применимо только при использовании отложенной загрузки.

Класс lazyPreloaderClass строка "swiper-ленивый предварительный загрузчик"

Имя CSS-класса ленивого предварительного загрузчика

Длинные наконечники логическое значение верно

Установите значениеfalse, если вы хотите отключить длинные прокрутки

longSwipesMs номер 300

Минимальная продолжительность (в миллисекундах) для перехода к следующему/предыдущему слайду при длительном смахивании

Стратегия длинных свайпов номер 0.5

Соотношение для перехода к следующему / предыдущему слайду при длительном пролистывании

цикл логическое значение ложь

Установите значениеtrue, чтобы включить режим непрерывного цикла

Из-за особенностей работы режима цикла (он меняет порядок слайдов) общее количество слайдов должно быть:

  • больше или равноslidesPerView+slidesPerGroup
  • даже дляslidesPerGroup(или использоватьloopAddBlankSlidesпараметр)
  • даже дляgrid.rows(или использоватьloopAddBlankSlidesпараметр)
loopAddBlankSlides логическое значение верно

Автоматически добавляет пустые слайды, если вы используете сетку илиslidesPerGroupи общее количество слайдов не равноslidesPerGroupилиgrid.rows

loopAdditionalSlides номер 0

Позволяет увеличить количество закольцованных слайдов

loopPreventsSliding логическое значение верно

Если эта функция включена, то кнопки «Далее» и «Назад» не будут работать, пока слайдер анимируется в режиме цикла

maxBackfaceHiddenSlides номер 10

Если общее количество слайдов меньше указанного здесь значения, то Swiper включитbackface-visibility: hiddenна элементах слайдов, чтобы уменьшить визуальное «мерцание» в Safari.

Не рекомендуется включать эту функцию на большом количестве слайдов, так как это снизит производительность

модули любой[]

Массив с модулями Swiper

import Swiper from 'swiper';
import { Navigation, Pagination } from 'swiper/modules';

const swiper = new Swiper('.swiper', {
   modules: [ Navigation, Pagination ],
 });
колесо мыши Любой

Позволяет перемещаться по слайдам с помощью колёсика мыши. Объект с параметрами колёсика мыши или логическое значениеtrueдля включения с настройками по умолчанию

const swiper = new Swiper('.swiper', {
  mousewheel: {
    invert: true,
  },
});
навигация Любой

Объект с параметрами навигации или логическим значениемtrueдля включения с настройками по умолчанию.

const swiper = new Swiper('.swiper', {
  navigation: {
    nextEl: '.swiper-button-next',
    prevEl: '.swiper-button-prev',
  },
});
вложенный логическое значение ложь

Установитеtrueна Swiper для корректного перехвата событий касания. Используйте только на свиперах, которые используют то же направление, что и родительский элемент

Промывка носа логическое значение верно

Включать / отключать прокрутку элементов, соответствующих классу, указанному вnoSwipingClass

noSwipingClass строка "swiper-без пролистывания"

УкажитеnoSwipingcss-класс элемента

noSwipingSelector строка

Может использоваться вместоnoSwipingClassдля указания элементов, для которых нужно отключить свайп. Например,'input'отключит свайп для всех входов

normalizeSlideIndex логическое значение верно

Нормализует индекс слайда.

Наблюдаем за родителями логическое значение ложь

Установите значениеtrueесли вам также нужно отслеживать изменения родительских элементов Swiper

Наблюдает за детьми логическое значение ложь

Установите значениеtrueесли вам также нужно отслеживать изменения для дочерних элементов слайдов Swiper

наблюдатель логическое значение ложь

Задайте значениеtrueдля включения наблюдателя за изменениями в Swiper и его элементах. В этом случае Swiper будет обновляться (перезапускаться) каждый раз, когда вы меняете его стиль (например, скрываете/отображаете) или изменяете дочерние элементы (например, добавляете/удаляете слайды)

вкл . объект

Регистрация обработчиков событий

На любом функция(обработчик)

Добавьте прослушиватель событий, который будет запускаться при всех событиях

const swiper = new Swiper('.swiper', {
   onAny(eventName, ...args) {
     console.log('Event: ', eventName);
     console.log('Event data: ', args);
   }
 });
oneWayMovement логическое значение ложь

Если эта функция включена, слайды будут прокручиваться только вперёд (в одну сторону) независимо от направления прокрутки

разбивка на страницы Любой

Объект с параметрами разбивки на страницы или логическим значениемtrueдля включения с настройками по умолчанию.

const swiper = new Swiper('.swiper', {
  pagination: {
    el: '.swiper-pagination',
    type: 'bullets',
  },
});
параллакс Любой

Объект с параметрами параллакса или booleantrueдля включения с настройками по умолчанию.

const swiper = new Swiper('.swiper', {
  parallax: true,
});
Пассивные прослушиватели логическое значение верно

По умолчанию для повышения производительности прокрутки на мобильных устройствах будут использоваться пассивные слушатели событий. Но если вам нужно использоватьe.preventDefaultи у вас возникает конфликт с ним, то вам следует отключить этот параметр

Предотвращение щелчков логическое значение верно

Установите значениеtrueдля предотвращения случайных нежелательных переходов по ссылкам во время прокрутки

Предотвращение распространения Clicksprop логическое значение верно

Установите значениеtrue, чтобы остановить распространение событий кликов по ссылкам во время прокрутки

Предотвращение взаимодействия при переходе логическое значение ложь

Если эта функция включена, она не позволит менять слайды с помощью свайпа или кнопок навигации/пагинации во время перехода

сопротивление логическое значение верно

Установите значениеfalse, если вы хотите отключить устойчивые границы

Сопротивление номер 0.85

Эта опция позволяет вам контролировать коэффициент сопротивления

Сервер изменения размера логическое значение верно

Если эта функция включена, она будет использовать ResizeObserver (если поддерживается браузером) для контейнера Swiper, чтобы определять изменение размера контейнера (вместо отслеживания изменения размера окна)

перемотка назад логическое значение ложь

Установите значениеtrueдля включения режима «перемотки». При включенном режиме нажатие кнопки «следующий слайд» (или вызов.slideNext()) при нахождении на последнем слайде приведет к переходу на первый слайд. Нажатие кнопки «предыдущий слайд» (или вызов.slidePrev()) при нахождении на первом слайде приведет к переходу на последний слайд.

Не следует использовать вместе сloopmode

Длина круга логическое значение ложь

Задайтеtrueдля округления значений ширины и высоты слайдов, чтобы текст не был размытым на экранах с обычным разрешением (если у вас такие есть)

runCallbacksOnInit логическое значение верно

При инициализации свипера запускаются события Transition/SlideChange/Start/End. Такие события будут запускаться при инициализации, если ваш initialSlide не равен 0 или вы используете режим цикла

полоса прокрутки Любой

Объект с параметрами полосы прокрутки или логическим значениемtrueдля включения с настройками по умолчанию.

const swiper = new Swiper('.swiper', {
  scrollbar: {
    el: '.swiper-scrollbar',
    draggable: true,
  },
});
setWrapperSize логическое значение ложь

Если вы включите эту опцию, плагин установит ширину/высоту оболочки Swiper, равную общему размеру всех слайдов. В основном эту опцию следует использовать в качестве запасного варианта совместимости для браузеров, которые плохо поддерживают макет flexbox

Короткие замахи логическое значение верно

Установите значениеfalse, если вы хотите отключить короткие прокрутки

simulateTouch логическое значение верно

ЕслиtrueSwiper будет принимать события мыши, такие как события касания (щелкните и перетащите для смены слайдов)

slideActiveClass строка "swiper-slide-активный"

Имя CSS-класса текущего активного слайда

При изменении классов вам также потребуется изменить CSS Swiper, чтобы отразить изменения в классах

Не поддерживается в компонентах Swiper React / Vue

slideBlankClass строка "swiper-slide-пустой"

Имя CSS-класса пустого слайда, добавляемого в режиме цикла (при включенииloopAddBlankSlides).

Не поддерживается в Swiper React / Vue

slideClass строка "swiper-слайд"

Имя CSS-класса слайда

При изменении классов вам также потребуется изменить CSS Swiper, чтобы отразить изменения в классах

Не поддерживается в компонентах Swiper React / Vue

slideFullyVisibleClass строка "swiper-слайд-полностью-виден"

Имя CSS-класса для полностью (когда весь слайд находится в области просмотра) видимого слайда

Не поддерживается в Swiper React / Vue

slideNextClass строка "swiper-slide-next"

Имя CSS-класса слайда, которое находится сразу после текущего активного слайда

При изменении классов вам также потребуется изменить CSS Swiper, чтобы отразить изменения в классах

Не поддерживается в Swiper React / Vue

slidePrevClass строка 'swiper-slide-предыдущий'

CSS-класс slide, который находится прямо перед текущим активным слайдом

При изменении классов вам также потребуется изменить CSS Swiper, чтобы отразить изменения в классах

Не поддерживается в Swiper React / Vue

slideToClickedSlide логическое значение ложь

Установите значениеtrueи нажмите на любой слайд, чтобы перейти к этому слайду

slideVisibleClass строка "видимый слайд swiper"

Имя CSS-класса текущего / частично видимого слайда

При изменении классов вам также потребуется изменить CSS Swiper, чтобы отразить изменения в классах

Не поддерживается в Swiper React / Vue

slidesoffset после номер 0

Добавьте (в пикселях) дополнительное смещение слайда в конце контейнера (после всех слайдов)

slidesOffsetBefore номер 0

Добавьте (в пикселях) дополнительное смещение слайда в начале контейнера (перед всеми слайдами)

slidesPerGroup номер 1

Задайте количество слайдов для определения и включения группового скольжения. Полезно использовать с slidesPerView > 1

slidesPerGroupAuto логическое значение ложь

Этот параметр предназначен для использования только сslidesPerView: 'auto'иslidesPerGroup: 1. Если он включен, то при вызове методов.slideNext()и.slidePrev()будут пропускаться все слайды в режиме просмотра, при нажатии «кнопок» навигации и при автозапуске.

slidesPerGroupSkip номер 0

Параметр работает следующим образом: ЕслиslidesPerGroupSkipравно0(по умолчанию), слайды не исключаются из группировки, и результат будет таким же, как и без этого изменения.

ЕслиslidesPerGroupSkipравно или больше1, то первые X слайдов рассматриваются как отдельные группы, а все последующие слайды группируются по значениюslidesPerGroup

Просмотр слайдов номер|"авто" 1

Количество слайдов на один просмотр (количество слайдов, одновременно отображаемых в контейнере слайдера).

slidesPerView: 'auto'в настоящее время не поддерживается многострочный режим, когдаgrid.rows> 1

Расстояние между строка|номер 0

Расстояние между слайдами в пикселях.

Если вы используете свойство CSS «margin» для элементов, которые входят в Swiper и в которые вы передаёте параметр «spaceBetween», навигация может работать некорректно.

Скорость номер 300

Продолжительность перехода между слайдами (в мс)

Манипулятор прокрутки Любой null

Строка с CSS-селектором или HTML-элементом контейнера с разбивкой на страницы, которая будет работать как единственный доступный обработчик для прокрутки

swiperElementNodeName строка "SWIPER-КОНТЕЙНЕР"

Имя узла элемента swiper; используется для определения рендеринга веб-компонента

пороговое значение номер 5

Пороговое значение в пикселях. Если «расстояние касания» будет меньше этого значения, то свиппер не будет перемещаться

большие пальцы Любой

Объект с параметрами компонента thumbs

const swiper = new Swiper('.swiper', {
  ...
  thumbs: {
    swiper: thumbsSwiper
  }
});
Touchangle'а номер 45

Допустимый угол (в градусах) для запуска сенсорного перемещения

touchEventsTarget 'контейнер'|'обёртка' "оболочка"

Целевой элемент для прослушивания событий касания. Может быть'container'(для прослушивания событий касания на слайдере) или'wrapper'(для прослушивания событий касания на оболочке слайдера)

touchMoveStopPropagation логическое значение ложь

Если эта функция включена, то распространение события «касание» будет остановлено

Сенсорное управЛение номер 1

Коэффициент соприкосновения

touchReleaseOnEdges логическое значение ложь

Включите отработку событий касания в крайних положениях ползунка (начало, конец), чтобы обеспечить дальнейшую прокрутку страницы. Эта функция работает только с событиями касания (а не с событиями указателя), поэтому она будет работать на устройствах iOS/Android и не будет работать на устройствах Windows с событиями указателя. Такжеthresholdпараметр должен быть установлен на0

touchStartForcePreventDefault логическое значение ложь

Принудительно всегда предотвращать событие по умолчанию дляtouchstart(pointerdown)

touchStartPreventDefault логическое значение верно

Если он отключен,pointerdownсобытие не будет предотвращено

Уникальные возможности логическое значение верно

Если включено (по умолчанию) и параметры элементов навигации передаются в виде строки (например,".pagination"), то Swiper сначала будет искать такие элементы среди дочерних элементов. Применяется для нумерации страниц, кнопок «предыдущая»/«следующая» и элементов полосы прокрутки

Обновите размер окна логическое значение верно

Swiper будет пересчитывать положение слайдов при изменении размера окна (ориентации)

url нулевая|строка null

Требуется для активного обнаружения слайдов при рендеринге на стороне сервера и включенной истории

Пользовательский агент нулевая|строка null

строка userAgent. Требуется для определения браузера/устройства при рендеринге на стороне сервера

виртуальный Любой

Включает функцию виртуальных слайдов. Объект с параметрами виртуальных слайдов или логическое значениеtrueдля включения с настройками по умолчанию.

const swiper = new Swiper('.swiper', {
  virtual: {
    slides: ['Slide 1', 'Slide 2', 'Slide 3', 'Slide 4', 'Slide 5'],
  },
});
Виртуальный перевод логическое значение ложь

Если вы включите эту опцию, слайдер будет работать как обычно, за исключением того, что он не будет перемещаться, а значения реального перемещения на обёртке не будут заданы. Полезно, если вам нужно создать собственный переход слайдов

watchOverflow логическое значение верно

При включении Swiper будет отключён и скроет кнопки навигации, если для скольжения недостаточно слайдов.

watchSlidesProgress логическое значение ложь

Включите эту функцию, чтобы рассчитать прогресс и видимость каждого слайда (слайды в области просмотра будут иметь дополнительный класс видимости)

ширина нулевой|номер null

Ширина Swiper (в пикселях). Параметр позволяет задать ширину Swiper. Полезно только в том случае, если вы инициализируете Swiper, когда он скрыт, а также в средах SSR и Test для правильной инициализации Swiper

Установка этого параметра приведет к тому, что Swiper перестанет реагировать

КЛАСС -оболочка строка "swiper-оболочка"

Имя CSS-класса оболочки слайдов

При изменении классов вам также потребуется изменить CSS Swiper, чтобы отразить изменения в классах

Не поддерживается в Swiper React / Vue

масштабирование Любой

Включает функцию масштабирования. Объект с параметрами масштабирования или логическое значениеtrueдля включения с настройками по умолчанию

const swiper = new Swiper('.swiper', {
  zoom: {
    maxRatio: 5,
  },
});

Методы и свойства

После инициализации Slider мы получаем его инициализированный экземпляр в переменной (например, переменнаяswiperв приведённом выше примере) с полезными методами и свойствами:

Свойства
swiper.a11y Любой
swiper.activeIndex номер

Индексный номер текущего активного слайда

Обратите внимание, что в режиме цикла значение активного индекса всегда будет смещаться на количество циклов

swiper.allowSlideNext логическое значение

Отключите / включите возможность перехода к следующим слайдам, присвоивfalse/trueэтому свойству

swiper.allowSlidePrev логическое значение

Отключите / включите возможность перехода к предыдущим слайдам, присвоивfalse/trueэтому свойству

swiper.allowTouchMove логическое значение

Отключите / включите возможность перемещать ползунок, захватив его мышью или коснувшись пальцем (на сенсорных экранах), назначивfalse/trueдля этого свойства

swiper.анимация логическое значение

trueесли swiper находится на переходном этапе

swiper.автозапуск Любой
swiper.cardэффект Любой
swiper.clickedIndex номер

Индексный номер последнего нажатого слайда

swiper.clickedSlide HTMLЭлемент

Ссылка на слайд, на который щелкнули последним (HTMLElement)

swiper.контроллер Любой
swiper.coverflowEffect Любой
swiper.creativeffect Любой
swiper.cubeEffect Любой
swiper.defaults Любой

Параметры Swiper по умолчанию

swiper.el HTMLЭлемент

HTML-элемент контейнера слайдера

swiper.extendedDefaults Любой

Объект с глобальными расширенными опциями Swiper

swiper.fadeEffect Любой
swiper.flipEffect Любой
swiper.свободный режим Любой
swiper.хэшнавигация Любой
swiper.height номер

Высота контейнера

swiper.история Любой
swiper.isBeginning логическое значение

trueесли ползунок находится в крайнем левом/верхнем положении

swiper.isEnd логическое значение

trueесли ползунок находится в крайнем «правом»/«нижнем» положении

swiper.isLocked логическое значение

trueесли слайд «заблокирован» (с помощьюwatchOverflow) и слайды не могут быть, например, когда количество слайдов меньше, чем количество просмотров

swiper.клавиатура Любой
swiper.колесо мыши Любой
swiper.навигация Любой
swiper.originalParams Любой

Объект с исходными параметрами инициализации

swiper.разбивка на страницы Любой
swiper.параллакс Любой
swiper.параметры Любой

Объект с переданными параметрами инициализации

swiper.Предыдущий индекс номер

Индексный номер ранее активного слайда

swiper.прогресс номер

Текущий прогресс перевода оболочки (с 0 на 1)

swiper.realIndex номер

Индексируйте количество активных в данный момент слайдов с учетом переставленных слайдов в режиме цикла

swiper.полоса прокрутки Любой
swiper.слайды HTMLЭлемент[]

Массив HTML-элементов slides. Чтобы получить конкретный HTMLЭлемент slide, используйтеswiper.slides[1]

swiper.snapGrid номер []

Скользит по сетке привязки

swiper.snapIndex номер

Индексный номер текущей оснасткиsnapGrid

swiper.swipeDirection 'предыдущая'|'следующая'

Направление скольжения

swiper.thumbs Любой
swiper.касания объект

Объект со следующими свойствами события касания:

  • swiper.touches.startX
  • swiper.touches.startY
  • swiper.touches.currentX
  • swiper.touches.currentY
  • swiper.touches.diff
swiper.translate номер

Текущее значение wrapper translate

swiper.virtual Любой
swiper.width номер

Ширина контейнера

swiper.wrapperEl HTMLЭлемент

HTML-элемент-оболочка

swiper.zoom Любой
Методы
swiper.attachEvents()

Снова подключите все прослушиватели событий

swiper.changeDirection(направление,требуется обновление)

Изменяет направление ползунка с горизонтального на вертикальное и обратно.

  • направление'горизонтальное'|'вертикальное'— новое направление. Если не указано, то автоматически изменится на противоположное направление
  • needUpdateлогическое значение— вызовет функцию swiper.update(). По умолчанию true
swiper.changeLanguageDirection(направление)

Изменяет язык слайдера

  • направление'rtl'|'ltr'— новое направление. Должно быть `rtl` или `ltr`
swiper.destroy(удаление,чистые стили)

Уничтожьте экземпляр слайдера и отсоедините все прослушиватели событий

  • deleteInstanceлогическое значение— установите значение false (по умолчанию оно равно true), чтобы не удалять экземпляр Swiper
  • cleanStylesлогическое значение— установите значение true (по умолчанию оно равно true), и все пользовательские стили будут удалены из слайдов, обертки и контейнера. Полезно, если вам нужно уничтожить Swiper и инициализировать его заново с новыми параметрами или в другом направлении
swiper.detachEvents()

Отсоединить все прослушиватели событий

swiper.отключить()

Отключите Swiper (если он был включён). Когда Swiper будет отключен, он скроет все элементы навигации и не будет реагировать на какие-либо события и взаимодействия

swiper.emit(событие,аргументы)

Событие срабатывания в экземпляре

swiper.enable()

Включить Swiper (если он был отключен)

swiper.extendDefaults(опции)

Расширение глобальных настроек Swiper по умолчанию

swiper.getTranslate()

Получить текущее значение swiper wrapper css3 transform translate

swiper.init(el)

Инициализировать слайдер

swiper.maxTranslate()

Получить текущее максимальное значение перевода

swiper.minTranslate()

Получить текущее минимальное значение перевода

swiper.off(событие,обработчик)

Удалить обработчик событий

swiper.offAny(обработчик)

Удалить прослушиватель событий, который будет запускаться при всех событиях

swiper.on(событие,обработчик)

Добавить обработчик событий

swiper.onAny(обработчик)

Добавьте прослушиватель событий, который будет запускаться при всех событиях

swiper.once(событие,обработчик)

Добавьте обработчик событий, который будет удален после его запуска

swiper.setGrabCursor()

Установить курсор захвата

swiper.setProgress(прогресс,скорость)

Задайте значение прогресса перемещения Swiper (от 0 до 1). Где 0 — начальная позиция (смещение) на первом слайде, а 1 — максимальная позиция (смещение) на последнем слайде

  • прогрессчисло— прогресс перевода Swiper (от 0 до 1).
  • скорость-число- Длительность перехода (в мс).
swiper.setTranslate(переводить)

Установите значение translate пользовательского преобразования css3 для swiper wrapper

swiper.slideNext(скорость,обратные вызовы)

Запустите переход к следующему слайду.

  • скорость-число- Длительность перехода (в мс).
  • runCallbacksлогическое значение— установите значение false (по умолчанию оно равно true), и переход не будет генерировать события перехода.
swiper.slidePrev(скорость,обратные вызовы)

Запустите переход к предыдущему слайду.

  • скорость-число- Длительность перехода (в мс).
  • runCallbacksлогическое значение— установите значение false (по умолчанию оно равно true), и переход не будет генерировать события перехода.
swiper.slideReset(скорость,обратные вызовы)

Сбросьте положение слайдера до текущего активного слайда на время, равное параметру «скорость».

  • скорость-число- Длительность перехода (в мс).
  • runCallbacksлогическое значение— установите значение false (по умолчанию оно равно true), и переход не будет генерировать события перехода.
swiper.slideTo(индекс,скорость,обратные вызовы)

Выполните переход к слайду с номером, равным параметру «index», в течение времени, равного параметру «speed».

  • index-число- порядковый номер слайда.
  • скорость-число- Длительность перехода (в мс).
  • runCallbacksлогическое значение— установите значение false (по умолчанию оно равно true), и переход не будет генерировать события перехода.
swiper.slideToClosest(скорость,обратные вызовы)

Сбросьте положение ползунка до ближайшей точки перехода/фиксации на время, равное параметру «скорость».

  • скорость-число- Длительность перехода (в мс).
  • runCallbacksлогическое значение— установите значение false (по умолчанию оно равно true), и переход не будет генерировать события перехода.
swiper.slideToLoop(индекс,скорость,выполнить обратные вызовы)

Делает то же самое, что и .slideTo, но для случая, когда используется с включённым циклом. Таким образом, этот метод будет переходить к слайдам с realIndex, соответствующим переданному индексу

  • index-число- порядковый номер слайда.
  • скорость-число- Длительность перехода (в мс).
  • runCallbacksлогическое значение— установите значение false (по умолчанию оно равно true), и переход не будет генерировать события перехода.
swiper.slidesPerViewDynamic()

Получите динамически рассчитываемое количество слайдов на просмотр, полезно только в том случае, если для slidesPerView установлено значениеauto

swiper.translateTo(translate,скорость,запускать обратные вызовы,переводить границы)

Анимируйте пользовательское значение преобразования CSS3 для обёртки Swiper

  • translate-число- Перевод значения (в пикселях)
  • скорость-количество- Длительность перехода (в мс)
  • runCallbacksлогическое значение— установите значение false (по умолчанию оно равно true), и переход не будет генерировать события перехода
  • translateBoundsлогическое значение— установите значение false (по умолчанию оно равно true), и значение перехода может выходить за пределы минимального и максимального значений translate
swiper.unsetGrabCursor()

Сбросить курсор захвата

swiper.update()

Вы должны вызывать его после добавления/удаления слайдов вручную, после их скрытия/показа или выполнения любых пользовательских изменений DOM с помощью Swiper. Этот метод также включает в себя вызов следующих методов, которые можно использовать отдельно:

swiper.updateAutoHeight(скорость)

Заставьте свипер обновлять высоту (при включенном параметре autoHeight) в течение времени, равного параметру «скорость»

  • скорость-число- Длительность перехода (в мс).
swiper.UpdateProgress()

пересчитать прогресс swiper

swiper.updateSize()

пересчитайте размер контейнера swiper

swiper.updateSlides()

пересчитать количество слайдов и их смещения. Полезно после добавления/удаления слайдов с помощью JavaScript

swiper.updateSlidesClasses()

обновите активные / предыдущие / следующие классы на слайдах и маркерах

swiper.use(модули)

Устанавливает модули на Swiper во время выполнения.

Мероприятия

Swiper содержит множество полезных событий, которые вы можете прослушать. События можно назначать двумя способами:

  1. Использованиеonпараметра при инициализации swiper:

    const swiper = new Swiper('.swiper', {
      // ...
      on: {
        init: function () {
          console.log('swiper initialized');
        },
      },
    });
    
  2. Использование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. Получаетpointerupсобытие в качестве аргумента.

уничтожить (swiper)

Событие будет запущено при уничтожении swiper

Двойной щелчок (swiper, событие)

Событие будет запущено, когда пользователь дважды щелкнет по Swiper

Двойной щелчок (swiper, событие)

Событие будет запущено, когда пользователь дважды коснётся контейнера Swiper. Получаетpointerupсобытие в качестве аргумента

fromEdge (swiper)

Событие будет запущено, когда Swiper перейдет из начальной или конечной позиции

инициализация (swiper)

Сработал сразу после инициализации Swiper.

Обратите внимание, что синтаксисswiper.on('init')будет работать только в том случае, если вы зададите параметрinit: false

const swiper = new Swiper('.swiper', {
  init: false,
  // other parameters
});
swiper.on('init', function() {
 // do something
});
// init Swiper
swiper.init();
// Otherwise use it as the parameter:
const swiper = new Swiper('.swiper', {
  // other parameters
  on: {
    init: function () {
      // do something
    },
  }
});
блокировка (swiper)

Событие будет запущено, когда swiper заблокирован (когдаwatchOverflowвключено)

Исправление цикла (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 и проведёт по нему пальцем. Получаетpointermoveсобытие в качестве аргумента.

slidesGridLengthChange (swiper)

Событие будет запущено при изменении сетки слайдов

Изменение длины слайда (swiper)

Событие будет запущено при изменении количества слайдов

Обновлено слайд-шоу (swiper)

Событие будет запущено после того, как слайды и их размеры будут рассчитаны и обновлены

snapGridLengthChange (swiper)

Событие будет запущено при изменении привязки сетки

snapIndexChange (swiper)

Событие будет запущено при изменении индекса привязки

нажмите (swiper, событие)

Событие будет запущено, когда пользователь нажмёт/коснётся Swiper. Получаетpointerupсобытие в качестве аргумента.

toEdge (swiper)

Событие будет запущено, когда Swiper перейдет в начальную или конечную позицию

touchEnd (swiper, событие)

Событие будет запущено, когда пользователь отпустит Swiper. Получаетpointerupсобытие в качестве аргумента.

touchMove (swiper, событие)

Событие будет запущено, когда пользователь коснётся Swiper и проведёт по нему пальцем. Получаетpointermoveсобытие в качестве аргумента.

touchMoveOpposite (swiper, событие)

Событие будет запущено, когда пользователь коснётся Swiper и проведёт пальцем в направлении, противоположном параметру направления. Получаетpointermoveсобытие в качестве аргумента.

Сенсорный запуск (swiper, событие)

Событие будет запущено, когда пользователь коснётся Swiper. Получаетpointerdownсобытие в качестве аргументов.

Завершение перехода (swiper)

Событие будет запущено после перехода.

Начало перехода (swiper)

Событие будет запущено в начале перехода.

разблокировать (swiper)

Событие будет запущено, когда swiper будет разблокирован (когдаwatchOverflowвключено)

Обновить (swiper)

Событие будет запущено после вызова swiper.update()

Модули

Имя Тип По умолчанию Описание
Отключенный класс строка "swiper-кнопка-отключена"

Имя класса CSS добавляется к кнопке навигации, когда она становится отключенной

включен логическое значение

Логическое свойство для использования с точками останова, чтобы включить/отключить навигацию по определённым точкам останова

Скрытый класс строка "swiper-кнопка-скрыта"

Имя класса CSS добавляется к кнопке навигации, когда она становится скрытой

Скрытый клик логическое значение ложь

Переключать видимость кнопок навигации после нажатия на контейнер слайдера

Класс блокировки строка "swiper-блокировка кнопок"

Имя класса CSS добавляется к кнопке навигации, когда она отключена

navigationDisabledClass строка "swiper-навигация-отключена"

Имя CSS-класса добавлено в контейнер swiper, когда навигация отключена точкой останова

nextEl Любой null

Строка с CSS-селектором или HTML-элементом элемента, который будет работать как кнопка «Далее» после нажатия на неё

превЕл Любой null

Строка с CSS-селектором или HTML-элементом элемента, который будет работать как кнопка «предыдущая» после нажатия на неё

Свойства
swiper.nextEl HTMLЭлемент

HTMLЭлемент навигационной кнопки "далее"

swiper.превЕл HTMLЭлемент

HTMLЭлемент кнопки навигации "предыдущий"

Методы
swiper.уничтожить()

Уничтожить навигацию

swiper.init()

Инициализация навигации

swiper.update()

Обновить состояние кнопок навигации (включено / отключено)

Имя Аргументы Описание
Скрытая навигация (swiper)

Событие будет запущено при скрытии навигации

navigationNext (swiper)

Событие будет запущено при следующем нажатии кнопки навигации

Руководство по навигации (swiper)

Событие будет запущено при нажатии предыдущей кнопки навигации

Навигационное шоу (swiper)

Событие будет запущено при показе навигации

 {
  --swiper-navigation-size: 44px;
  --swiper-navigation-top-offset: 50%;
  --swiper-navigation-sides-offset: 10px;
  --swiper-navigation-color: var(--swiper-theme-color);
}

Разбивка на страницы

Параметры разбивки на страницы

Имя Тип По умолчанию Описание
bulletActiveClass строка "swiper-разбивка на страницы-маркер-активен"

Имя CSS-класса для маркера разбиения на страницы, активного в данный момент

Маркированный класс строка "swiper-разбивка на страницы-маркер"

Имя CSS-класса для отдельного маркера разбивки на страницы

bulletElement строка "диапазон"

Определяет, какой HTML-тег будет использоваться для отображения одиночной кнопки постраничной навигации. Только для'bullets'типа постраничной навигации.

кликабельный логическое значение ложь

Еслиtrueто нажатие на кнопку разбивки на страницы приведёт к переходу на соответствующий слайд. Только для типа разбивки на страницы с помощью маркеров

clickableClass строка "swiper-разбивка на страницы-кликабельный"

Имя CSS-класса устанавливается в разбивку на страницы, когда оно доступно для кликабельности

Текущий класс строка "swiper-разбивка на страницы-текущая"

Имя CSS-класса элемента с текущим активным индексом в «фрагментарной» разбивке на страницы

Динамические пакеты логическое значение ложь

Рекомендуется включить эту функцию, если вы используете нумерацию слайдов с помощью маркеров. Таким образом, одновременно будет отображаться только несколько маркеров.

dynamicMainBullets номер 1

Количество основных маркеров, видимых приdynamicBulletsвключении.

el Любой null

Строка с CSS-селектором или HTML-элементом контейнера с разбиением на страницы

включен логическое значение

Логическое свойство для использования с точками останова, чтобы включить/отключить разбиение на страницы в определённых точках останова

formatFractionCurrent функция (номер)

отформатируйте дробную часть текущего номера. Функция получает текущий номер, и вам нужно вернуть отформатированное значение

formatFractionTotal функция (номер)

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

Скрытый класс строка "swiper-разбиение на страницы-скрыто"

Имя класса CSS для разбивки на страницы, когда он становится неактивным

Скрытый клик логическое значение верно

Переключение (скрытие/показ) видимости контейнера разбивки на страницы после нажатия на контейнер слайдера

Горизонтальный класс строка "swiper-разбивка на страницы-горизонтальная"

Имя CSS-класса, заданное для разбиения на страницы в горизонтальном Swiper

Класс блокировки строка 'swiper-блокировка разбивки на страницы'

Имя класса CSS устанавливается в разбивку на страницы, когда оно отключено

Модифицирующий класс строка 'swiper-разбивка на страницы-'

Начало имени CSS-класса модификатора, который будет добавлен к разбивке на страницы в зависимости от параметров

paginationDisabledClass строка "swiper-разбивка на страницы-отключена"

Имя CSS-класса, добавляемое к контейнеру Swiper и элементу разбивки на страницы, когда разбивка на страницы отключена из-за точки останова

progressbarFillClass строка "swiper-разбивка на страницы-панель выполнения-заполнение"

Имя CSS-класса элемента заполнения панели прогресса разбивки на страницы

progressbaroposite логическое значение ложь

Делает индикатор выполнения противоположным параметру Swiperdirection: вертикальный индикатор выполнения для горизонтального направления Swiper и горизонтальный индикатор выполнения для вертикального направления Swiper

progressbarOppositeClass строка «swiper-pagination-progressbar-opposite»

Имя CSS-класса панели прогресса разбивки на страницы напротив

renderBullet функция (индекс,имя_класса)

Этот параметр позволяет полностью настроить маркеры нумерации страниц. Вам нужно передать сюда функцию, которая принимаетindexколичество маркеров нумерации страниц и имя класса необходимого элемента (className). Только для'bullets'типа нумерации

const swiper = new Swiper('.swiper', {
  //...
  renderBullet: function (index, className) {
    return '<span class="' + className + '">' + (index + 1) + '</span>';
  }
});
Настройка визуализации функция (swiper,текущий,общий)

Этот параметр необходим для типа разбиения на страницы'custom', где нужно указать способ отображения.

const swiper = new Swiper('.swiper', {
  //...
  renderCustom: function (swiper, current, total) {
    return current + ' of ' + total;
  }
});
Преобразование рендеринга функция (currentClass,totalClass)

Этот параметр позволяет настроить «дробную» нумерацию страниц в HTML. Только для'fraction'типа нумерации

const swiper = new Swiper('.swiper', {
  //...
  renderFraction: function (currentClass, totalClass) {
      return '<span class="' + currentClass + '"></span>' +
              ' of ' +
              '<span class="' + totalClass + '"></span>';
  }
});
renderProgressbar функция(progressbarFillClass)

Этот параметр позволяет настроить «прогрессивную» разбивку на страницы. Только для'progress'типа разбивки на страницы

const swiper = new Swiper('.swiper', {
  //...
  renderProgressbar: function (progressbarFillClass) {
      return '<span class="' + progressbarFillClass + '"></span>';
  }
});
Общий класс строка "swiper-разбивка на страницы-всего"

Имя CSS-класса элемента с общим количеством «отрывков» в «дробной» нумерации

Тип 'индикатор выполнения'|'маркеры'|'дробь'|'пользовательский' "пули"

Строка с типом нумерации страниц. Может быть'bullets','fraction','progressbar'или'custom'

Вертикальный класс строка "swiper-разбивка на страницы-по вертикали"

Имя CSS-класса, заданное для разбиения на страницы в вертикальном Swiper

Методы разбивки на страницы

Свойства
swiper.пули HTMLЭлемент[]

Массив HTML-элементов маркеров разбивки на страницы. Чтобы получить конкретный HTML-элемент слайда, используйтеswiper.pagination.bullets[1].

swiper.el HTMLЭлемент

HTMLЭлемент элемента контейнера для разбивки на страницы

Методы
swiper.уничтожить()

Уничтожить разбивку на страницы

swiper.init()

Инициализировать разбивку на страницы

swiper.render()

Визуализировать макет разбивки на страницы

swiper.update()

Обновить состояние разбивки на страницы (включено / отключено / активно)

События разбивки на страницы

Имя Аргументы Описание
Отображение страниц (swiper)

Событие будет запущено при разбиении на страницы скрыть

paginationRender (swiper, paginationEl)

Событие будет запущено после отображения разбивки на страницы

Отображение страниц (swiper)

Событие будет запущено при разбиении на страницы show

Обновление страницы (swiper, paginationEl)

Событие будет запущено при обновлении разбивки на страницы

Пользовательские свойства 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;
}

Полоса прокрутки

Параметры полосы прокрутки

Имя Тип По умолчанию Описание
Класс перетаскивания строка "swiper-полоса прокрутки-перетаскивание"

CSS-класс перетаскиваемого элемента полосы прокрутки

Размер перетаскивания номер|"авто" "авто"

Размер перетаскиваемого элемента полосы прокрутки в пикселях

перетаскиваемый логическое значение ложь

Установите значениеtrueдля включения перетаскивания полосы прокрутки, что позволит вам управлять положением ползунка

el Любой null

Строка с CSS-селектором или HTML-элементом контейнера с полосой прокрутки.

включен логическое значение

Логическое свойство для использования с точками останова для включения/отключения полосы прокрутки в определённых точках останова

скрыть логическое значение верно

Автоматически скрывает полосу прокрутки после взаимодействия с пользователем

Горизонтальный класс строка "swiper-полоса прокрутки-горизонтальная"

Имя класса CSS, заданное как полоса прокрутки в горизонтальном Swiper

Класс блокировки строка "swiper-полоса прокрутки-блокировка"

Элемент полосы прокрутки - дополнительный CSS-класс, когда он отключен

scrollbarDisabledClass строка "swiper-полоса прокрутки-отключена"

Имя CSS-класса, добавляемого к контейнеру Swiper и элементу полосы прокрутки, когда полоса прокрутки отключена в точке останова

snapOnRelease логическое значение ложь

Установите значениеtrueдля привязки положения ползунка к слайдам при отпускании полосы прокрутки

Вертикальный класс строка "swiper-полоса прокрутки-вертикальная"

Имя класса CSS, заданное как полоса прокрутки в вертикальном Swiper

Методы полосы прокрутки

Свойства
swiper.dragEl HTMLЭлемент

HTMLЭлемент перетаскиваемого элемента обработчика полосы прокрутки

swiper.el HTMLЭлемент

HTMLЭлемент элемента контейнера полосы прокрутки

Методы
swiper.уничтожить()

Уничтожить полосу прокрутки

swiper.init()

Инициализировать полосу прокрутки

swiper.setTranslate()

Обновляет перевод полосы прокрутки

swiper.updateSize()

Обновляет дорожку полосы прокрутки и размеры обработчика

События полосы прокрутки

Имя Аргументы Описание
scrollbarDragEnd (swiper, событие)

Событие будет запущено при перетаскивании перетаскиваемой полосы прокрутки

scrollbarDragMove (swiper, событие)

Событие будет запущено при перетаскивании полосы прокрутки drag move

scrollbarDragStart (swiper, событие)

Событие будет запущено при запуске перетаскиваемой полосы прокрутки drag start

Пользовательские свойства 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;
}

Автоматическое воспроизведение

Параметры автозапуска

Имя Тип По умолчанию Описание
задержка номер 3000

Задержка между переходами (в мс). Если этот параметр не указан, автоматическая игра будет отключена

Если вам нужно указать разную задержку для определённых слайдов, вы можете сделать это с помощью атрибутаdata-swiper-autoplay(в миллисекундах) на слайде.

<!-- hold this slide for 2 seconds -->
<div class="swiper-slide" data-swiper-autoplay="2000">
отключениевзаимодействия логическое значение верно

Установите значениеfalseи автозапуск не будет отключаться после взаимодействия с пользователем (пролистывания), он будет запускаться каждый раз после взаимодействия

pauseOnMouseEnter логическое значение ложь

Если функция включена, автовоспроизведение будет приостановлено при наведении указателя (мыши) на контейнер Swiper.

Обратное направление логическое значение ложь

Включает автозапуск в обратном направлении

stopOnLastSlide логическое значение ложь

Включите этот параметр, и автоматическое воспроизведение будет остановлено, когда вы дойдёте до последнего слайда (не действует в режиме повтора)

Ожидание перехода логическое значение верно

При включённой функции автозапуска будет ожидаться завершение перехода оболочки. Можно отключить в случае использования Virtual Translate, когда ваш слайдер может не иметь перехода

Методы автозапуска

Свойства
swiper.приостановлено логическое значение

Приостановлено ли автозапуск

swiper.running логическое значение

Включено ли и работает ли автозапуск

swiper.TimeLeft номер

Если автовоспроизведение приостановлено, отображается оставшееся время (в мс) до перехода к следующему слайду

Методы
swiper.pause()

Приостановить автозапуск

swiper.resume()

Возобновить автозапуск

swiper.start()

Запустить автозапуск

swiper.stop()

Остановить автозапуск

Автоматическое воспроизведение событий

Имя Аргументы Описание
автоматическое воспроизведение (swiper)

Событие будет запущено при смене слайда с помощью автозапуска

Автозапуск (swiper)

Событие будет запущено при приостановке автозапуска

Автоматическое воспроизведение (swiper)

Событие будет запущено при возобновлении автозапуска

Автозапуск (swiper)

Событие будет запущено при запуске автозапуска

Автоматическая остановка воспроизведения (swiper)

Событие будет запущено при остановке автозапуска

Выбор времени автозапуска (swiper, временное отклонение, процент)

Событие запускается непрерывно, пока включена функция автозапуска. Оно содержит оставшееся время (в миллисекундах) до перехода к следующему слайду и процент этого времени, связанный с задержкой автозапуска

Бесплатный режим

Параметры свободного режима

Имя Тип По умолчанию Описание
включен логическое значение ложь

Включен ли бесплатный режим

Минимальная скорость номер 0.02

Минимальная скорость касания, необходимая для запуска импульса в свободном режиме

импульс логическое значение верно

Если включен, слайд будет продолжать двигаться некоторое время после того, как вы его отпустите

Мгновенный скачок логическое значение верно

Установите значениеfalse, если вы хотите отключить отскок импульса в бесплатном режиме

Мгновенное переключение номер 1

Более высокое значение создает больший эффект отскока импульса

Мгновенный анализ номер 1

Более высокое значение создает большее расстояние импульса после того, как вы отпустите ползунок

Мгновенная скорость номер 1

Более высокое значение приводит к увеличению скорости вращения после отпускания ползунка

липкий логическое значение ложь

Установите значение включено, чтобы включить привязку к позициям слайдов в свободном режиме

Сетка

Параметры сетки

Имя Тип По умолчанию Описание
заполнение 'строка'|'столбец' "столбец"

Может быть'column'или'row'. Определяет, как слайды должны заполнять строки, по столбцам или по строкам

при использовании в режиме повтора убедитесь, что количество слайдов указано в требованиях к режиму повтора, или включите параметрloopAddBlankSlides

строки номер 1

Количество строк слайдов для многострочной компоновки

Манипуляции

Удалить
Добавить

Модуль манипуляций добавляет полезные методы Swiper для управления слайдами. Его имеет смысл использовать только с версией Swiper Core, он не предназначен для использования с Swiper React или Vue.

Методы манипулирования

Методы
swiper.addSlide(индекс,слайды)

Добавьте новые слайды в нужный индекс. Слайды могут быть HTMLElement или строкой HTML с новым слайдом или массивом таких слайдов, например:

addSlide(1, '<div class="swiper-slide">Slide 10"</div>')

addSlide(1, [
 '<div class="swiper-slide">Slide 10"</div>',
 '<div class="swiper-slide">Slide 11"</div>'
]);
swiper.appendSlide(слайды)

Добавьте новые слайды в конец. Слайды могут быть HTMLElement или HTML-строкой с новым слайдом или массивом таких слайдов, например:

appendSlide('<div class="swiper-slide">Slide 10"</div>')

appendSlide([
 '<div class="swiper-slide">Slide 10"</div>',
 '<div class="swiper-slide">Slide 11"</div>'
]);
swiper.prependSlide(слайды)

Добавьте новые слайды в начало. Слайды могут быть HTMLElement или строкой HTML с новым слайдом или массивом таких слайдов, например:

prependSlide('<div class="swiper-slide">Slide 0"</div>')

prependSlide([
 '<div class="swiper-slide">Slide 1"</div>',
 '<div class="swiper-slide">Slide 2"</div>'
]);
swiper.removeAllSlides()

Удалить все слайды

swiper.удаляет слайд(slideIndex)

Удалите выбранные слайды. slideIndex может быть числом с индексом слайда для удаления или массивом с индексами.

removeSlide(0); // remove first slide
removeSlide([0, 1]); // remove first and second slides
removeAllSlides();    // Remove all slides

Параллакс

Swiper поддерживает эффекты перехода с эффектом параллакса для вложенных элементов swiper/slides. Поддерживаются два типа элементов с эффектом параллакса:

  • Прямые дочерние элементыswiper. Эффект параллакса для таких элементов будет зависеть от общего положения ползунка. Полезно для параллакс-фонов
  • Вложенные элементы слайдов. Эффект параллакса для таких элементов будет зависеть от хода слайда

Чтобы включить эффект параллакса, необходимо инициализировать Swiper с помощью переданного параметраparallax:trueи добавить один из следующих (или их сочетание) атрибутов к нужным элементам:

  • data-swiper-parallax- включить преобразование-перевод параллаксного перехода. Этот атрибут может принимать:
    • number- значение в пикселях (как для заголовка, подзаголовка в примере выше) для перемещения элемента в зависимости от прогресса. В этом случае такой элемент будет перемещён на ± это значение в пикселях в зависимости от положения слайда (следующий или предыдущий)
    • percentage- (как для «параллакс-фона») для перемещения элемента в зависимости от прогресса и его размера. В этом случае такой элемент будет перемещён на ± этот процент от его размера (ширины в горизонтальном направлении и высоты в вертикальном направлении) в зависимости от положения слайда (следующий или предыдущий). Таким образом, если ширина элемента составляет 400 пикселей, а вы указали data-swiper-parallax = «50%», то он будет перемещён на ± 200 пикселей
  • data-swiper-parallax-xто же самое, но для направления по оси x
  • data-swiper-parallax-yто же самое, но для направления по оси y
  • data-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, чтобы не видеть содержимое позади или под ним.

Параметры эффекта затухания

Имя Тип По умолчанию Описание
Перекрестное затухание логическое значение ложь

Позволяет слайдам перекрестно исчезать

Эффект Coverflow

Чтобы это сработало, убедитесь, что параметрeffectустановлен на'coverflow'

Параметры эффекта Coverflow

Имя Тип По умолчанию Описание
глубина номер 100

Смещение глубины в пикселях (слайды перемещаются по оси Z)

модификатор номер 1

Множитель эффекта

вращать номер 50

Поворот слайда в градусах

масштабирование номер 1

Эффект масштабирования слайдов

Тени для слайдов логическое значение верно

Позволяет создавать тени на слайдах

растягивание номер 0

Растянуть пространство между слайдами (в пикселях)

Эффект переворота

Чтобы это сработало, убедитесь, что параметрeffectустановлен на'flip'

Параметры эффекта переворота

Имя Тип По умолчанию Описание
Ограничение скорости логическое значение верно

Ограничение вращения краевых слайдов

Тени для слайдов логическое значение верно

Позволяет создавать тени на слайдах

Эффект куба

Чтобы это сработало, убедитесь, что параметрeffectустановлен на'cube'

Параметры эффекта куба

Имя Тип По умолчанию Описание
тень логическое значение верно

Включает тень основного слайдера

shadowOffset номер 20

Основное смещение тени в пикселях

Масштабирование теней номер 0.94

Коэффициент масштабирования основной тени

Тени для слайдов логическое значение верно

Позволяет создавать тени на слайдах

Эффект карт

Чтобы это сработало, убедитесь, что параметрeffectустановлен на'cards'

Параметры эффекта карт

Имя Тип По умолчанию Описание
perSlideOffset номер 8

Расстояние смещения для каждого слайда (в пикселях)

perSlideRotate номер 2

Угол поворота для каждого слайда (в градусах)

вращать логическое значение верно

Позволяет вращать карты

Тени для слайдов логическое значение верно

Позволяет создавать тени на слайдах

Творческий эффект

Чтобы это сработало, убедитесь, что параметрeffectустановлен на'creative'

Параметры креативного эффекта

Имя Тип По умолчанию Описание
limitProgress номер 1

Ограничьте прогресс/смещение количеством боковых слайдов. Если1, то все слайды после предыдущего/следующего будут иметь одинаковое состояние. Если2, то все слайды после второго активного до/после будут иметь одинаковое состояние и т. д.

Далее creativeffecttransform

Следующие преобразования слайдов.

{
  // Array with translate X, Y and Z values
  translate: (string | number)[];
  // Array with rotate X, Y and Z values (in deg)
  rotate?: number[];
  // Slide opacity
  opacity?: number;
  // Slide scale
  scale?: number;
  // Enables slide shadow
  shadow?: boolean;
  // Transform origin, e.g. `left bottom`
  origin?: string;
}
перспектива логическое значение верно

Включите этот параметр, если ваши пользовательские преобразования требуют 3D-преобразований (translateZ,rotateX,rotateY)

Пред. creativeffecttransform

Предыдущие преобразования слайдов. Принимает объект следующего типа:

{
  // Array with translate X, Y and Z values
  translate: (string | number)[];
  // Array with rotate X, Y and Z values (in deg)
  rotate?: number[];
  // Slide opacity
  opacity?: number;
  // Slide scale
  scale?: number;
  // Enables slide shadow
  shadow?: boolean;
  // Transform origin, e.g. `left bottom`
  origin?: string;
}
Умножитель прогресса номер 1

Позволяет многократно изменять прозрачность слайдов.

shadowPerProgress логическое значение ложь

Разделяет «непрозрачность» тени на каждом слайде в зависимости отlimitProgress(только если включена трансформация теней). Например, при установкеlimitProgress: 2и включенииshadowPerProgressнепрозрачность тени будет равна0.5и1на двух слайдах рядом с активным. Если этот параметр отключен, все слайды, кроме активного, будут иметь тень с непрозрачностью1

Большие пальцы

В дополнение к компонентуControllerSwiper поставляется с компонентом Thumbs, который предназначен для более корректной работы с дополнительным свайпером Thumbs, чем компонент Controller, используемый для синхронизации двух свайперов.

Параметры Thumbs

Имя Тип По умолчанию Описание
autoScrollOffset номер 0

Позволяет задать, на скольких активных слайдах от края должна автоматически перемещаться прокрутка. Например, если установлено значение 1 и будет активирован последний видимый слайд (1 от края), то будет автоматически прокручиваться

Несколько активных больших пальцев логическое значение верно

При включении может быть активировано несколько миниатюр слайдов

slideThumbActiveClass строка "swiper-slide-thumb-активный"

Дополнительный класс, который будет добавлен к активированному слайду thumbs swiper

swiper Любой null

Экземпляр Swiper, используемый в качестве больших пальцев, или объект с параметрами Swiper для инициализации больших пальцев Swiper

thumbsContainerClass строка "swiper-thumbs"

Дополнительный класс, который будет добавлен в thumbs swiper

Методы 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-zoom-контейнер"

Имя CSS-класса контейнера масштабирования

Ограниченный исходный размер логическое значение ложь

Если установлено значение true, изображение не будет масштабироваться более чем на 100% от исходного размера

Максимальная скорость номер 3

Максимальный множитель масштабирования изображения

Минимизация номер 1

Минимальный множитель масштабирования изображения

переключение логическое значение верно

Включение / отключение увеличения двойным касанием слайда

Увеличенный скользящий класс строка "swiper-слайд-масштабирование"

Имя CSS-класса увеличенного контейнера

Методы масштабирования

Свойства
swiper.включен логическое значение

Включен ли модуль масштабирования

swiper.scale номер

Текущее соотношение масштаба изображения

Методы
swiper.отключить()

Отключить модуль масштабирования

swiper.enable()

Включить модуль масштабирования

swiper.in(соотношение)

Увеличьте изображение текущего активного слайда. При необходимости можно задать собственное соотношение сторон

swiper.out()

Уменьшите масштаб изображения текущего активного слайда

swiper.toggle(событие)

Переключение масштаба изображения текущего активного слайда

Масштабирование событий

Имя Аргументы Описание
Изменение масштаба (swiper, масштабирование, imageEl, slideEl)

Событие будет запущено при изменении масштаба

Управление с клавиатуры

Параметры управления клавиатурой

Имя Тип По умолчанию Описание
включен логическое значение ложь

Установите значениеtrue, чтобы включить управление с клавиатуры

onlyInViewport логическое значение верно

Когда он включен, он будет управлять ползунками, которые в данный момент находятся в окне просмотра

Отображение страницы логическое значение верно

Когда он включен, он позволяет осуществлять навигацию по клавиатуре с помощью клавиш Page Up и Page Down

Методы управления клавиатурой

Свойства
swiper.включен логическое значение

Включено ли управление с клавиатуры

Методы
swiper.отключить()

Отключить управление с клавиатуры

swiper.enable()

Включить управление с клавиатуры

События клавиатуры

Имя Аргументы Описание
Нажатие клавиши (swiper, ключевой код)

Событие будет запущено при нажатии клавиши

Управление колесиком мыши

Параметры управления колесиком мыши

Имя Тип По умолчанию Описание
включен логическое значение ложь

Установите значениеtrue, чтобы включить управление колесом мыши

eventsTarget Любой "контейнер"

Строка с CSS-селектором или HTML-элементом контейнера, принимающего события колесика мыши. По умолчанию это swiper

Силовая ось логическое значение ложь

Установите значениеtrueдля принудительного прокручивания колесика мыши по оси. Таким образом, в горизонтальном режиме колесико мыши будет работать только при горизонтальной прокрутке, а в вертикальном режиме — только при вертикальной прокрутке.

инвертировать логическое значение ложь

Установите значениеtrueдля инвертирования направления скольжения

Класс noMousewheelClass строка "swiper-без колеса мыши"

Прокрутка элементов с этим классом будет игнорироваться

Возможности выпуска логическое значение ложь

Установите значениеtrueи swiper будет отключать событие прокрутки колесом мыши и позволять прокручивать страницу, когда swiper находится на краю (в начале или в конце)

чувствительность номер 1

Множитель данных о колесе мыши, позволяет настроить чувствительность колесика мыши

thresholdDelta нулевой|номер null

Минимальная дельта прокрутки колесика мыши для запуска смены слайда swiper

Время удержания порога нулевой|номер null

Минимальная разница во времени прокрутки колесика мыши (в мс) для запуска смены слайдов в свипере

Методы управления колесиком мыши

Свойства
swiper.включен логическое значение

Включено ли управление колесиком мыши

Методы
swiper.отключить()

Отключить управление колесиком мыши

swiper.enable()

Включить управление колесиком мыши

События Колеса мыши

Имя Аргументы Описание
прокрутка (swiper, событие)

Событие будет запущено при прокрутке колеса мыши

Виртуальные слайды

Модуль «Виртуальные слайды» позволяет хранить в DOM только необходимое количество слайдов. Это очень полезно с точки зрения производительности и проблем с памятью, если у вас много слайдов, особенно слайдов с тяжёлым деревом DOM или изображениями.

Обратите внимание, что в соответствии с реализацией Virtual Slides онне работаетс модулем Grid иslidesPerView: 'auto'

Параметры виртуальных слайдов

Имя Тип По умолчанию Описание
addSlidesAfter номер 0

Увеличивает количество предварительно отрисованных слайдов после активного слайда

addSlidesBefore номер 0

Увеличивает количество предварительно отрисованных слайдов перед активным слайдом

Кэш логическое значение верно

Включает кэш DOM для рендеринга HTML-элементов слайдов. После рендеринга они будут сохранены в кэше и использованы повторно.

включен логическое значение ложь

Включены ли виртуальные слайды

Внешний рендеринг функция (данные)

Функция для внешнего рендеринга (например, с использованием другой библиотеки для обработки манипуляций с DOM и состояния, такой как React.js или Vue.js). В качестве аргумента она принимаетdataобъект со следующими свойствами:

  • offset- смещение влево / вверх в пикселях
  • from- индекс первого слайда, необходимого для рендеринга
  • to- индекс последнего слайда, необходимого для рендеринга
  • slides- массив с элементами слайдов для рендеринга
renderExternalUpdate логическое значение верно

Если он включен (по умолчанию), то обновит макет Swiper сразу после вызова renderExternal. Полезно отключать и обновлять Swiper вручную при использовании с библиотеками рендеринга, которые выполняют рендеринг асинхронно

renderSlide функция (слайд,указатель)

Функция для отображения слайда. В качестве аргумента она принимает текущий элемент слайда дляslidesмассива и номер индекса текущего слайда. Функция должна возвращать внешний HTML-код слайда или HTML-элемент слайда.

слайды T[] []

Массив со слайдами

Методы виртуальных слайдов

Свойства
swiper.cache объект

Объект с кэшированными элементами slides HTML

swiper.from номер

Индекс первого отрисованного слайда

swiper.слайды T[]

Массив с элементами слайда, передаваемыми параметромvirtual.slides

swiper.to номер

Индекс последнего отрисованного слайда

Методы
swiper.appendSlide(слайд)

Добавить слайд.slidesЭто может быть один слайд или массив таких слайдов.

Только для версии Core (в React и Vue это нужно делать путём изменения массива/данных/источника слайдов)

swiper.добавитьslide(слайд)

Предварительный слайд.slidesможет быть отдельным слайдом или массивом таких слайдов.

Только для версии Core (в React и Vue это нужно делать путём изменения массива/данных/источника слайдов)

swiper.removeAllSlides()

Удалить все слайды

Только для версии Core (в React и Vue это нужно делать путём изменения массива/данных/источника слайдов)

swiper.removeSlide(индексы скольжения)

Удалите конкретный слайд или слайды.slideIndexesЭто может быть число с индексом слайда для удаления или массив с индексами.

Только для версии Core (в React и Vue это нужно делать путём изменения массива/данных/источника слайдов)

swiper.обновить(принудительно)

Обновить состояние виртуальных слайдов

Виртуальные слайды 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>

Навигация по хэшу

https://myweb.site/
https://myweb.site/#слайд-2

Хэш-навигация предназначена для создания ссылки на конкретный слайд, которая позволяет загрузить страницу с открытым конкретным слайдом.

Чтобы это работало, вам нужно включить его, передав параметр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,
});

Параметры хэш-навигации

Имя Тип По умолчанию Описание
getSlideIndex функция (swiper,хэш)

Предназначен для использования с виртуальными слайдами, когда невозможно найти слайд в DOM по хешу (например, он ещё не отобразился)

replaceState логическое значение ложь

Работает в дополнение к hashnav, заменяя текущий URL-адрес новым вместо добавления его в историю

Состояние наблюдения логическое значение ложь

Задайте значениеtrueдля включения навигации по слайдам (при включенном hashnav) с помощью истории браузера или путем непосредственного указания хэша в адресе документа

Хэширование событий Навигации

Имя Аргументы Описание
Хэш-обмен (swiper)

Событие будет запущено при изменении хэша окна

Набор хэшей (swiper)

Событие будет запущено, когда swiper обновит хэш

Навигация по истории

https://myweb.site/
https://myweb.site/слайд-2/

История Параметров навигации

Имя Тип По умолчанию Описание
включен логическое значение ложь

Включает плагин History.

keepQuery логическое значение ложь

Сохраняйте параметры запроса при изменении URL браузера.

Клавиша строка "слайды"

URL-ключ для слайдов

replaceState логическое значение ложь

Работает в дополнение к hashnav или истории, заменяя текущий URL-адрес новым вместо добавления его в историю

root строка ''

Корневая страница Swiper, полезная для указания, когда вы используете режим истории Swiper не на главной странице сайта. Например, это может бытьhttps://my-website.com/илиhttps://my-website.com/subpage/или/subpage/

Контроллер

Параметры контроллера

Имя Тип По умолчанию Описание
Автор: «слайд»|«контейнер» "слайд"

Определяет способ управления другим слайдером: слайд за слайдом (относительно сетки другого слайдера) или в зависимости от всех слайдов/контейнера (в зависимости от общего процента слайдера).

управление Любой

Передайте сюда другой экземпляр Swiper или массив с экземплярами Swiper, которыми должен управлять этот Swiper. Также принимает строку с CSS-селектором элемента Swiper или HTMLElement элемента Swiper

обратный логическое значение ложь

Установите значениеtrue, и управление будет осуществляться в обратном направлении

Методы контроллера

Свойства
swiper.control Любой

Передайте сюда другой экземпляр Swiper или массив с экземплярами Swiper, которыми должен управлять этот Swiper

Доступность (a11y)

Предыдущий слайд
Следующий слайд

Параметры доступности

Имя Тип По умолчанию Описание
Контейнерное сообщение нулевая|строка null

Сообщение для программ чтения с экрана для внешнего контейнера swiper

Контейнерная роль нулевая|строка null

Значение атрибута «роль», которое необходимо задать для контейнера свипера

containerRoleDescriptionMessage нулевая|строка null

Сообщение для программ чтения с экрана, описывающее роль внешнего контейнера swiper

включен логическое значение верно

Включает A11y

firstSlideMessage строка "Это первый слайд"

Сообщение для программ чтения с экрана для предыдущей кнопки, когда swiper находится на первом слайде

ID null|строка|число null

Значение атрибутаidдолжно быть задано для swiper-wrapper. Еслиnullбудет сгенерировано автоматически

itemRoleDescriptionMessage нулевая|строка null

Сообщение для программ чтения с экрана, описывающее роль элемента slide

lastSlideMessage строка "Это последний слайд"

Сообщение для программ чтения с экрана для кнопки "Далее", когда swiper находится на последнем слайде

nextSlideMessage строка "Следующий слайд"

Сообщение для программ чтения с экрана для кнопки "Далее"

Класс уведомлений строка "swiper-уведомление"

Имя CSS-класса уведомления A11y

paginationBulletMessage строка «Перейти к слайду{{index}}»

Сообщение для программ чтения с экрана для маркера с одной страницей

prevSlideMessage строка "Предыдущий слайд"

Сообщение для программ чтения с экрана для предыдущей кнопки

scrollOnFocus логическое значение верно

Позволяет прокручивать слайд, на котором был сделан фокус

slideLabelMessage строка '{{index}}/{{slidesLength}}'

Сообщение для программ чтения с экрана с описанием метки элемента слайда

slideRole строка "группа"

Значение атрибута swiper sliderole

Пользовательская сборка

У вас есть два варианта создания пользовательской версии 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- Модуль эффекта Coverflow
  • EffectCards- Модуль эффектов карт
  • EffectCreative- Модуль создания креативных эффектов
  • Thumbs- Модуль Thumbs

Использование скрипта сборки

Swiper поставляется с конструктором gulp, который позволяет создавать пользовательские версии библиотек, включающие только необходимые модули. Нам нужно следующее:

  1. Загрузите и распакуйтерепозиторий Swiper GitHubв локальную папку

  2. Установить Node.js (если не установлен)

  3. Теперь нам нужно установить необходимые зависимости. Перейдите в папку с загруженным и распакованным репозиторием Swiper и выполните в терминале:

    $ npm install
    
  4. Открыть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',
      ],
    };
    
  5. Теперь мы готовы создать пользовательскую версию Swiper:

    $ npm run build:prod
    
  6. Вот и всё. Сгенерированные файлы 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для всех типов, параметров, свойств и методов.

UTM метки в настройках объявлений Я.Директ

HTTPS://www.SITE.ru?utm_source=yandex&utm_medium=cpc&utm_campaign=kurtki_poisk&type={source_type}&source={source}&block={position_type}&position={position}&utm_term={keyword}
/?utm_source=yandex&utm_medium=cpc&utm_campaign=nozi_msk_poisk_sety&type={source_type}&source={source}&block={position_type}&position={position}&utm_term={keyword}
?utm_source=yandex&utm_medium=cpc&utm_campaign=chaga_poisk_russia&type={source_type}&source={source}&block={position_type}&position={position}&utm_term={keyword}
?utm_source=yandex&utm_medium=cpc&utm_campaign=chaga_poisk_moscow&type={source_type}&source={source}&block={position_type}&position={position}&utm_term={keyword}
?utm_source=yandex&utm_medium=cpc&utm_campaign=chaga_seti_moscow&type={source_type}&source={source}&block={position_type}&position={position}&utm_term={keyword}

Доступ по защищенному протоколу HTTPS. SSL сертификаты

Система управления поддерживает возможность работы в клиентском разделе и центре администрирования по защищенному протоколу HTTPS.
Для домена необходимо приобрести SSL-сертификат или создать самоподписанный сертификат, далее обратиться в поддержку хостинга или к администратору сервера для установки сертификата.

Установка внешних ссылок без протокола

Если в макете вы используете внешние ссылки с протоколом http://, например
<script type="text/javascript" src="http://code.jquery.com/jquery-1.7.js">
замените на независимые от протокола:
<script type="text/javascript" src="//code.jquery.com/jquery-1.7.js">

Использование HTTPS при работе с клиентским разделом

Установите SSL сертификат на сервере, далее в структуре сайта для всех разделов выберите опцию "Доступ через HTTPS". Ускорить установку всем разделам этой опции можно через SQL-запрос (123 замените на идентификатор сайта):
UPDATE `structures` SET `https` = 1 WHERE `site_id` = 2;

Указание HTTPS в Яндекс.Вебмастер

После перевода сайта с http на https в Яндекс.Вебмастер для сайта в разделе Настройка индексирования — Переезд сайта для сайта установить «Добавить HTTPS».

Указание директивы Host с https:// в robots.txt

В robots.txt для директивы Host укажите адрес с https://, например,
Host: https://www.myhost.ru

Доступ в центр администрирования с использованием HTTPS

После установки SSL сертификата и проверки доступа к центру администрирования через https создайте константу 
USE_ONLY_HTTPS_AUTHORIZATION
и присвойте ей значение true, после этого доступ по протоколу HTTP в центр администрирования будет невозможен.