jQuery UI API - Widget de cuadro de diálogo (Dialog Widget)
Categoría
Uso
Descripción:Abre contenido en una capa de superposición interactiva.
Nuevo en versión:1.0
El cuadro de diálogo es una ventana flotante que incluye una barra de título y un área de contenido. La ventana del cuadro de diálogo se puede mover y redimensionar; de forma predeterminada se cierra mediante el icono 'x'.
Si la longitud del contenido supera la altura máxima, aparece automáticamente una barra de desplazamiento.
Una barra de botones inferior y una superposición modal semitransparente son opciones añadidas comunes.
Foco
Cuando se abre un cuadro de diálogo, el foco se mueve automáticamente al primer elemento que cumpla las siguientes condiciones:
- Con
autofocusel primer elemento dentro del cuadro de diálogo con el atributo - el primero dentro del contenido del cuadro de diálogo
:tabbableelemento - el primero dentro del panel de botones del cuadro de diálogo
:tabbableelemento - el botón de cierre del cuadro de diálogo
- el propio cuadro de diálogo
Al abrirse, el widget de cuadro de diálogo (Dialog Widget) asegura que el foco se mueva mediante la tecla Tab entre los elementos dentro del cuadro de diálogo, excluyendo los elementos fuera de él. Los cuadros de diálogo modales impiden que los usuarios de mouse hagan clic en elementos fuera del cuadro de diálogo.
Al cerrar el cuadro de diálogo, el foco regresa automáticamente al elemento que tenía el foco antes de que se abriera el cuadro de diálogo.
Ocultar el botón de cierre
En algunos casos, es posible que desee ocultar el botón de cierre, por ejemplo, cuando ya hay un botón de cierre en el panel de botones. La mejor solución es mediante CSS. Por ejemplo, puede definir una regla simple como:
.no-close .ui-dialog-titlebar-close {
display: none;
}
Luego, puede agregar lano-closeclase a cualquier cuadro de diálogo para ocultar el botón de cierre:
$( "#dialog" ).dialog({
dialogClass: "no-close",
buttons: [
{
text: "OK",
click: function() {
$( this ).dialog( "close" );
}
}
]
});
Tematización
El widget de cuadro de diálogo (Dialog Widget) utilizael framework CSS de jQuery UIpara definir el estilo de su apariencia y sensación. Si necesita usar estilos específicos del cuadro de diálogo, puede utilizar los siguientes nombres de clase CSS:
ui-dialog: el contenedor exterior del cuadro de diálogo.ui-dialog-titlebar: la barra de título que contiene el título y el botón de cierre del cuadro de diálogo.ui-dialog-title: el contenedor alrededor del título de texto del cuadro de diálogo.ui-dialog-titlebar-close: el botón de cierre del cuadro de diálogo.
ui-dialog-content: el contenedor alrededor del contenido del cuadro de diálogo. Este es también el elemento donde se instancia el widget.ui-dialog-buttonpane: el panel que contiene los botones del cuadro de diálogo. Solo cuando se establecebuttonsla opción, se muestra.ui-dialog-buttonset: el contenedor alrededor del botón.
Además, cuando se establecemodalla opción, un elemento con elui-widget-overlaynombre de clase se agrega a<body>。
Dependencias
- UI Core
- Widget Factory
- Position
- Button Widget
- Draggable Widget(opcional; cuando se usa con
draggablela opción) - Resizable Widget(opcional; cuando se usa con
resizablela opción) - Effects Core(opcional; cuando se usa con
showyhidela opción)
Notas adicionales
- Este widget requiere algo de CSS funcional; de lo contrario, no funcionará. Si crea un tema personalizado, utilice el archivo CSS específico del widget como punto de partida.
Ejemplos
Un cuadro de diálogo simple de jQuery UI (Dialog).
<!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>
Otras extensiones