3.5.6. 通知消息

通知消息是显示在主应用程序窗口中间或者角落的弹窗。这些弹窗能自动消失,也可以在用户点击界面或按下 Esc 时消失。

要显示通知消息,可以在界面控制器中注入 Notifications bean 然后使用其流式接口。在下面的例子中,点击按钮会显示通知消息:

  1. @Inject
  2. private Notifications notifications;
  3. @Subscribe("sayHelloBtn")
  4. protected void onSayHelloBtnClick(Button.ClickEvent event) {
  5. notifications.create().withCaption("Hello!").show();
  6. }

一个通知消息可以有一条描述,描述使用更轻的字体展示在标题下面:

  1. @Inject
  2. private Notifications notifications;
  3. @Subscribe("sayHelloBtn")
  4. protected void onSayHelloBtnClick(Button.ClickEvent event) {
  5. notifications.create().withCaption("Greeting").withDescription("Hello World!").show();
  6. }

通知消息有以下类型:

  • TRAY - 显示在应用程序右下角的消息,会自动消失。

  • HUMANIZED – 显示在界面中间的标准消息,会自动消失。

  • WARNING – 警告消息。当用户点击界面时消失。

  • ERROR– 错误消息。当用户点击界面时消失。

默认类型是 HUMANIZED。也可以在 create() 方法中使用其他类型:

  1. @Inject
  2. private Notifications notifications;
  3. @Subscribe("sayHelloBtn")
  4. protected void onSayHelloBtnClick(Button.ClickEvent event) {
  5. notifications.create(Notifications.NotificationType.TRAY).withCaption("Hello World!").show();
  6. }

可以在消息中使用 \n 来换行。如果需要显示 HTML,可以用 withContentMode() 方法:

  1. @Inject
  2. private Notifications notifications;
  3. @Subscribe("sayHelloBtn")
  4. protected void onSayHelloBtnClick(Button.ClickEvent event) {
  5. notifications.create()
  6. .withContentMode(ContentMode.HTML)
  7. .withCaption("<i>Hello World!</i>")
  8. .show();
  9. }

当使用 HTML 时,别忘了对数据进行转义,以防恶意代码注入。

其他诸如 withHideDelayMs()withPosition()withStyleName() 的方法可以用来自定义通知消息的外观和行为。