1. コンポーネントライブラリ

メッセージバー

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

MessageBarコントロールは、ユーザーにメッセージを表示します。アクションへのリンクをメッセージに追加できます。MessageBarコントロールのスタイルを変更したり、コントロールのサイズを設定したりすることはできません。

MessageBarコントロールにはMessageMessagesプロパティで指定した項目が表示されます。1つのMessageBarコントロールに複数のメッセージを追加するには、MessagesプロパティにMessage項目IDのパイプ区切りリストを追加します。この場合、MessageBarコントロールにはメッセージの一覧の最初のメッセージが表示され、残りのメッセージは、MessageBarコントロールによって自動的に追加されるドロップダウン矢印をユーザーがクリックすると使用可能になります。

Messageアイテムは、MessageTypeテンプレートに基づくSitecoreアイテムです。MessageTypeテンプレートには、次の3種類があります。

  • エラーメッセージ

  • 警告メッセージ

  • 通知メッセージ

3種類のメッセージのスタイルは異なりますが、基本的な機能は同じです。これらのフィールドがあります。

  • テキスト – メッセージテキスト

  • IsClosable – Trueの場合、ユーザーはメッセージを閉じることができます

  • IsTemporary: Trueの場合、メッセージはしばらくすると自動的に閉じます (このフィールドがあるのはNotificationメッセージの種類のみです)。

MessageBarコントロールに複数のメッセージを追加する場合、メッセージの種類が同じである必要はありません。

アクションリンク

メッセージには、1つ以上のアクション リンクを含めることができます。アクション リンクを追加するには、ActionsLinkテンプレートに基づいてアイテムを作成し、そのアイテムをMessageアイテムのActionフィールドに追加します。このアイテムには2つのフィールドがあります。

  • Text: リンクの名前 (ユーザーに表示される内容)。

  • Action: リンクをクリックしたときにトリガーされるアクション。たとえば、JavaScriptなどです。

メッセージには複数のアクションリンクを追加できます。

メッセージの表示と非表示を切り替えます。

MessageBarコントロールをPageCodeまたはルールを使用して表示するタイミングを決定する必要がある場合がありますが、他の方法を使用できる簡単なシナリオもあります。

たとえば、検索結果を表示するダイアログがあり、SearchDataSourceコンポーネントを使用してアイテムを取得する場合です。この場合、検索でアイテムが見つからない場合は、ユーザーに通知を表示する必要があります。

これを行うには、ダイアログにMessageBarコントロールを追加し、IsVisibleをFalseに設定します。MessageBarコントロールのIsVisibleプロパティをSearchDataSourceコンポーネントのhasNoItemsメンバーにバインドします。検索結果に項目がない場合は、MessageBarコントロールが表示され、通知が表示されます。

プロパティ

Name

Description

Default

Data

メッセージ

MessageBarコントロールに表示されるMessage項目の項目IDを指定します。複数のメッセージをパイプで区切られたリストとして指定できます。

構成

MessageBarコントロールの構成項目を作成するには、MessageBar Parametersテンプレートに基づいて項目を作成します。

構成アイテムには、次の特定のフィールドがあります。

  • メッセージ

次のフィールドを継承します。

  • 目に見える

  • アクセスキー

  • ツールチップ

  • 動作

  • 身分証明書

この記事を改善するための提案がある場合は、 お知らせください!