この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

force:showToast

トースト通知にメッセージを表示します。

トーストによって、ビューの上部のヘッダーの下にメッセージが表示されます。メッセージは message 属性で指定されます。

次の例では、トーストメッセージ「Success! The record has been updated successfully.」が表示されます。

1showToast : function(component, event, helper) {
2    var toastEvent = $A.get("e.force:showToast");
3    toastEvent.setParams({
4        "title": "Success!",
5        "message": "The record has been updated successfully."
6    });
7    toastEvent.fire();
8}

このイベントは、one.app コンテナによって処理されます。Lightning Experience および Salesforce1 でのみサポートされています。Lightning Experience または Salesforce1 の外部で使用されると、このイベントは自動的に処理されません。このイベントを one.app の外部で使用するには、独自のイベントハンドラを作成して結び付けます。

メモ

トーストで使用される背景色とアイコンは、type 属性によって制御されます。たとえば、success に設定すると、トースト通知は緑の背景とチェックマークアイコンで表示されます。mode 属性が dismissible の場合、トーストは 5000 ミリ秒間表示され、右上隅に [閉じる] ボタンが表示されます。

属性名	型	説明
`title`	String	太字で表示されるトーストのタイトルを指定します。
`message`	String	必須。表示するメッセージを指定します。
`key`	String	トースト種別が `other` の場合のアイコンを指定します。アイコンキーは「Lightning Design System Resources」(Lightning Design System のリソース) ページに記載されています。
`duration`	Integer	トーストの期間 (ミリ秒)。デフォルト値は 5000 ミリ秒です。
`type`	String	トースト種別。`error`、`warning`、`success`、`info` のいずれかを指定できます。デフォルトは `other` で、`info` トーストのようなスタイルですが、`key` 属性で指定しない限りアイコンは表示されません。API バージョン 37.0 以降で利用できます。
`mode`	String	トーストモード。ユーザがトーストを消去できる場合の消去方法を制御します。デフォルトは `dismissible` で、[閉じる] ボタンを表示します。API バージョン 37.0 以降で利用できます。有効な値は次のとおりです。 `dismissible`: [閉じる] ボタンを押すか、`duration` が経過するかのいずれかが生じるまで表示されたままになります。 `pester`: `duration` が経過するまで表示されたままになります。[閉じる] ボタンは表示されません。 `sticky`: [閉じる] ボタンを押すまで表示されたままになります。

Lightning コンポーネント開発者ガイド

force:showToast