Темы и стили, атрибуты разметки, все опции, CSS-переменные, классы, методы и события. Живые примеры возможностей — на странице «Обзор».
Темы и стили
Выберите тему и анимацию, затем откройте любое фото ниже. Код под примерами меняется вместе с выбором: во вкладке «JS» — опции для Lenso.bind, во вкладке «CSS» — переменные выбранной темы.
Переменные можно переопределить для всех окон сразу, задать отдельному инстансу или менять оформление по типу слайда.
Атрибуты
Задаются на ссылке (или любом элементе, подходящем под селектор привязки).
Атрибут
Значение
Описание
data-lenso
имя группы или пусто
Включает лайтбокс. Одинаковые значения — одна галерея, пустое — одиночный просмотр.
data-lenso-type
imagevideopdfiframeinlineajax
Тип явно. Нужен, если у URL нет расширения, и для загрузки по AJAX.
data-lenso-selector
CSS-селектор
Для ajax: взять из ответа только этот фрагмент, например main.
data-lenso-src
URL
Источник, если он отличается от href (или элемент — не ссылка).
data-lenso-caption
текст
Подпись. Иначе берётся alt картинки внутри, затем title.
data-lenso-title
текст
Название товара для заявки ({title}). Можно задать на контейнере галереи — применится ко всем фото внутри.
data-lenso-cta
текст или false
Текст кнопки заявки или false — без кнопки. Можно задать на контейнере галереи; атрибут на фото важнее.
data-lenso-thumb
URL
Миниатюра в ленте. Иначе — img внутри ссылки.
data-lenso-poster
URL
Постер видеофайла и обложка YouTube / Vimeo.
data-lenso-srcset
srcset
Адаптивные источники изображения.
data-lenso-width
800 / 90vw
Ширина iframe, PDF, видео, блока. Для фото вместе с высотой — пропорции до загрузки (рамка встаёт сразу). Число — пиксели.
data-lenso-height
600 / 80vh
Высота iframe, PDF, блока.
data-lenso-download
URL или false
Свой файл для кнопки «Скачать» или скрыть её.
data-lenso-exclude
—
Исключить элемент или всё внутри контейнера.
data-lenso-solo
—
Открыть отдельно, без навигации по группе.
Опции
Передаются в Lenso.bind(selector, options) или Lenso.open(items, options). Глобальные умолчания — Lenso.defaults.
Привязка и исключения
Опция
По умолчанию
Описание
selector
'[data-lenso]'
Какие элементы открывают лайтбокс (первый аргумент bind).
groupAttr
'data-lenso'
Атрибут с именем группы.
root
null
Селектор или элемент, внутри которого ищутся элементы группы.
exclude
'[data-lenso-exclude]'
Селектор (через closest) или fn(el) → true.
types
null
Белый список типов.
excludeTypes
null
Чёрный список типов.
filter
null
fn(item) → false исключает элемент.
soloAttr
'data-lenso-solo'
Атрибут одиночного открытия.
Поведение
Опция
По умолчанию
Описание
loop
true
Зацикленная навигация.
keyboard
true
← → Home End. Esc работает всегда.
closeOnBackdrop
true
Закрытие кликом по фону.
swipe
true
Свайп влево/вправо, вниз — закрыть. true — пальцем и мышью, 'touch' — только пальцем, false — выключить.
zoom
true
Зум: клик, двойной тап, два пальца, Ctrl + колесо.
maxZoom
3
Макс. увеличение от вписанного размера (не меньше 100% пикселей оригинала).
rotate
true
Кнопка поворота фото.
tapToggleUI
true
Тап по фото на телефоне скрывает интерфейс.
zoomFromThumb
true
Фото вылетает из миниатюры на странице и возвращается в неё при закрытии.
placeholder
true
Пока грузится большое фото, показывать миниатюру вместо спиннера.
autoSize
true
Узнавать размер фото заранее — при наведении на миниатюру и по первым байтам файла — и дописывать data-lenso-width/height. Рамка сразу в точных пропорциях.
idle
3000
Мс без движения мыши до скрытия интерфейса (только устройства с мышью); 0 — выкл.
history
true
Кнопка «Назад» в браузере закрывает окно.
hash
true
Адрес слайда #lenso-группа-N, открытие по ссылке.
slideshow
{delay:4000, autostart:false, pauseOnHover:true}
Слайд-шоу; false — выключить.
preload
1
Сколько соседних фото предзагружать с каждой стороны.