メッセージバー
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
MessageBarコントロールはユーザーにメッセージを表示します。メッセージのアクションへのリンクを追加できます。MessageBarコントロールのスタイリングは変更できず、コントロールのサイズも設定できません。
MessageBarコントロールは、Messageプロパティで指定したMessage項目を表示します。MessageFeaturesプロパティにパイプ分離されたMessageアイテムIDのリストを追加することで、1つのMessageBarコントロールに複数のメッセージを追加できます。この場合、MessageBarコントロールはメッセージリストの最初のメッセージを表示し、MessageBarコントロールが自動的に追加するドロップダウン矢印をクリックすると、残りのメッセージが表示されます。
メッセージアイテムとは、MessageTypeテンプレートに基づくSitecoreアイテムのことです。MessageTypeテンプレートには3つの異なるものがあります:
- エラーメッセージ
- 警告メッセージ
- 通知メッセージ
3種類のメッセージはスタイルが異なりますが、基本的な機能は同じです。それぞれのフィールドは以下の通りです:
- テキスト – メッセージのテキスト
- IsClosable – もし「True」なら、ユーザーはメッセージを閉じることができます
- IsTemporary – Trueの場合、メッセージは一定時間後に自動的に閉じられます(このフィールドを持つのは通知メッセージタイプのみです)
MessageBarコントロールに複数のメッセージを追加しても、メッセージが同じタイプである必要はありません。
行動リンク
メッセージには1つ以上のアクションリンクがあります。アクションリンクを追加するには、ActionsLinkテンプレートに基づいてアイテムを作成し、そのアイテムを メッセージ アイテムのActionフィールドに追加します。このアイテムには2つのフィールドがあります:
- テキスト(ユーザーが見るものです)。
- アクション。例えば、JavaScriptなどが挙げられます。
メッセージに複数のアクションリンクを追加できます。
メッセージを表示・非表示にしましょう。
時にはPageCodeでMessageBarコントロールを表示するタイミングやルールで決める必要がありますが、他の方法を使う簡単なシナリオもあります。
例えば、検索結果を表示するダイアログがあり、SearchDataSourceコンポーネントを使ってアイテムを取得している場合です。この場合、検索でアイテムが見つからなければ、ユーザーに通知を表示したいのです。
これを行うには、ダイアログにMessageBarコントロールを追加し、IsVisibleをFalseに設定します。 MessageBarコントロールのIsVisibleプロパティをSearchDataSourceコンポーネントのhasNoItemsメンバーにバインドします。検索結果にアイテムがない場合、MessageBarコントロールが表示され通知が表示されます。
性質
名称
概要
デフォルト
データ
メッセージ
MessageBarコントロールに表示されるMessageアイテムのアイテムIDを指定します。複数のメッセージをパイプ分離リストとして指定できます。
構成
MessageBarコントロールの設定項目は、MessageBarパラメータテンプレートに基づいてアイテムを作成することで作成できます。
設定項目には以下の特定のフィールドがあります:
- メッセージ
以下の場を継承します:
- IsVisible(見えるもの)
- アクセスキー
- ツールチップ
- 行動
- ID