3.1.0 • Published 8 years ago

jquery.lhmodal v3.1.0

Weekly downloads
1
License
MIT
Repository
github
Last release
8 years ago

jquery.lhModal

Плагин для создания модальных окон. Позволяет открывать несколько модальных окон одновременно без появления 'косяков'

Установка

npm install jquery.lhModal --save

Пример использования

$('.modal').lhModal(); - инициализация плагина; $('.modal').lhModal('show'); - показать модальное окно;

Настройки

Селекторы модального окна

В плагине реализована возможность изменения имен классов для каждого элемента модального окна

ОпцияЗначение по-умолчаниюОписание
modalDialog.modal__dialogФон модального окна при клике на который закрывается это окно
modalContent.modal__contentКонтейнер контентной части модального окна
modalClose.modal__closeКнопка закрытия

При открытии модального окна элементу body добавляется класс has-open-lhModal который запрещает прокрутку документа c помощью overfow:hidden. Изменить название класса можно с помощью опции bodyWithOpenModal.

Пример

$('#modal').lhModal({
    modalDialog: '.dialog',
    modalContent: '.content',
    modalClose: '.close',
    bodyWithOpenModal: 'body-ovh' //!тут указывается имя класса, без точки
 });

Анимация

В данном плагине реализована возможность анимирования появления и исчезновения модального окна. Анимация осуществаяется с помощью CSS3 Анимации. Параметры анимации указаны в файле jquery.lhModal.scss. Добавлены четыре эффекта: slideInTop, slideInLeft, slideOutRight, slideOutDown. Для точности срабатывания встроенных событий продолжительной анимации в CSS файле должна совпадать с опцией плагина duration.

ОпцияЗначение по-умолчаниюОписание
modalIn.modal_inCSS класс добавляемый при появлении модального окна
modalOut.modal_outCSS класс добавляемый при исчезновении модального окна
duration500Продолжительность анимации, в миллисекундах

Поддерживаются эффекты библиотеки animate.css. Для этого необходимо подключить саму библиотеку, выставить необходимое значение опции duration и в файле jquery.lhModal.scss классам .modal_in и .modal_out (или на тем которые были установлены) добавить свойства animation-name соответствующие названиям анимации библиотеки animate.css

Пример

$('#modal').lhModal({
    modalIn: '.modal_show',
    modalOut: '.modal_hide',
    duration: 1000,
 });

События

СобытиеОписание
show.lhModalВызывается перед появлением модального окна
shown.lhModalВызывается после появления окна.
close.lhModalВызывается перед исчезновении модального окна
closed.lhModalВызывается после исчезновении окна.

Пример

$('#modal').on('show.lhModal', ()=>{
    console.log('show modal');
});

Методы

МетодОписание
showПоказывает модальное окно
closeСкрывает модальное окно

Пример $('#modal').lhModal('show');

Глобальные методы

Методы

МетодОписание
closeAllСкрывает все модальные окна

Пример $.lhModal.closeAll();

3.1.0

8 years ago

3.0.0

8 years ago

2.1.0

8 years ago

2.0.0

8 years ago

1.2.2

8 years ago

1.2.1

8 years ago

1.1.0

8 years ago