Jqueryui-dialog
JqueryUI-ダイアログ
ダイアログボックスは、HTMLページに情報を表示する優れた方法の1つです。 ダイアログボックスは、タイトルとコンテンツ領域を備えたフローティングウィンドウです。 このウィンドウは、デフォルトで「X」アイコンを使用して移動、サイズ変更、およびもちろん閉じることができます。
jQueryUIは、ダイアログボックスを表示するために、ページに記述されたHTMLコードをHTMLコードに変換する* dialog()*メソッドを提供します。
構文
- dialog()*メソッドは2つの形式で使用できます-
- link:/jqueryui/jqueryui_dialog#dialog_options [$(selector、context).dialog(options)]メソッド
- link:/jqueryui/jqueryui_dialog#dialog_methods [$(selector、context).dialog( "action"、[params])]メソッド
[dialog_options]#
$(セレクター、コンテキスト).dialog(オプション)メソッド
ダイアログ(オプション)オプション
構文
Javascriptオブジェクトを使用して、一度に1つ以上のオプションを提供できます。 提供する複数のオプションがある場合は、次のようにカンマを使用してそれらを分離します-
次の表は、この方法で使用できるさまざまな_オプション_を示しています-
Sr.No. | Option & Description |
---|---|
1 |
このオプションを false に設定すると、 ui-draggable クラスが選択されたDOM要素のリストに追加されなくなります。 デフォルトでは、その値は true です。
このオプションは、指定された要素にダイアログボックスを追加するために使用されます。 デフォルトでは、その値は "body" です。 構文 |
2 |
このオプションは、_false_に設定されていない限り、作成時にダイアログボックスが開きます。 _false_の場合、dialog( 'open')の呼び出し時にダイアログボックスが開きます。 デフォルトでは、その値は true です。
このオプションは、_false_に設定されていない限り、作成時にダイアログボックスが開きます。 _false_の場合、dialog( 'open')の呼び出し時にダイアログボックスが開きます。 デフォルトでは、その値は true です。 構文 |
3 |
このオプションは、ダイアログボックスにボタンを追加します。 これらはオブジェクトとしてリストされ、各プロパティはボタン上のテキストです。 値は、ユーザーがボタンをクリックしたときに呼び出されるコールバック関数です。 デフォルトでは、その値は \ {} です。 オプション-ボタン このオプションは、ダイアログボックスにボタンを追加します。 これらはオブジェクトとしてリストされ、各プロパティはボタン上のテキストです。 値は、ユーザーがボタンをクリックしたときに呼び出されるコールバック関数です。 デフォルトでは、その値は \ {} です。 このハンドラーは、ダイアログボックス要素の関数コンテキストで呼び出され、ボタンをターゲットプロパティとして設定してイベントインスタンスを渡します。 省略すると、ダイアログボックス用のボタンは作成されません。 構文 |
4 |
このオプションを_false_に設定しない限り、ダイアログボックスにフォーカスがあるときにユーザーがEscキーを押すと、ダイアログボックスが閉じられます。 デフォルトでは、その値は true です。
このオプションを_false_に設定しない限り、ダイアログボックスにフォーカスがあるときにユーザーがEscキーを押すと、ダイアログボックスが閉じられます。 デフォルトでは、その値は true です。 構文 |
5 |
このオプションには、閉じるボタンのデフォルトの閉じるを置き換えるテキストが含まれています。 デフォルトでは、その値は "close" です。
このオプションには、閉じるボタンのデフォルトの閉じるを置き換えるテキストが含まれています。 デフォルトでは、その値は "close" です。 構文 |
6 |
このオプションを false に設定すると、 ui-draggable クラスが選択されたDOM要素のリストに追加されなくなります。 デフォルトでは、その値は "" です。
このオプションを false に設定すると、 ui-draggable クラスが選択されたDOM要素のリストに追加されなくなります。 デフォルトでは、その値は "" です。 構文 |
7 |
このオプションを false にしない限り、タイトルバーをクリックしてドラッグすることでダイアログボックスをドラッグできます。 デフォルトでは、その値は true です。 オプション-ドラッグ可能 このオプションを false にしない限り、タイトルバーをクリックしてドラッグすることでダイアログボックスをドラッグできます。 デフォルトでは、その値は true です。 構文 |
8 |
このオプションは、ダイアログボックスの高さを設定します。 デフォルトでは、その値は "auto" です。 オプション-高さ このオプションがダイアログボックスの高さを設定する場合。 デフォルトでは、その値は "auto" です。 このオプションはタイプにすることができます- これはタイプにすることができます-
構文 |
9 |
このオプションは、ダイアログボックスが閉じられたときに使用される効果を設定するために使用されます。 デフォルトでは、その値は null です。 オプション-非表示 このオプションは、ダイアログボックスが閉じられたときに使用される効果を設定するために使用されます。 デフォルトでは、その値は null です。 これはタイプにすることができます-
構文 |
11 |
このオプションは、ダイアログボックスのサイズを変更できる最大の高さをピクセル単位で設定します。 デフォルトでは、その値は false です。
このオプションは、ダイアログボックスのサイズを変更できる最大の高さをピクセル単位で設定します。 デフォルトでは、その値は false です。 構文 |
12 |
このオプションは、ダイアログのサイズを変更できる最大幅をピクセル単位で設定します。 デフォルトでは、その値は false です。
このオプションは、ダイアログのサイズを変更できる最大幅をピクセル単位で設定します。 デフォルトでは、その値は false です。 構文 |
13 |
このオプションは、ダイアログボックスのサイズを変更できる最小の高さ(ピクセル単位)です。 デフォルトでは、その値は 150 です。
このオプションは、ダイアログボックスのサイズを変更できる最小の高さ(ピクセル単位)です。 デフォルトでは、その値は 150 です。 構文 |
14 |
このオプションは、ダイアログボックスのサイズを変更できる最小幅(ピクセル単位)です。 デフォルトでは、その値は 150 です。
このオプションは、ダイアログボックスのサイズを変更できる最小幅(ピクセル単位)です。 デフォルトでは、その値は 150 です。 構文 |
15 |
このオプションが true に設定されている場合、ダイアログはモーダル動作になります。ページ上の他のアイテムは無効になります。つまり、操作することはできません。 モーダルダイアログは、ダイアログの下で、他のページ要素の上にオーバーレイを作成します。 デフォルトでは、その値は false です。 オプション-モーダル このオプションが true に設定されている場合、ダイアログはモーダル動作になります。ページ上の他のアイテムは無効になります。つまり、操作することはできません。 モーダルダイアログは、ダイアログの下で、他のページ要素の上にオーバーレイを作成します。 デフォルトでは、その値は false です。 構文 |
16 |
このオプションは、ダイアログボックスの初期位置を指定します。 _center(デフォルト)、left、right、top、またはbottom_の事前定義された位置のいずれかです。 また、左と上の値(ピクセル単位)が[left、top]のような2要素配列、または['right'、 'top']などのテキスト位置にすることもできます。 デフォルトでは、その値は \ {my: "center"、at: "center"、of:window} です。 オプション-位置 このオプションは、ダイアログボックスの初期位置を指定します。 _center(デフォルト)、left、right、top、またはbottom_の事前定義された位置のいずれかです。 また、左と上の値(ピクセル単位)が[left、top]のような2要素配列、または['right'、 'top']などのテキスト位置にすることもできます。 デフォルトでは、その値は \ {my: "center"、at: "center"、of:window} です。 構文 |
17 |
このオプションは、 false に設定されていない限り、ダイアログボックスはすべての方向にサイズ変更できます。 デフォルトでは、その値は true です。 オプション-サイズ変更可能 このオプションは、 false に設定されていない限り、ダイアログボックスはすべての方向にサイズ変更できます。 デフォルトでは、その値は true です。 構文 |
18 |
このオプションは、ダイアログボックスを開くときに使用する効果です。 デフォルトでは、その値は null です。 オプション-表示 このオプションは、ダイアログボックスを開くときに使用する効果です。 デフォルトでは、その値は null です。 これはタイプにすることができます-
構文 |
20 |
このオプションは、ダイアログボックスのタイトルバーに表示するテキストを指定します。 デフォルトでは、その値は null です。 オプション-タイトル このオプションは、ダイアログボックスのタイトルバーに表示するテキストを指定します。 デフォルトでは、その値は null です。 構文 |
21 |
このオプションは、ダイアログボックスの幅をピクセル単位で指定します。 デフォルトでは、その値は 300 です。 オプション-幅 このオプションは、ダイアログボックスの幅をピクセル単位で指定します。 デフォルトでは、その値は 300 です。 構文 |
次のセクションでは、ダイアログ機能の実際の例をいくつか示します。
デフォルトの機能
次の例は、* dialog()*メソッドにパラメーターを渡さないダイアログ機能の簡単な例を示しています。
上記のコードをHTMLファイル dialogexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
ボタン、タイトル、位置の使用
次の例は、JqueryUIのダイアログウィジェットでの3つのオプション*ボタン*、*タイトル*および*位置*の使用方法を示しています。
上記のコードをHTMLファイル dialogexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
hide、show、heightの使用
次の例は、JqueryUIのダイアログウィジェットで3つのオプション hide 、 show および height を使用する方法を示しています。
上記のコードをHTMLファイル dialogexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
モーダルの使用
次の例は、JqueryUIのダイアログウィジェットでの3つのオプション*ボタン*、*タイトル*および*位置*の使用方法を示しています。
上記のコードをHTMLファイル dialogexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
$(セレクター、コンテキスト).dialog( "action"、[params])メソッド
_dialog(action、params)_メソッドは、ダイアログボックスに対して、ボックスを閉じるなどのアクションを実行できます。 action は最初の引数で文字列として指定され、オプションで、指定されたアクションに基づいて1つ以上の params を提供できます。
'_基本的に、ここでのアクションは何もありませんが、文字列の形で使用できるjQueryメソッドです。_
構文
次の表は、このメソッドのアクションを示しています-
Sr.No. | Action & Description |
---|---|
1 |
このアクションにより、ダイアログボックスが閉じます。 このメソッドは引数を取りません。 アクション-close() このアクションにより、ダイアログボックスが閉じます。 このメソッドは引数を取りません。 構文 |
2 |
このアクションにより、ダイアログボックスが完全に削除されます。 これにより、要素は初期化前の状態に戻ります。 このメソッドは引数を取りません。 アクション-destroy() このアクションにより、ダイアログボックスが完全に削除されます。 これにより、要素は初期化前の状態に戻ります。 このメソッドは引数を取りません。 構文 |
3 |
このアクションは、ダイアログボックスが開いているかどうかを確認します。 このメソッドは引数を取りません。 アクション-isOpen() このアクションは、ダイアログボックスが開いているかどうかを確認します。 このメソッドは引数を取りません。 構文 |
4 |
このアクションは、対応するダイアログボックスを前景(他のダイアログボックスの上)に配置します。 このメソッドは引数を取りません。 アクション-moveToTop() このアクションは、対応するダイアログボックスを前景(他のダイアログボックスの上)に配置します。 このメソッドは引数を取りません。 構文 |
5 |
このアクションにより、ダイアログボックスが開きます。 このメソッドは引数を取りません。 アクション-open() このアクションにより、ダイアログボックスが開きます。 このメソッドは引数を取りません。 構文 |
6 |
このアクションは、指定されたoptionNameに現在関連付けられている値を取得します。 ここで、_optionName_は取得するオプションの名前です。 アクション-option(optionName) このアクションは、指定されたoptionNameに現在関連付けられている値を取得します。 ここで、_optionName_は取得するオプションの名前です。 構文 |
7 |
このアクションは、現在のダイアログオプションハッシュを表すキー/値ペアを含むオブジェクトを取得します。 このメソッドは引数を取りません。 アクション-option() このアクションは、現在のダイアログオプションハッシュを表すキー/値ペアを含むオブジェクトを取得します。 このメソッドは引数を取りません。 構文 |
8 |
このアクションは、指定されたoptionNameに関連付けられたダイアログオプションの値を設定します。 アクション-option(optionName、value) このアクションは、指定されたoptionNameに関連付けられたダイアログオプションの値を設定します。 構文 |
9 |
このアクションは、ダイアログの1つ以上のオプションを設定します。 アクション-オプション(オプション) このアクションは、ダイアログの1つ以上のオプションを設定します。 構文 |
10 |
このアクションは、ダイアログボックスのウィジェット要素を返します。 ui-dialogクラス名で注釈が付けられた要素。 このメソッドは引数を取りません。 アクション-ウィジェット() このアクションは、ダイアログボックスのウィジェット要素を返します。 ui-dialogクラス名で注釈が付けられた要素。 このメソッドは引数を取りません。 構文 |
例
ここで、上の表のアクションを使用した例を見てみましょう。 次の例は、isOpen()、_ open()_、および_close()_メソッドの使用方法を示しています。
上記のコードをHTMLファイル dialogexample に保存して、JavaScriptをサポートする標準のブラウザで開きます。次の出力も確認する必要があります-
ダイアログボックスでのイベント管理
前のセクションで見たダイアログ(オプション)メソッドに加えて、JqueryUIは特定のイベントに対してトリガーされるイベントメソッドを提供します。 これらのイベントメソッドは以下のとおりです-
Sr.No. | Event Method & Description |
---|---|
1 |
このイベントは、ダイアログボックスが閉じようとするときにトリガーされます。 _false_を返すと、ダイアログボックスが閉じなくなります。 検証に失敗したフォームを持つダイアログボックスに便利です。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-beforeClose(event、ui) このイベントは、ダイアログボックスが閉じようとするときにトリガーされます。 _false_を返すと、ダイアログボックスが閉じなくなります。 検証に失敗したフォームを持つダイアログボックスに便利です。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 構文 |
2 |
このイベントは、ダイアログボックスが閉じられるとトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-close(event、ui) このイベントは、ダイアログボックスが閉じられるとトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 構文 |
3 |
このイベントは、ダイアログボックスが作成されたときにトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-create(event、ui) このイベントは、ダイアログボックスが作成されたときにトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 構文 |
4 |
ドラッグ中にダイアログボックスが移動すると、このイベントが繰り返しトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-drag(event、ui) ドラッグ中にダイアログボックスが移動すると、このイベントが繰り返しトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 _ui_の可能な値は-
構文 |
5 |
このイベントは、タイトルバーをドラッグしてダイアログボックスの位置を変更すると開始されます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-dragStart(event、ui) このイベントは、タイトルバーをドラッグしてダイアログボックスの位置を変更すると開始されます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 _ui_の可能な値は-
構文 |
6 |
このイベントは、ドラッグ操作が終了するとトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-dragStop(event、ui) このイベントは、ドラッグ操作が終了するとトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 _ui_の可能な値は-
構文 |
7 |
このイベントは、ダイアログがフォーカスを取得したときにトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-focus(event、ui) このイベントは、ダイアログがフォーカスを取得したときにトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 構文 |
8 |
このイベントは、ダイアログボックスが開いたときにトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-open(event、ui) このイベントは、ダイアログボックスが開いたときにトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 構文 |
9 |
このイベントは、ダイアログボックスのサイズが変更されると繰り返しトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-resize(event、ui) このイベントは、ダイアログボックスのサイズが変更されると繰り返しトリガーされます。 _event_は_Event_型であり、_ui_は_Object_型です。_ui_の可能な値は-
構文 |
10 |
このイベントは、ダイアログボックスのサイズ変更が開始されるとトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-resizeStart(event、ui) このイベントは、ダイアログボックスのサイズ変更が開始されるとトリガーされます。 _event_は_Event_型であり、_ui_は_Object_型です。_ui_の可能な値は-
構文 |
11 |
このイベントは、ダイアログボックスのサイズ変更が終了するとトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-resizeStop(event、ui) このイベントは、ダイアログボックスのサイズ変更が終了するとトリガーされます。 _event_は_Event_型であり、_ui_は_Object_型です。_ui_の可能な値は-
構文 |
次の例は、上記の表にリストされているイベントの使用法を示しています。
beforeCloseイベントメソッドの使用
次の例は、 beforeClose イベントメソッドの使用方法を示しています。
上記のコードをHTMLファイル dialogexample に保存して、JavaScriptをサポートする標準のブラウザで開きます。次の出力も確認する必要があります-
resize Eventメソッドの使用
次の例は、 resize イベントメソッドの使用方法を示しています。
上記のコードをHTMLファイル dialogexample に保存して、JavaScriptをサポートする標準のブラウザで開きます。次の出力も確認する必要があります-
拡張ポイント
ダイアログウィジェットは、ウィジェットファクトリで構築されており、拡張できます。 ウィジェットを拡張するには、既存のメソッドの動作をオーバーライドまたは追加できます。 次のメソッドは、ダイアログメソッドと同じAPI安定性を拡張ポイントとして提供します。 リンク:/jqueryui/jqueryui_dialog#dialog_methods [上記の表]にリストされています。
Sr.No. | Method & Description |
---|---|
1 |
このメソッドを使用すると、ユーザーはダイアログの子ではないがユーザーは使用できるようにする要素をホワイトリストに登録することで、指定されたターゲット要素と対話できます。 ここで、_event_は_Event_型です。 拡張ポイント-allowInteraction(event、ui) このメソッドを使用すると、ユーザーはダイアログの子ではないがユーザーは使用できるようにする要素をホワイトリストに登録することで、指定されたターゲット要素と対話できます。 ここで、_event_は_Event_型です。 コード例 |
this._super( event ); } ----
|
'_jQuery UIウィジェットファクトリは、jQuery UIのすべてのウィジェットが構築される拡張可能なベースです。 ウィジェットファクトリを使用してプラグインを作成すると、状態管理に便利なだけでなく、プラグインメソッドの公開やインスタンス化後のオプションの変更などの一般的なタスクの規則が提供されます。_