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

Плагины

Модули

Дополнительные возможности, которые нужны не всем, вынесены в отдельные файлы: ядро не тяжелеет, а модули подключаются только там, где нужны. Подключённый плагин работает во всех окнах; ограничить можно опцией plugins.

Подключение

Файлы модуля подключаются после ядра — плагин регистрируется сам. Минифицированные версии лежат в dist/plugins/.

МодульЧто делаетgzip
shareКнопка «Поделиться»: меню соцсетей, копирование ссылки, системное меню на телефоне≈ 4,1 КБ
layoutsПодпись сверху, сбоку, поверх фото, «Подробнее»; миниатюры слева, справа, кнопка «скрыть»≈ 2,9 КБ

Поделиться

Кнопка в тулбаре открывает меню соцсетей. Ссылка ведёт на страницу с открытым именно этим слайдом (если включены history и hash) — получатель увидит то же фото. На телефоне по умолчанию открывается системное меню «Поделиться».

Раскладки

Где показывать подпись и миниатюры. Выберите вариант и откройте галерею — код ниже меняется вместе с выбором. На экранах уже 720 px окно возвращается к стандартной раскладке.

Подпись:
Миниатюры:
Ещё:

Код выбранного варианта

CSS-переменные

ПеременнаяПо умолчаниюЧто меняет
--lenso-side340pxШирина боковой панели с подписью
--lenso-thumbs-col104pxШирина колонки миниатюр слева/справа
--lenso-side-bg / --lenso-side-lineполупрозрачныеФон и граница боковой панели
--lenso-overlay-bgrgba(0,0,0,.55)Плашка подписи поверх фото
--lenso-caption-lines3Сколько строк видно до «Подробнее» (задаётся и опцией)

Свой плагин

Плагин — объект с именем и функциями-хуками. Lenso вызывает их в нужные моменты и передаёт экземпляр окна lb. Свои кнопки тулбара — через actions, иконки и тексты — через Lenso.icons и Lenso.locales.

ХукКогда вызывается
install(Lenso)Один раз при Lenso.use — добавить умолчания, иконки, тексты
init(lb)Создан экземпляр (Lenso.bind или Lenso.open)
build(lb, ui)Окно собрано, ещё не показано — можно менять разметку
slide(lb, slide, item)Создан слайд
open(lb) / change(lb) / close(lb)Окно открыто / показан слайд / окно закрывается
actions: { имя(lb, item, button, event) }Нажата кнопка data-lenso-action="имя"