Установка
Как подключить 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.js | 50 КБ | 17,6 КБ |
dist/lenso.min.css | 15 КБ | 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; через сборщик — экспорт по умолчанию.