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)
    

Пример

Пример статического модального окна, как показано в примере ниже:

Пример

<h2>Создание модального окна</h2> <!--Кнопка вызывает модальное окно--> <button class="btn btn-primary btn-lg" data-toggle="modal" data-target="#myModal">Запустить демонстрационное модальное окно</button> <!--Modal--> <div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true"> <div class="modal-dialog"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button> <h4 class="modal-title" id="myModalLabel">Заголовок модального окна</h4> </div> <div class="modal-body">Добавьте сюда текст</div> <div class="modal-footer"> <button type="button" class="btn btn-default" data-dismiss="modal">Закрыть</button> <button type="button" class="btn btn-primary">Отправить изменения</button> </div> </div><!-- /.modal-content --> </div><!-- /.modal --> </div>

Попробуйте »

Результат следующий:

模态框(Modal)插件

Пояснение к коду:

  • Чтобы использовать модальное окно, вам нужен какой-то триггер. Вы можете использовать кнопку или ссылку. Здесь мы используем кнопку.
  • Если вы внимательно посмотрите на код выше, вы найдете в теге <button>,data-target="#myModal"— это цель модального окна, которое вы хотите загрузить на страницу. Вы можете создать несколько модальных окон на странице, а затем создать разные триггеры для каждого модального окна. Очевидно, вы не можете загрузить несколько модальных окон одновременно, но вы можете создать несколько на странице для загрузки в разное время.
  • В модальном окне есть две вещи, на которые стоит обратить внимание:
    1. Первое — это.modal, используется для идентификации содержимого <div> как модального окна.
    2. Второе — это.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Показывает модальное окно при инициализации.
remotepath
Значение по умолчанию: 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')

Пример

Следующий пример демонстрирует использование методов:

Пример

<!--Модальное окно--> <div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true"> <div class="modal-dialog"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button> <h4 class="modal-title" id="myModalLabel">Заголовок модального окна</h4> </div> <div class="modal-body">Нажмите кнопку ESC, чтобы выйти.</div> <div class="modal-footer"> <button type="button" class="btn btn-default" data-dismiss="modal">Закрыть</button> <button type="button" class="btn btn-primary">Отправить изменения</button> </div> </div><!-- /.modal-content --> </div><!-- /.modal-dialog --> </div> <!-- /.modal -->

Попробуйте сами »

Результат следующий:

模态框(Modal)插件方法

Просто нажмите клавишу 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 () {
  // 执行一些动作...
})

Пример

В следующем примере демонстрируется использование событий:

Пример

<!--Модальное окно--> <h2>События плагина модального окна</h2> <!--Кнопка вызывает модальное окно--> <button class="btn btn-primary btn-lg" data-toggle="modal" data-target="#myModal">Запустить демонстрационное модальное окно</button> <!--Modal--> <div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true"> <div class="modal-dialog"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button> <h4 class="modal-title" id="myModalLabel">Заголовок модального окна</h4> </div> <div class="modal-body">Нажмите кнопку закрытия, чтобы проверить работу события.</div> <div class="modal-footer"> <button type="button" class="btn btn-default" data-dismiss="modal">Закрыть</button> <button type="button" class="btn btn-primary">Отправить изменения</button> </div> </div><!-- /.modal-content --> </div><!-- /.modal-dialog --> </div> <!-- /.modal --> <script> $(function() { $('#myModal').modal('hide') }); </script> <script>$(function() { $('#myModal').on('hide.bs.modal', function() { alert('Hey, I heard you like modals...'); }) });</script>

Попробуйте сами »

Результат следующий:

模态框(Modal)插件事件

Как показано в примере выше, если вы нажмёте кнопкуЗакрыть, то есть событиеhide, будет отображено предупреждающее сообщение.

Другие расширения