Bootstrap Плагин модальных окон
Модальное окно — это дочернее окно, которое накладывается поверх родительского окна. Обычно его цель — отображать содержимое из отдельного источника, позволяя выполнять некоторые действия, не покидая родительское окно. Дочерние окна могут предоставлять информацию, взаимодействие и т. д.
Если вы хотите подключить функциональность этого плагина отдельно, то вам нужно подключитьmodal.js. Или, какОбзор плагинов Bootstrapупомянуто в главе, вы можете подключитьbootstrap.jsили сжатую версиюbootstrap.min.js。
Использование
Вы можете переключать скрытое содержимое плагина модальных окон:
- Через атрибуты данных: Установите атрибуты на элементе-контроллере (например, кнопке или ссылке)data-toggle="modal", и установитеdata-target="#identifier"илиhref="../index.html"чтобы указать конкретное модальное окно для переключения (с id="identifier").
- Через JavaScript: Используя этот способ, вы можете вызвать модальное окно с id="identifier" одной простой строкой JavaScript:
$('#identifier').modal(options)
Пример
Пример статического модального окна, как показано в примере ниже:
Пример
Попробуйте »
Результат следующий:
Пояснение к коду:
- Чтобы использовать модальное окно, вам нужен какой-то триггер. Вы можете использовать кнопку или ссылку. Здесь мы используем кнопку.
- Если вы внимательно посмотрите на код выше, вы найдете в теге <button>,data-target="#myModal"— это цель модального окна, которое вы хотите загрузить на страницу. Вы можете создать несколько модальных окон на странице, а затем создать разные триггеры для каждого модального окна. Очевидно, вы не можете загрузить несколько модальных окон одновременно, но вы можете создать несколько на странице для загрузки в разное время.
- В модальном окне есть две вещи, на которые стоит обратить внимание:
- Первое — это.modal, используется для идентификации содержимого <div> как модального окна.
- Второе — это.fadeкласс. Когда модальное окно переключается, содержимое плавно появляется и исчезает.
- aria-labelledby="myModalLabel", этот атрибут ссылается на заголовок модального окна.
- Атрибутaria-hidden="true"используется для того, чтобы модальное окно оставалось невидимым до активации триггера (например, нажатия на соответствующую кнопку).
- <div class="modal-header">, modal-header — это класс, который определяет стили для заголовка модального окна.
- class="close", close — это CSS-класс, используемый для оформления кнопки закрытия модального окна.
- data-dismiss="modal", является пользовательским атрибутом данных HTML5. Здесь он используется для закрытия модального окна.
- class="modal-body", является CSS-классом в Bootstrap CSS, используемым для оформления тела модального окна.
- class="modal-footer", является CSS-классом в Bootstrap CSS, используемым для оформления футера модального окна.
- data-toggle="modal", пользовательский атрибут данных HTML5 data-toggle используется для открытия модального окна.
Параметры
Существуют некоторые параметры, которые можно использовать для настройки внешнего вида и поведения модального окна. Они передаются через атрибуты данных или JavaScript. В следующей таблице перечислены эти параметры:
| Название параметра | Тип/Значение по умолчанию | Имя атрибута данных | Описание |
|---|---|---|---|
| backdrop | логическое значение или строка 'static' Значение по умолчанию: true | data-backdrop | Задает статическую подложку; когда пользователь щелкает вне модального окна, модальное окно не закрывается. |
| keyboard | логическое значение Значение по умолчанию: true | data-keyboard | Закрывает модальное окно при нажатии клавиши Escape. Если задано значение false, клавиша не действует. |
| show | логическое значение Значение по умолчанию: true | data-show | Показывает модальное окно при инициализации. |
| remote | path Значение по умолчанию: false | data-remote | Используя метод jQuery.load, вставляет содержимое в тело модального окна. Если добавлен href с допустимым URL, содержимое будет загружено из него. Как показано в примере ниже:<a data-toggle="modal" href="remote.html" data-target="#modal" rel="noopener noreferrer">请点击我</a> |
Методы
Ниже приведены некоторые полезные методы, которые можно использовать с modal().
| Метод | Описание | Пример |
|---|---|---|
| Параметры: .modal(options) | Активирует содержимое как модальное окно. Принимает необязательный объект параметров. |
$('#identifier').modal({
keyboard: false
})
|
| Переключить: .modal('toggle') | Вручную переключает модальное окно. |
$('#identifier').modal('toggle')
|
| Показать: .modal('show') | Вручную открывает модальное окно. |
$('#identifier').modal('show')
|
| Скрыть: .modal('hide') | Вручную скрывает модальное окно. |
$('#identifier').modal('hide')
|
Пример
Следующий пример демонстрирует использование методов:
Пример
Попробуйте сами »
Результат следующий:
Просто нажмите клавишу ESC, и модальное окно закроется.
Events
В следующей таблице перечислены события, используемые в модальном окне. Эти события можно использовать как хуки в функциях.
| Event | Описание | Пример |
|---|---|---|
| show.bs.modal | Срабатывает после вызова метода show. |
$('#identifier').on('show.bs.modal', function () {
// 执行一些动作...
})
|
| shown.bs.modal | Срабатывает, когда модальное окно становится видимым для пользователя (будет ожидать завершения CSS-переходов). |
$('#identifier').on('shown.bs.modal', function () {
// 执行一些动作...
})
|
| hide.bs.modal | Срабатывает при вызове метода экземпляра hide. |
$('#identifier').on('hide.bs.modal', function () {
// 执行一些动作...
})
|
| hidden.bs.modal | Срабатывает, когда модальное окно полностью скрыто от пользователя. |
$('#identifier').on('hidden.bs.modal', function () {
// 执行一些动作...
})
|
Пример
В следующем примере демонстрируется использование событий:
Пример
Попробуйте сами »
Результат следующий:
Как показано в примере выше, если вы нажмёте кнопкуЗакрыть, то есть событиеhide, будет отображено предупреждающее сообщение.
Другие расширения