Лайтбокс2
Примеры
Два отдельных изображения
Набор из четырех изображений
Начало работы
Загрузите ZIP-файл последней версии (или любой предыдущей) со страницы выпусков Github.
Или установить с помощью npm:
нпм установить лайтбокс2 --сохранить
Откройте zip-файл и взгляните на barebones, рабочий пример, включенный в
/examples
папка.Готовы установить лайтбокс на своей странице? Начните с включения Lightbox CSS и Javascript. Вы можете взять оба этих файла из папки
/dist
.- Включите CSS вверху страницы в тег
- Включите Javascript внизу страницы перед закрывающим тегом
- Включите CSS вверху страницы в тег
Убедитесь, что jQuery, необходимый для Lightbox, также загружен.
- Если вы уже используете jQuery на своей странице, убедитесь, что он загружен до
lightbox.js
. Требуется jQuery 1.7 или выше, а поскольку используется модуль эффектов, тонкая сборка jQuery не поддерживается. - Если вы в настоящее время не используете jQuery, я создал упакованный файл, который включает в себя как Lightbox, так и jQuery. Включить
dist/js/lightbox-plus-jquery.js
вместоlightbox.js
.
- Если вы уже используете jQuery на своей странице, убедитесь, что он загружен до
- Убедитесь, что четыре изображения, загруженные
lightbox.css
, находятся в правильном месте. Вы можете получить изображения из папки/dist/images
.
Инициализировать с помощью HTML
- Отдельные изображения. Добавьте атрибут
data-lightbox
к любой ссылке на изображение, чтобы включить Lightbox. В качестве значения атрибута используйте уникальное имя для каждого изображения. Например:- Добавьте атрибут
data-title
, если вы хотите показать заголовок. - Добавьте атрибут
data-alt
, если вы хотите установить атрибут alt связанного изображения.
- Добавьте атрибут
- Наборы изображений. Если у вас есть группа связанных изображений, которые вы хотите объединить в набор, используйте одно и то же значение атрибута
data-lightbox
для всех изображений. Например:
Опции
Если вы хотите изменить любой из параметров по умолчанию, вызовите метод параметра.
Опция | По умолчанию | |
---|---|---|
всегдаШоуНавоОнтачДевайс | ложь | Если задано значение true, стрелки навигации влево и вправо, которые появляются при наведении указателя мыши при просмотре наборов изображений, всегда будут видны на устройствах, поддерживающих сенсорный ввод. |
альбом Этикетка | «Изображение %1 из %2» | Текст, отображаемый под заголовком при просмотре набора изображений. Текст по умолчанию показывает текущий номер изображения и общее количество изображений в наборе. |
отключить прокрутку | ложь | Если задано значение true, запретить прокрутку страницы при открытом лайтбоксе. Это работает путем переполнения настроек, скрытого на теле. |
продолжительность угасания | 600 | Время, необходимое для появления и исчезновения контейнера Lightbox и наложения, в миллисекундах. |
правда | Если задано значение true, измените размер изображений, выходящих за пределы окна просмотра, чтобы они аккуратно помещались внутри него. Это избавляет пользователя от необходимости прокручивать изображение, чтобы увидеть его целиком. | |
imageFadeDuration | 600 | Время, необходимое для появления изображения после загрузки, в миллисекундах. |
максимальная ширина | Если установлено, ширина изображения будет ограничена этим числом в пикселях. Соотношение сторон не будет сохранено. | |
максимальная высота | Если установлено, высота изображения будет ограничена этим числом в пикселях. Соотношение сторон не будет сохранено. | |
positionFromTop | 50 | Расстояние от верха окна просмотра, на котором будет отображаться контейнер Lightbox, в пикселях. |
resizeDuration | 700 | Время, которое требуется контейнеру Lightbox для анимации ширины и высоты при переходе между изображениями разного размера, в миллисекундах. |
showImageNumberLabel | правда | При значении false текст, указывающий номер текущего изображения и общее количество изображений в наборе (например, «изображение 2 из 4»), будет скрыт. |
обернуть Вокруг | ложь | Если задано значение true, когда пользователь дойдет до последнего изображения в наборе, появится правая навигационная стрелка, и он будет продолжать движение вперед, что вернет его к первому изображению в наборе. |
Поддержка браузера
Lightbox2 был успешно протестирован в следующих браузерах:
- Internet Explorer.
Файл
включает jQuery v2.x и поддерживает IE 9+. Если вы хотите поддерживать IE 6, 7 и 8, используйте собственную копию jQuery v1.x с lightbox-plus-jquery.jslightbox.js
. - Хром
- Сафари
- Фаерфокс
- Сафари для iOS
- iOS Chrome
- Android-браузер
- Android Chrome
Лицензия
Lightbox2 находится под лицензией MIT License.
- 100% бесплатно. Lightbox можно использовать бесплатно как в коммерческих, так и в некоммерческих целях.
- Требуется авторство. Это означает, что вы должны оставить мое имя, ссылку на мою домашнюю страницу и информацию о лицензии нетронутыми.