jQuery UI API - ダイアログウィジェット(Dialog Widget)

所属カテゴリ

ウィジェット(Widgets)

使用法

説明:インタラクティブなオーバーレイ内にコンテンツを開きます。

追加されたバージョン:1.0

ダイアログは、タイトルバーとコンテンツ領域を含むフローティングウィンドウです。ダイアログウィンドウは移動やサイズ変更が可能で、デフォルトでは「x」アイコンで閉じます。

コンテンツの長さが最大の高さを超えると、スクロールバーが自動的に表示されます。

下部のボタンバーと半透明のモーダルオーバーレイは、一般的な追加オプションです。

フォーカス

ダイアログを開くと、フォーカスは以下の条件を満たす最初の項目に自動的に移動します:

  1. 次の属性を持つautofocusダイアログ内の最初の要素
  2. ダイアログのコンテンツ内の最初の:tabbable要素
  3. ダイアログのボタンパネル内の最初の:tabbable要素
  4. ダイアログの閉じるボタン
  5. ダイアログ自体

開くと、ダイアログウィジェット(Dialog Widget)は、Tab キーによるダイアログ内の要素間のフォーカスの移動を保証し、ダイアログ外の要素は含みません。モーダルダイアログは、マウスユーザーがダイアログ外の要素をクリックするのを防ぎます。

ダイアログを閉じると、フォーカスは、ダイアログが開かれたときにフォーカスを取得していた要素に自動的に戻ります。

閉じるボタンを非表示にする

状況によっては、閉じるボタンを非表示にしたい場合があります。たとえば、ボタンパネルにすでに閉じるボタンがある場合などです。最善の解決策は CSS を使用することです。例として、次のような簡単なルールを定義できます:

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

その後、no-closeclass を任意のダイアログに追加して、閉じるボタンを非表示にできます:

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

テーマ化

ダイアログウィジェット(Dialog Widget)は、jQuery UI CSS フレームワークを使用して、外観とフィーリングのスタイルを定義します。ダイアログ固有のスタイルが必要な場合は、以下の CSS class 名を使用できます:

  • 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-overlayclass 名を持つ要素が追加されます。<body>。

依存関係

補足説明

  • このウィジェットは、機能上必要な CSS がいくつかあります。そうしないと動作しません。カスタムテーマを作成する場合は、ウィジェット固有の CSS ファイルを起点として使用してください。

例

シンプルな 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>

その他の拡張