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

Настройка

Справочник

Темы и стили, атрибуты разметки, все опции, CSS-переменные, классы, методы и события. Живые примеры возможностей — на странице «Обзор».

Темы и стили

Выберите тему и анимацию, затем откройте любое фото ниже. Код под примерами меняется вместе с выбором: во вкладке «JS» — опции для Lenso.bind, во вкладке «CSS» — переменные выбранной темы.

PDF

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

Другие способы

Переменные можно переопределить для всех окон сразу, задать отдельному инстансу или менять оформление по типу слайда.

Атрибуты

Задаются на ссылке (или любом элементе, подходящем под селектор привязки).

АтрибутЗначениеОписание
data-lensoимя группы или пустоВключает лайтбокс. Одинаковые значения — одна галерея, пустое — одиночный просмотр.
data-lenso-typeimage video pdf iframe inline ajaxТип явно. Нужен, если у URL нет расширения, и для загрузки по AJAX.
data-lenso-selectorCSS-селекторДля ajax: взять из ответа только этот фрагмент, например main.
data-lenso-srcURLИсточник, если он отличается от href (или элемент — не ссылка).
data-lenso-captionтекстПодпись. Иначе берётся alt картинки внутри, затем title.
data-lenso-titleтекстНазвание товара для заявки ({title}). Можно задать на контейнере галереи — применится ко всем фото внутри.
data-lenso-ctaтекст или falseТекст кнопки заявки или false — без кнопки. Можно задать на контейнере галереи; атрибут на фото важнее.
data-lenso-thumbURLМиниатюра в ленте. Иначе — img внутри ссылки.
data-lenso-posterURLПостер видеофайла и обложка YouTube / Vimeo.
data-lenso-srcsetsrcsetАдаптивные источники изображения.
data-lenso-width800 / 90vwШирина iframe, PDF, видео, блока. Для фото вместе с высотой — пропорции до загрузки (рамка встаёт сразу). Число — пиксели.
data-lenso-height600 / 80vhВысота iframe, PDF, блока.
data-lenso-downloadURL или falseСвой файл для кнопки «Скачать» или скрыть её.
data-lenso-exclude—Исключить элемент или всё внутри контейнера.
data-lenso-solo—Открыть отдельно, без навигации по группе.

Опции

Передаются в Lenso.bind(selector, options) или Lenso.open(items, options). Глобальные умолчания — Lenso.defaults.

Привязка и исключения

ОпцияПо умолчаниюОписание
selector'[data-lenso]'Какие элементы открывают лайтбокс (первый аргумент bind).
groupAttr'data-lenso'Атрибут с именем группы.
rootnullСелектор или элемент, внутри которого ищутся элементы группы.
exclude'[data-lenso-exclude]'Селектор (через closest) или fn(el) → true.
typesnullБелый список типов.
excludeTypesnullЧёрный список типов.
filternullfn(item) → false исключает элемент.
soloAttr'data-lenso-solo'Атрибут одиночного открытия.

Поведение

ОпцияПо умолчаниюОписание
looptrueЗацикленная навигация.
keyboardtrue← → Home End. Esc работает всегда.
closeOnBackdroptrueЗакрытие кликом по фону.
swipetrueСвайп влево/вправо, вниз — закрыть. true — пальцем и мышью, 'touch' — только пальцем, false — выключить.
zoomtrueЗум: клик, двойной тап, два пальца, Ctrl + колесо.
maxZoom3Макс. увеличение от вписанного размера (не меньше 100% пикселей оригинала).
rotatetrueКнопка поворота фото.
tapToggleUItrueТап по фото на телефоне скрывает интерфейс.
zoomFromThumbtrueФото вылетает из миниатюры на странице и возвращается в неё при закрытии.
placeholdertrueПока грузится большое фото, показывать миниатюру вместо спиннера.
autoSizetrueУзнавать размер фото заранее — при наведении на миниатюру и по первым байтам файла — и дописывать data-lenso-width/height. Рамка сразу в точных пропорциях.
idle3000Мс без движения мыши до скрытия интерфейса (только устройства с мышью); 0 — выкл.
historytrueКнопка «Назад» в браузере закрывает окно.
hashtrueАдрес слайда #lenso-группа-N, открытие по ссылке.
slideshow{delay:4000, autostart:false, pauseOnHover:true}Слайд-шоу; false — выключить.
preload1Сколько соседних фото предзагружать с каждой стороны.
animation'slide''slide', 'fade' или false.
focusTraptrueTab не уходит за пределы окна.
scrollLocktrueБлокировать прокрутку страницы.

Интерфейс и стили

ОпцияПо умолчаниюОписание
toolbar['slideshow','zoom','rotate','newtab','download','fullscreen','close']Состав и порядок кнопок; доступна ещё 'flip' и кнопки плагинов. Неподходящие текущему типу скрываются сами.
arrowstrueСтрелки по бокам.
countertrueСчётчик «1 / 5».
captiontrueПодпись.
captionHtmlfalseВставлять подпись как HTML (только доверенный контент).
thumbstrueЛента миниатюр (при 2+ элементах).
ctanullКнопка заявки: { text, href, target, icon, onClick, filter }. href — шаблон или функция, см. Lenso.whatsapp.
lang'auto''ru', 'en' или по <html lang>.
rtl'auto'Письмо справа налево: true, false или по dir страницы.
pluginsnullКакие плагины работают: null — все подключённые, ['share'] — только эти, false — ни одного.
theme''Класс lenso--{theme}. Встроена 'light'.
className''Дополнительные классы корня.
varsnullCSS-переменные для этого инстанса: {'--lenso-accent': '#f00'}.
i18nрусские строкиТексты интерфейса, см. Lenso.i18n.
iconsSVGИконки, см. Lenso.icons.

Форматы

ОпцияПо умолчаниюОписание
video{autoplay:true, muted:false, loop:false, controls:true}Видеофайлы и автозапуск embed.
youtube{nocookie:true, facade:'auto', params:{rel:0, playsinline:1}}Домен, обложка до клика, параметры плеера YouTube.
vimeo{facade:'auto', params:{}}Обложка и параметры плеера Vimeo.
pdf{viewer:'auto', params:'#view=FitH', pdfjs:{src, worker, quality:1}}Просмотрщик: 'auto', 'native', 'pdfjs', 'card'; пути к pdf.js.
iframe{allow:'…', sandbox:null, referrerpolicy:null}Атрибуты iframe.
render{}Свой рендер встроенного типа: { image(item, content, slide, lenso) {} }.
on{}Обработчики событий, см. ниже.

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

Объявлены в :where(.lenso) с нулевой специфичностью — любое правило .lenso { … } или .lenso--тема { … } их перекрывает.

ПеременнаяПо умолчаниюЧто меняет
--lenso-z9999z-index окна
--lenso-fontsystem-uiШрифт
--lenso-bgrgba(12,13,16,.94)Фон подложки
--lenso-blur8pxРазмытие страницы под подложкой
--lenso-color / --lenso-muted#f3f4f6Основной и второстепенный текст
--lenso-accent / --lenso-accent-color#f39800 / #111Акцент (активные кнопки, миниатюра, спиннер) и текст на нём
--lenso-btn-size44pxРазмер кнопок тулбара
--lenso-btn-radius999pxСкругление кнопок
--lenso-btn-bg / --lenso-btn-bg-hoverполупрозрачный белыйФон кнопок
--lenso-btn-colorvar(--lenso-color)Цвет иконок
--lenso-icon-size22pxРазмер иконок
--lenso-nav-size / --lenso-nav-offset52px / 16pxСтрелки и их отступ от края
--lenso-gap16pxОтступ контента от краёв сцены
--lenso-radius6pxСкругление фото, видео, фреймов
--lenso-shadowтеньТень контента
--lenso-media-bg#000Фон видео
--lenso-frame-bg#fffФон iframe и PDF
--lenso-frame-width / --lenso-frame-height1100px / 100%Размер iframe
--lenso-pdf-width1000pxШирина PDF
--lenso-video-width1280pxШирина видео
--lenso-embed-ratio16 / 9Пропорции YouTube / Vimeo
--lenso-caption-size / -color / -max14px / muted / 900pxПодпись
--lenso-thumb-w / --lenso-thumb-h76px / 54pxРазмер миниатюр
--lenso-thumb-gap / -radius8px / 6pxОтступ и скругление миниатюр
--lenso-thumb-opacity.45Прозрачность неактивных миниатюр
--lenso-thumb-bg / -active— / accentФон миниатюры и рамка активной
--lenso-duration / --lenso-easing280msСкорость и кривая анимаций
--lenso-shift80pxСдвиг слайда при анимации slide
--lenso-spinner-size / -width40px / 3pxИндикатор загрузки
--lenso-progress-height / -color3px / accentПолоса слайд-шоу
--lenso-cta-bg / -color / -radiusaccent / #111 / 999pxКнопка заявки
--lenso-facade-play-size / -bg72pxКнопка «плей» на обложке видео
--lenso-pdf-bg / --lenso-pdf-page-gap#525659 / 12pxФон и отступ страниц pdf.js
--lenso-inline-width / -bg / -color / -padding720px / #fffБлок со страницы

Классы и состояния

Состояния

КлассГдеКогда
.is-open / .is-closing.lensoАнимация появления и закрытия
.is-fullscreen.lensoПолноэкранный режим
.is-playing.lensoИдёт слайд-шоу
.is-ui-hidden.lensoИнтерфейс скрыт тапом
.is-idle.lensoИнтерфейс скрыт: мышь не двигалась
.is-morphing.lensoФото возвращается в миниатюру (закрытие)
.is-peek.lenso__slideСоседний слайд во время свайпа
.has-ph / .lenso__phслайд / в рамке фотоМиниатюра-заглушка, пока грузится фото
[data-type].lensoТип текущего слайда
.is-loading / .is-loaded / .is-error.lenso__slideЗагрузка контента
.is-zoomed.lenso__slideФото увеличено
.is-entering / .is-leaving.lenso__slideАнимация смены слайда
.is-dragging.lenso__stageИдёт свайп или перетаскивание
.lenso__slide--embed.lenso__slideYouTube / Vimeo
.lenso__slide--fallback.lenso__slideКарточка PDF вместо просмотрщика
.lenso__slide--pdfjs.lenso__slidePDF через pdf.js
.lenso__facadeв слайде видеоОбложка до загрузки плеера
html.lenso-lockhtmlПрокрутка страницы заблокирована

Методы и события

МетодОписание
Lenso.bind(selector, options)Привязать к разметке, вернуть инстанс.
Lenso.open(items, options)Открыть программно. options.startIndex — с какого элемента.
Lenso.registerType(name, def)Свой тип: { match, render, icon }.
Lenso.detectType(src)Определить тип по URL.
Lenso.whatsapp(phone, text)Функция-ссылка для cta.href.
Lenso.mailto(email, subject, body)То же для письма.
Lenso.fill(template, item, lb)Подстановка {title} {caption} {url} {src} {index}.
Lenso.locales / Lenso.versionЯзыки интерфейса, версия.
Lenso.use(plugin) / Lenso.pluginsПодключить плагин, список подключённых. См. «Плагины».
Lenso.defaults / Lenso.i18n / Lenso.iconsГлобальные умолчания — можно менять до вызова bind.
lb.open(items, index)Открыть набор элементов.
lb.close()Закрыть.
lb.next() / lb.prev() / lb.goTo(i)Навигация.
lb.setZoom(scale, x, y, animate) / lb.toggleZoom()Масштаб от вписанного размера (с анимацией при animate); переключение 100% ↔ вписать.
lb.rotate(deg) / lb.flip(axis)Повернуть фото (шаг 90°); отразить по 'x' или 'y'.
lb.startSlideshow() / stopSlideshow() / toggleSlideshow()Слайд-шоу.
lb.toggleUI(force) / lb.toggleFullscreen()Скрыть интерфейс, полноэкранный режим.
lb.setOptions(options)Изменить опции (применяются при следующем открытии).
lb.unbind() / lb.bind()Снять / вернуть обработчик кликов.
lb.destroy()Закрыть и снять обработчики.
lb.item / lb.index / lb.items / lb.isOpenТекущее состояние.

События

Доступны и как опция on, и как событие lenso:имя на document. В detail — { lenso, item, index }.

СобытиеКогда
openОкно открыто
changeПоказан слайд (в т.ч. первый)
loadКонтент слайда загружен
errorОшибка загрузки фото или видео
closeОкно закрывается
destroyИнстанс уничтожен
action:имяНажата своя кнопка тулбара (только в опции on)