Action View 助手

阅读本指南后，您将了解

如何格式化日期、字符串和数字。
如何处理文本和标签。
如何链接到图像、视频、样式表等。
如何在视图中处理 Atom 源和 JavaScript。
如何缓存、捕获、调试和净化内容。

以下概述了 Action View 中可用的一些最常用的辅助方法。它是一个很好的起点，但也建议查阅完整的API 文档，因为它更详细地涵盖了所有辅助方法。

2. 表单

与单独使用标准 HTML 元素相比，表单辅助方法简化了与模型的工作。它们提供了一系列根据您的模型生成表单的方法。有些方法对应于特定类型的输入，例如文本字段、密码字段、选择下拉列表等。当表单提交时，表单中的输入被分组到 params 对象中并发送回控制器。

您可以在Action View 表单辅助方法指南中了解有关表单辅助方法的更多信息。

一组用于构建依赖于路由子系统的链接和 URL 的方法。

3.5. url_for

返回提供的 options 的 URL。

url_for @profile
# => /profiles/1

url_for [ @hotel, @booking, page: 2, line: 3 ]
# => /hotels/1/bookings/1?line=3&page=2

url_for @post # given a composite primary key [:blog_id, :id]
# => /posts/1_2

5. 资产

一组用于生成将视图链接到图像、JavaScript 文件、样式表和提要等资产的 HTML 的方法。

默认情况下，Rails 将这些资产链接到公共文件夹中的当前主机上，但您可以通过在应用程序配置中设置 config.asset_host，通常在 config/environments/production.rb 中，来指示 Rails 从专用资产服务器链接到资产。

例如，假设您的资产主机是 assets.example.com

config.asset_host = "assets.example.com"

那么 image_tag 的相应 URL 将是

image_tag("rails.png")
# => <img src="//assets.example.com/images/rails.png" />

5.1. audio_tag

生成一个 HTML 音频标签，带有一个或多个源，可以是字符串源的单个标签，也可以是数组中多个源的嵌套源标签。sources 可以是完整路径、公共音频目录中的文件，或Active Storage 附件。

audio_tag("sound")
# => <audio src="/audios/sound"></audio>

audio_tag("sound.wav", "sound.mid")
# => <audio><source src="/audios/sound.wav" /><source src="/audios/sound.mid" /></audio>

audio_tag("sound", controls: true)
# => <audio controls="controls" src="/audios/sound"></audio>

在内部，audio_tag 使用 AssetUrlHelpers 中的 audio_path 来构建音频路径。

有关更多信息，请参阅audio_tag API 文档。

5.2. auto_discovery_link_tag

返回一个链接标签，浏览器和提要阅读器可以使用它来自动检测 RSS、Atom 或 JSON 提要。

auto_discovery_link_tag(:rss, "http://www.example.com/feed.rss", { title: "RSS Feed" })
# => <link rel="alternate" type="application/rss+xml" title="RSS Feed" href="http://www.example.com/feed.rss" />

有关更多信息，请参阅auto_discovery_link_tag API 文档。

5.4. image_tag

返回源的 HTML 图像标签。source 可以是完整路径或 app/assets/images 目录中存在的文件。

image_tag("icon.png")
# => <img src="/assets/icon.png" />

image_tag("icon.png", size: "16x10", alt: "Edit Article")
# => <img src="/assets/icon.png" width="16" height="10" alt="Edit Article" />

在内部，image_tag 使用 AssetUrlHelpers 中的 image_path 来构建图像路径。

有关更多信息，请参阅image_tag API 文档。

5.5. javascript_include_tag

返回每个提供的源的 HTML script 标签。您可以传入 app/assets/javascripts 目录中存在的 JavaScript 文件的文件名（.js 扩展名可选）以包含到当前页面中，或者您可以传入相对于文档根目录的完整路径。

javascript_include_tag("common")
# => <script src="/assets/common.js"></script>

javascript_include_tag("common", async: true)
# => <script src="/assets/common.js" async="async"></script>

一些最常见的属性是 async 和 defer，其中 async 允许脚本并行加载并在尽快解析和评估，而 defer 则表示脚本应在文档解析后执行。

在内部，javascript_include_tag 使用 AssetUrlHelpers 中的 javascript_path 来构建脚本路径。

有关更多信息，请参阅javascript_include_tag API 文档。

5.8. stylesheet_link_tag

返回指定为参数的源的样式表链接标签。如果您未指定扩展名，将自动添加 .css。

stylesheet_link_tag("application")
# => <link href="/assets/application.css" rel="stylesheet" />

stylesheet_link_tag("application", media: "all")
# => <link href="/assets/application.css" media="all" rel="stylesheet" />

media 用于指定链接的媒体类型。最常见的媒体类型是 all、screen、print 和 speech。

在内部，stylesheet_link_tag 使用 AssetUrlHelpers 中的 stylesheet_path 来构建样式表路径。

有关更多信息，请参阅stylesheet_link_tag API 文档。

5.9. video_tag

生成一个带有源的 HTML 视频标签，可以是字符串源的单个标签，也可以是数组中多个源的嵌套源标签。sources 可以是完整路径、公共视频目录中的文件，或 Active Storage 附件。

video_tag("trailer")
# => <video src="/videos/trailer"></video>

video_tag(["trailer.ogg", "trailer.flv"])
# => <video><source src="/videos/trailer.ogg" /><source src="/videos/trailer.flv" /></video>

video_tag("trailer", controls: true)
# => <video controls="controls" src="/videos/trailer"></video>

在内部，video_tag 使用 AssetUrlHelpers 中的 video_path 来构建视频路径。

有关更多信息，请参阅video_tag API 文档。

7. 替代标签

一组用于以编程方式生成 HTML 标签的方法。

7.2. token_list

返回由提供的参数构建的 token 字符串。此方法也别名为 class_names。

token_list("cats", "dogs")
# => "cats dogs"

token_list(nil, false, 123, "", "foo", { bar: true })
# => "123 foo bar"

mobile, alignment = true, "center"
token_list("flex items-#{alignment}", "flex-col": mobile)
# => "flex items-center flex-col"
class_names("flex items-#{alignment}", "flex-col": mobile) # using the alias
# => "flex items-center flex-col"

8. 捕获块

一组方法，允许您提取生成的标记，这些标记可用于模板或布局文件的其他部分。

它提供了一种通过 capture 将块捕获到变量中的方法，以及一种通过 content_for 捕获标记块以在布局中使用的S方法。

8.2. content_for

调用 content_for 会将标记块存储在标识符中以供以后使用。您可以通过将标识符作为参数传递给 yield，在其他模板、辅助模块或布局中对存储的内容进行后续调用。

一个常见的用例是在 content_for 块中设置页面的标题。

您在特殊页面的视图中定义一个 content_for 块，然后将其 yield 到布局中。对于其他未利用 content_for 块的页面，它仍然是空的，导致没有任何内容被 yield。

<%# app/views/users/special_page.html.erb %>
<% content_for(:html_title) { "Special Page Title" } %>

<%# app/views/layouts/application.html.erb %>
<html>
  <head>
    <title><%= content_for?(:html_title) ? yield(:html_title) : "Default Title" %></title>
  </head>
</html>

您会注意到在上面的示例中，我们使用 content_for? 谓词方法有条件地呈现标题。此方法检查是否已使用 content_for 捕获任何内容，使您能够根据视图中的内容调整布局的部分。

此外，您可以在辅助模块中使用 content_for。

# app/helpers/title_helper.rb
module TitleHelper
  def html_title
    content_for(:html_title) || "Default Title"
  end
end

现在，您可以在布局中调用 html_title 来检索存储在 content_for 块中的内容。如果正在渲染的页面（例如 special_page）上设置了 content_for 块，它将显示标题。否则，它将显示默认文本“Default Title”。

content_for 在缓存中被忽略。因此，您不应将其用于将进行片段缓存的元素。

您可能会想 capture 和 content_for 有什么区别？

capture 用于将标记块捕获到变量中，而 content_for 用于将标记块存储在标识符中以供以后使用。在内部，content_for 实际上调用了 capture。然而，关键区别在于它们在多次调用时的行为。

content_for 可以重复调用，它会按照提供的顺序连接它为特定标识符接收的块。每次后续调用只会增加已存储的内容。相比之下，capture 只返回块的内容，而不跟踪任何以前的调用。

有关更多信息，请参阅content_for API 文档。

9. 性能

9.1. benchmark

将 benchmark 块包裹在昂贵的操作或可能的瓶颈周围，以获取操作的时间读数。

<% benchmark "Process data files" do %>
  <%= expensive_files_operation %>
<% end %>

这会在日志中添加类似 Process data files (0.34523) 的内容，然后您可以使用它来比较优化代码时的时间。

此辅助方法是 Active Support 的一部分，它也适用于控制器、辅助方法、模型等。

有关更多信息，请参阅benchmark API 文档。

9.2. cache

您可以缓存视图的片段而不是整个操作或页面。此技术对于缓存菜单、新闻主题列表、静态 HTML 片段等片段非常有用。它允许将视图逻辑的片段包裹在缓存块中，并在下次请求时从缓存存储中提供。

cache 方法接受一个包含您希望缓存内容的块。

例如，您可以通过将其包裹在 cache 块中来缓存应用程序布局的页脚。

<% cache do %>
  <%= render "application/footer" %>
<% end %>

您还可以基于模型实例进行缓存，例如，您可以通过将 article 对象传递给 cache 方法来缓存页面上的每篇文章。这将单独缓存每篇文章。

<% @articles.each do |article| %>
  <% cache article do %>
    <%= render article %>
  <% end %>
<% end %>

当您的应用程序收到对该页面的第一个请求时，Rails 将写入一个新的缓存条目，其中包含唯一的键。键看起来像这样

views/articles/index:bea67108094918eeba32cd4a6f786301/articles/1

有关更多信息，请参阅Fragment Caching 和 cache API 文档。

10. 杂项

10.1. atom_feed

Atom Feeds 是基于 XML 的文件格式，用于内容联合，用户可以在提要阅读器中浏览内容，或搜索引擎可以帮助发现有关您网站的其他信息。

此辅助方法使构建 Atom 提要变得容易，并且主要用于 Builder 模板中创建 XML。这是一个完整的用法示例

# config/routes.rb
resources :articles

# app/controllers/articles_controller.rb
def index
  @articles = Article.all

  respond_to do |format|
    format.html
    format.atom
  end
end

# app/views/articles/index.atom.builder
atom_feed do |feed|
  feed.title("Articles Index")
  feed.updated(@articles.first.created_at)

  @articles.each do |article|
    feed.entry(article) do |entry|
      entry.title(article.title)
      entry.content(article.body, type: "html")

      entry.author do |author|
        author.name(article.author_name)
      end
    end
  end
end

有关更多信息，请参阅atom_feed API 文档。

10.2. debug

返回包裹在 pre 标签中的对象的 YAML 表示。这创建了一种非常可读的方式来检查对象。

my_hash = { "first" => 1, "second" => "two", "third" => [1, 2, 3] }
debug(my_hash)

<pre class="debug_dump">---
first: 1
second: two
third:
- 1
- 2
- 3
</pre>

有关更多信息，请参阅debug API 文档。