jQuery UI API - Dialog-Widget

Kategorie

小部件

Nutzung

Beschreibung:Inhalt in einem interaktiven Overlay öffnen.

Hinzugefügt in Version:1.0

Der Dialog ist ein schwebendes Fenster, das eine Titelleiste und einen Inhaltsbereich enthält. Das Dialogfenster kann verschoben, in der Größe geändert und standardmäßig mit dem 'x'-Symbol geschlossen werden.

Wenn die Inhaltslänge die maximale Höhe überschreitet, wird automatisch eine Bildlaufleiste angezeigt.

Eine untere Schaltflächenleiste und ein halbtransparentes modales Overlay sind übliche Ergänzungen.

Fokus

Wenn ein Dialog geöffnet wird, wird der Fokus automatisch auf das erste Element verschoben, das die folgenden Bedingungen erfüllt:

  1. withautofocusAttribut
  2. Das erste innerhalb des Dialoginhalts:tabbableelement
  3. Das erste innerhalb des Dialog-Schaltflächenbereichs:tabbableelement
  4. Die Schließen-Schaltfläche des Dialogs
  5. Der Dialog selbst

Beim Öffnen stellt das Dialog-Widget sicher, dass der Fokus mit der Tabulatortaste zwischen Elementen innerhalb des Dialogs verschoben wird, wobei Elemente außerhalb des Dialogs ausgeschlossen sind. Modale Dialoge verhindern, dass Mausbenutzer auf Elemente außerhalb des Dialogs klicken.

Wenn der Dialog geschlossen wird, kehrt der Fokus automatisch zu dem Element zurück, das den Fokus hatte, bevor der Dialog geöffnet wurde.

Schließen-Schaltfläche ausblenden

In manchen Fällen möchten Sie vielleicht die Schließen-Schaltfläche ausblenden, zum Beispiel, wenn bereits eine Schließen-Schaltfläche im Schaltflächenbereich vorhanden ist. Die beste Lösung ist über CSS. Sie können beispielsweise eine einfache Regel wie die folgende definieren:

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

Dann können Sieno-closeclass zu jedem Dialog hinzufügen, um die Schließen-Schaltfläche auszublenden:

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

主题

Das Dialog-Widget verwendetjQuery UI CSS Framework, um das Styling seines Aussehens und seiner Anmutung zu definieren. Wenn Sie dialogspezifische Stile verwenden müssen, können Sie die folgenden CSS-Klassennamen verwenden:

  • ui-dialog: Der äußere Container des Dialogs.
    • ui-dialog-titlebar: Die Titelleiste, die den Dialogtitel und die Schließen-Schaltfläche enthält.
      • ui-dialog-title: Der Container um den Titel des Dialogtexts.
      • ui-dialog-titlebar-close: Die Schließen-Schaltfläche des Dialogs.
    • ui-dialog-content: Der Container um den Dialoginhalt. Dies ist auch das Element, auf dem das Widget instanziiert wird.
    • ui-dialog-buttonpane: Das Panel, das die Dialog-Schaltflächen enthält. Dies wird nur gerendert, wenn diebuttonsOption gesetzt ist.
      • ui-dialog-buttonset: Der Container um die Schaltflächen.

Wenn außerdem diemodalOption gesetzt ist, wird ein Element mit demui-widget-overlayKlassennamen angehängt an<body>。

Abhängigkeiten

Zusätzliche Hinweise

  • Dieses Widget benötigt etwas funktionales CSS, andernfalls funktioniert es nicht. Wenn Sie ein benutzerdefiniertes Theme erstellen, verwenden Sie die widgetspezifische CSS-Datei als Ausgangspunkt.

Beispiele

Ein einfacher 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>

Andere Erweiterungen