jQuery UI API - виджет Dialog
Категория
Использование
Описание:Открыть содержимое в интерактивном оверлее.
Добавлено в версии:1.0
Диалог — это плавающее окно, которое включает строку заголовка и область содержимого. Окно диалога можно перемещать, изменять в размере и по умолчанию закрывать с помощью значка 'x'.
Если длина содержимого превышает максимальную высоту, автоматически появится полоса прокрутки.
Нижняя панель кнопок и полупрозрачный модальный оверлей — обычные дополнения.
Фокус
При открытии диалога фокус автоматически перемещается на первый элемент, удовлетворяющий следующим условиям:
- with
autofocusатрибут - Первый в содержимом диалога
:tabbableэлемент - Первый в панели кнопок диалога
:tabbableэлемент - Кнопка закрытия диалога
- Сам диалог
При открытии Виджет диалога обеспечивает перемещение фокуса между элементами внутри диалога с помощью клавиши 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>。
Зависимости
- Ядро UI
- Фабрика виджетов
- Position
- Виджет Button
- Виджет Draggable(Необязательный; при использовании с
draggableопция) - Виджет Resizable(Необязательно; при использовании с
resizableопция) - Effects Core(Необязательно; при использовании с
showиhideопция)
Дополнительные примечания
- Для этого виджета требуется некоторый функциональный 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>
Другие расширения