[译] 在 Rails 中使用 Flash Message（即时信息）

（本文翻译自：https://www.rubyguides.com/2019/11/rails-flash-messages/）

什么是即时信息？

即时信息是即时信息是一种将信息显示给你的 Rails 网站用户的一种方式，用于告诉他们发生了什么事。

示例：

• 密码被修改（确认提示）
• 用户没有找到（错误信息）

即时信息每每在 Controller 中设置即时信息，而后再视图中渲染出来。你的用户获得所须要的信息。

让咱们来学习它如何工做。

如何使用即时信息

你能够经过使用 flash 助手函数，来发起提示信息。

他们用起来很像 Ruby hash。

即时信息对象具备像 keys，any?，或者 each 这种方法，要访问即时信息，则是使用 []。

那么，你能够设置哪些类型的的消息呢？

默认状况下，你能够设置：

• notice
• alert

这是一个使用例子：

flash.alert = "User not found."

另外一种风格：

flash[:alert] = "User not found."

（二者只是风格不一样）

你可使用这些代码，在你的 Controller Actions 中，好比 index，create，new 之类的。

另外一种使用方式：

redirect_to :books_path, notice: "Book not found"

这容许你在一步中，重定向页面和建立即时消息。

这很棒呦！

Alert 对比 Notice

据我了解，alert 或者 notice 具体使用哪一个，不是很重要。哪一个用着合适，就用哪一个。

我习惯使用 alert 显示错误信息，使用 notice 显示一些提示信息。

二者主要仍是风格的区别。

举个例子

你能够将 alert 显示为红色，将 notice 显示为绿色。

你也能够根据须要，在控制器中，使用 add_flash_types，来建立你本身的消息类型。

像这样：

class ApplicationController
  add_flash_types :info, :error, :warning
end

我喜欢保持简单，因此内置的消息类型已经足够我用啦。

渲染即时信息

即时信息不会自动显示，你必须在你的视图上渲染他们，而后才能看到。您能够考虑将他们添加到布局视图上。

这是代码：

<% flash.each do |type, msg| %>
  <div>
    <%= msg %>
  </div>
<% end %>

这这句代码放在你想显示它们的地方，一般是放在页面顶端，菜单栏下面。

记住：

即时消息只会显示一次，而后就会被移除，不会再显示。

美化你的即时消息

即时消息默认没有内置样式。

若是你使用 Bootstrap，你能够将 alert alert-info CSS 类添加到即时消息上，它们会看起来好看不少。

例子：

<% flash.each do |type, msg| %>
  <div class="alert alert-info">
    <%= msg %>
  </div>
<% end %>

若是你没有使用 Bootstrap，你能够根据你的需求，自定义通知的样式。

什么时候须要显示即时消息？

即时消息被显示出来后，将在控制器下一次动做时被移除。

根据这个特性，作一个总结：

• 若是你调用 redirect_to，并显示出 flash hash 中的即时消息，那么一切正常
• 若是你调用 redirect_to，但并无显示出即时消息，那么消息仍然保存在 flash hash 中
• 若是你在设置消息到 flash hash 同一个 action 中显示即时消息，那么 flash 消息会被显示出来，可是 flash 中的消息不会被删除，因此它会被显示两次。

因此……

该如何在当前的 action 中显示即时消息呢？

flash.now 闪亮登场。

这是一个例子：

def index
  @books = Book.all
  flash.now[:notice] = "We have exactly #{@books.size} books available."
end

这将在 index 视图渲染出即时消息。

notice 中的内容将被显示，随即就被删除掉，使用这种方式，消息不会被显示两次。

因此，当你想要使用 render 而不是重定向页面的时候，你须要使用 flash.now 来进行消息显示。

总结

在本文中，你学习到了关于 Rails 中，有关即时消息的知识，以及如何正确使用它。

最后，须要注意的是，即时消息与错误验证之间的区别。错误验证是与模型对象有关的，你须要使用模型的 errors 方法，来访问有关验证错误的信息，好比 @user.errors。

如今是时候去写一些代码，来实践在本文中学到的知识啦。

感谢阅读。