jQuery UI API - виджет Dialog

Категория

Виджеты

Использование

Описание:Открыть содержимое в интерактивном оверлее.

Добавлено в версии:1.0

Диалог — это плавающее окно, которое включает строку заголовка и область содержимого. Окно диалога можно перемещать, изменять в размере и по умолчанию закрывать с помощью значка 'x'.

Если длина содержимого превышает максимальную высоту, автоматически появится полоса прокрутки.

Нижняя панель кнопок и полупрозрачный модальный оверлей — обычные дополнения.

Фокус

При открытии диалога фокус автоматически перемещается на первый элемент, удовлетворяющий следующим условиям:

  1. withautofocusатрибут
  2. Первый в содержимом диалога:tabbableэлемент
  3. Первый в панели кнопок диалога:tabbableэлемент
  4. Кнопка закрытия диалога
  5. Сам диалог

При открытии Виджет диалога обеспечивает перемещение фокуса между элементами внутри диалога с помощью клавиши Tab, исключая элементы за пределами диалога. Модальные диалоги не позволяют пользователям мыши щёлкать по элементам за пределами диалога.

При закрытии диалога фокус автоматически возвращается к элементу, который был в фокусе до открытия диалога.

Скрыть кнопку закрытия

В некоторых случаях может потребоваться скрыть кнопку закрытия, например, когда в панели кнопок уже есть кнопка закрытия. Лучшее решение — через CSS. Например, можно определить простое правило, такое как:

.no-close .ui-dialog-titlebar-close {
  display: none;
}

Затем вы можете добавитьno-closeкласс к любому диалогу, чтобы скрыть кнопку закрытия:

$( "#dialog" ).dialog({
  dialogClass: "no-close",
  buttons: [
    {
      text: "OK",
      click: function() {
        $( this ).dialog( "close" );
      }
    }
  ]
});

Темы оформления

Виджет диалога используетjQuery UI CSS Frameworkдля определения стиля внешнего вида и ощущения. Если вам нужно использовать стили, специфичные для диалога, можно использовать следующие имена CSS-классов:

  • ui-dialog: Внешний контейнер диалога.
    • ui-dialog-titlebar: Строка заголовка, содержащая заголовок диалога и кнопку закрытия.
      • ui-dialog-title: Контейнер вокруг текстового заголовка диалога.
      • ui-dialog-titlebar-close: Кнопка закрытия диалога.
    • ui-dialog-content: Контейнер вокруг содержимого диалога. Это также элемент, на котором создается экземпляр виджета.
    • ui-dialog-buttonpane: Панель, содержащая кнопки диалога. Она отображается только тогда, когдаbuttonsопция установлена.
      • ui-dialog-buttonset: Контейнер вокруг кнопок.

Кроме того, когдаmodalопция установлена, элемент сui-widget-overlayимя класса добавляется к<body>。

Зависимости

Дополнительные примечания

  • Для этого виджета требуется некоторый функциональный CSS, иначе он не будет работать. Если вы создаёте собственную тему, используйте CSS-файл, специфичный для виджета, в качестве отправной точки.

Примеры

Простой диалог jQuery UI.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>对话框部件(Dialog Widget)演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<button id="opener">打开对话框</button>
<div id="dialog" title="对话框标题">我是一个对话框</div>
 
<script>
$( "#dialog" ).dialog({ autoOpen: false });
$( "#opener" ).click(function() {
  $( "#dialog" ).dialog( "open" );
});
</script>
 
</body>
</html>

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