1. SPEAKのご紹介

MessageBarコントロールへのメッセージの動的な追加

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

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

MessageBarコントロールは、ユーザーにメッセージを表示します。Sitecore Rocksでページをデザインするときに、SPEAKページにメッセージを追加できます。ただし、実際には、メッセージを表示する必要があるかどうか、または考えられるメッセージのテキストを表示する必要があるかどうかを設計時に知らないことがよくあります。

この状況では、メッセージをSPEAKページに動的に追加できます。 MessageBarコントロールはページに追加しますが、コントロールにはメッセージを追加しません。

たとえば、ページでMessageBarコントロールがMessageBar1と呼ばれている場合は、次のようにJavaScriptでメッセージを追加できます。

define(["sitecore"], function (Sitecore) {
    var Messages = Sitecore.Definitions.App.extend({
        initialized: function () {
            this.MessageBar1.addMessage("notification", {
                text: "Read this",
                actions: [{ text: 'Resolve', action: 'javascript: alert("Alert")' }],
                closable: true
            });
        }
    });
    return Messages;
});

これは単にPageCodeにメッセージを追加するだけであり、そのままでは、このコードはSPEAKがページを初期化したときにメッセージを追加するだけです。

addMessageメソッドはメッセージを追加します。最初のパラメーターはメッセージのタイプです。次のリテラル値を指定できます。

  • error

  • warning

  • notification

2番目のパラメーターはオブジェクトです。

  • text: これは、MessageBarコントロールに表示される実際のテキストです

  • actions: これにより、メッセージ内にアクション リンクが作成されます。 textリンクに表示されるテキストです。 actionは、訪問者がリンクをクリックしたときにトリガーするアクションです。

  • closable: trueの場合、訪問者はメッセージを閉じることができます

アクション オブジェクトに追加することで、メッセージに複数のアクション リンクを挿入できます。

次のメソッドは、MessageBarコントロールが現在表示しているすべてのメッセージを削除します。

this.MessageBar1.removeMessages()

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