jQuery UI API - ダイアログウィジェット(Dialog Widget)
所属カテゴリ
使用法
説明:インタラクティブなオーバーレイ内にコンテンツを開きます。
追加されたバージョン:1.0
ダイアログは、タイトルバーとコンテンツ領域を含むフローティングウィンドウです。ダイアログウィンドウは移動やサイズ変更が可能で、デフォルトでは「x」アイコンで閉じます。
コンテンツの長さが最大の高さを超えると、スクロールバーが自動的に表示されます。
下部のボタンバーと半透明のモーダルオーバーレイは、一般的な追加オプションです。
フォーカス
ダイアログを開くと、フォーカスは以下の条件を満たす最初の項目に自動的に移動します:
- 次の属性を持つ
autofocusダイアログ内の最初の要素 - ダイアログのコンテンツ内の最初の
:tabbable要素 - ダイアログのボタンパネル内の最初の
:tabbable要素 - ダイアログの閉じるボタン
- ダイアログ自体
開くと、ダイアログウィジェット(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>。
依存関係
- UI コア(UI Core)
- ウィジェットファクトリー(Widget Factory)
- ポジション(Position)
- ボタンウィジェット(Button Widget)
- ドラッグ可能ウィジェット(Draggable Widget)(オプション。
draggableオプションと一緒に使用する場合) - サイズ変更可能ウィジェット(Resizable Widget)(オプション。
resizableオプションと一緒に使用する場合) - エフェクトコア(Effects Core)(オプション。
showとhideオプションと一緒に使用する場合)
補足説明
- このウィジェットは、機能上必要な 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>
その他の拡張