v1.2
Установить

Установка

Начало работы

Как подключить Lenso к сайту, собрать минифицированные файлы и проверить, что всё работает. Опции и оформление — на странице «Настройка».

1Файлы

Для сайта нужны только два файла из dist/. Остальное — исходники, документация и тесты.

ФайлНазначение
dist/lenso.min.jsБиблиотека для сайта
dist/lenso.min.cssСтили для сайта
dist/plugins/*.min.js, *.min.cssПлагины для сайта — подключаются по желанию, см. «Плагины»
lenso.d.tsТипы TypeScript: подсказки и проверка опций в редакторе
lenso.js, lenso.css, plugins/Исходники с комментариями — правки вносятся сюда, затем сборка
index.php, install.php, settings.php, addons.php, inc/, docs/, demo/Документация и демо (PHP)
.htaccessАдреса без расширения: /install вместо /install.php
router.phpЛокальный сервер документации: php -S localhost:8791 router.php
tests/Браузерные тесты
build.sh, package.jsonСборка dist/

2Подключение

Два файла из папки dist/: lenso.min.css и lenso.min.js (≈ 17 КБ вместе в gzip). Один вызов Lenso.bind() — и все ссылки с атрибутом data-lenso открываются в лайтбоксе, включая добавленные на страницу позже.

3Сборка и тесты

Исходники — lenso.js и lenso.css с комментариями. Для сайта берите минифицированные файлы из dist/. После правок исходников пересоберите и прогоните тесты.

ФайлРазмерgzip
dist/lenso.min.js50 КБ17,6 КБ
dist/lenso.min.css15 КБ3,9 КБ
dist/plugins/share.min.*8 КБ4,2 КБ
dist/plugins/layouts.min.*6 КБ2,9 КБ

Тесты покрывают определение типов, группы, все виды исключений, клавиатуру, закрытие, свайп, щипок двумя пальцами, двойной тап, зум, поворот, слайд-шоу, историю и ссылки на слайд, обложку YouTube, PDF, встроенный блок, кнопку заявки, языки и события, а также анимацию «из превью», ленту соседних слайдов, инерцию, заглушку из миниатюры, автоскрытие, отражение, HTML и AJAX, RTL, систему плагинов и оба модуля, авторазмер фото — 59 сценариев.

4Поддержка браузеров

Chrome и Edge 105+, Firefox 110+, Safari 16+ (iOS 16+). Используются container queries, Pointer Events, ResizeObserver, Web Animations и History API — полифилы не нужны. При настройке системы «уменьшить движение» анимации отключаются сами.

  • Внешние загрузки. Сама библиотека ничего не подгружает. Исключения: pdf.js (≈ 400 КБ, с cdnjs, только при открытии PDF на телефоне — путь меняется опцией pdf.pdfjs) и плееры YouTube / Vimeo после нажатия «плей».
  • История браузера. Если сайт сам управляет адресом или хешем (SPA-роутер), отключите history и hash.
  • Глобальное имя. Подключение через <script> создаёт window.Lenso; через сборщик — экспорт по умолчанию.