ダイアログウィンドウ
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
DialogWindowコントロールには、モーダルかどうかのダイアログが表示されます。コンテンツは内部または外部にすることができます。
内部コンテンツを作成するには、DialogWindowコントロールが提供するプレースホルダーにSPEAKレンダリングを追加します。
外部コンテンツを指定するには、DialogWindowコントロールにFrameコントロールを追加し、このFrameコントロールを設定してSitecoreダイアログまたはWebサイトを表示します。
DialogWindowコントロールを開く/閉じる
DialogWindowコントロールを開く/閉じる
DialogWindowコントロールを開いたり閉じたりするために発生させることができるイベントは3つあります。
|
出来事 |
形容 |
|---|---|
|
見せる |
DialogWindowコントロールを表示 (開く) します |
|
隠れる |
DialogWindowコントロールを非表示 (「閉じる」) します |
|
トグル |
DialogWindowコントロールの現在の状態を切り替えます |
DialogWindowコントロールを含むページをユーザーが開いたときにすぐにDialogWindowコントロールを表示する場合は、含まれているページのページ コードからshowイベントを呼び出すことができます。
多くの場合、ユーザーがクリックしてDialogWindowコントロールを開くことができるボタンを表示する必要があります。このJavaScriptをボタンのClickプロパティに追加できます。
HeaderLessプロパティがFalseの場合 (これが既定値)、DialogWindowコントロールのヘッダーに閉じるボタンが表示されます。ユーザーがこの "X" をクリックすると、DialogWindowコントロールが閉じます。
EnableKeyboardプロパティがTrueの場合 (これが既定値)、ユーザーはEscキーを押してDialogWindowコントロールを閉じることができます。
hideイベントを使用して、DialogWindowコントロールを閉じることもできます。たとえば、ボタンをClickプロパティに以下を追加できます。
toggleイベントは、DialogWindowコントロールの状態を切り替えます。 DialogWindowコントロールが表示されていない場合はtoggleイベントで表示され、表示されている場合はtoggleイベントで非表示になります。
プレースホルダー
プレースホルダー
-
DialogWindowコントロールには、次の4つのプレースホルダーがあります。
-
Actions:最も重要なボタンをここに配置します。DialogWindowコントロールに関連付けられているアクションが多数ある場合は、ActionControlコントロールを使用できます。このプレースホルダーにコントロールを配置すると、通常は表示される "X" は表示されず、クリックできません。ユーザーがDialogWindowコントロールを閉じる他の方法を少なくとも1つ持っていることを確認する必要があります。TextプロパティでDialogWindowコントロールのタイトルを指定すると、SPEAKはこのタイトルをActionsプレースホルダーに表示します。
-
Buttons:ここにセカンダリボタンを配置します。
-
Navigation
-
Content: このプレースホルダーは、DialogWindowコントロールの主要部分に必要なSPEAKレンダリングに使用します。
DialogWindowコントロールをHeaderLessに指定した場合、Action、Buttons、およびNavigationプレースホルダは表示されません。
DialogWindowコントロールが外部にある場合は、通常、ContentプレースホルダにFrameコントロールを配置し、他のプレースホルダは使用しません。
プロパティ
プロパティ
|
Name |
Description |
Default |
|---|---|---|
|
Appearance | ||
|
キーボードの有効化 |
Trueの場合、ユーザーはEscキーを使用してダイアログを閉じることができます。 メモ これをFalseに設定し、ダイアログ ボックスにヘッダーがない場合は、ユーザーがダイアログ ボックスを閉じる方法を手動で作成する必要があります。 |
真 |
|
ヘッダーレス |
Trueの場合、ダイアログ ボックスにはタイトル付きのヘッダーがありません。また、ユーザーがダイアログ ボックスを閉じるために使用できる "X" は表示されません。 |
偽 |
|
アニメーション化 |
Trueの場合、ダイアログ ボックスは開いたり閉じたりするときにスライドインおよびスライド アウトします。 |
偽 |
|
イスモーダル |
Trueの場合、ダイアログ ボックスはモーダルです。 |
真 |
|
大きさ |
ダイアログボックスのサイズを指定します。次の5つの値を使用できます。
|
中程度 |
|
テキスト |
ダイアログボックスのヘッダーテキストを指定します。 HeaderLessプロパティがTrueの場合、このテキストはダイアログ ボックスに表示されません。 | |