rails 指南总结（八）——Action View 提供的辅助方法概述

Action View 模板使用混合了 HTML 标签的嵌入式 Ruby 语言编写。为了避免样板代码把模板弄乱，Action View 提供了许多辅助方法，用于创建表单、日期和字符串等常用组件。

1 AssetTagHelper 模块

• auto_discovery_link_tag 方法用于返回链接标签，使浏览器和订阅阅读器可以自动检测 RSS 或 Atom 订阅源。
• image_path 方法用于计算 app/assets/images 文件夹中图像资源的路径，得到的路径是从根目录开始的完整路径（也就是绝对路径）
• image_url 方法用于计算 app/assets/images 文件夹中图像资源的 URL 地址。image_url 方法在内部调用了 image_path 方法，并把得到的图像资源路径和当前主机或静态资源文件服务器的 URL 地址合并。
• mage_tag 方法用于返回 HTML 图像标签。
• javascript_include_tag 方法用于返回 HTML 脚本标签。此方法接受 app/assets/javascripts 文件夹中JavaScript 文件的文件名（.js 后缀可以省略）或 JavaScript 文件的完整路径（绝对路径）作为参数。
• javascript_path 方法用于计算 app/assets/javascripts 文件夹中 JavaScript 资源的路径。javascript_include_tag 方法在内部使用 javascript_path 方法生成脚本路径。
• javascript_url 方法用于计算 app/assets/javascripts 文件夹中 JavaScript 资源的 URL 地址。javascript_url 方法在内部调用了 javascript_path 方法
• stylesheet_link_tag 方法用于返回样式表链接标签。如果没有指定文件的扩展名，Rails 会自动添加 .css。
• stylesheet_path 方法用于计算 app/assets/stylesheets 文件夹中样式表资源的路径。
• stylesheet_url 方法用于计算 app/assets/stylesheets 文件夹中样式表资源的 URL 地址。stylesheet_url 方法在内部调用了 stylesheet_path 方法

2 AtomFeedHelper 模块

• 通过 atom_feed 辅助方法我们可以轻松创建 Atom 订阅源。下面是一个完整的示例：

3 BenchmarkHelper 模块

benchmark 方法用于测量模板中某个块的执行时间，并把测量结果写入日志。benchmark 方法常用于测量耗时操作或可能的性能瓶颈的执行时间。

4 CacheHelper 模块

cache 方法用于缓存视图片断而不是整个动作或页面。此方法常用于缓存页面中诸如菜单、新闻主题列表、静态 HTML 片断等内容。cache 方法接受块作为参数，块中包含要缓存的内容。

5 CaptureHelper 模块

capture 方法用于取出模板的一部分并储存在变量中，然后我们可以在模板或布局中的任何地方使用这个变量。

content_for 方法以块的方式把模板内容保存在标识符中，然后我们可以在模板或布局中把这个标识符传递给 yield 方法作为参数来调用所保存的内容。

6 DateHelper 模块

• date_select 方法:date_select 方法返回年、月、日的选择列表标签，用于设置 date 类型的属性的值。
• datetime_select 方法返回年、月、日、时、分的选择列表标签，用于设置 datetime 类型的属性的值。
• distance_of_time_in_words 方法用于计算两个 Time 对象、Date 对象或秒数的大致时间间隔。把 include_seconds 选项设置为 true 可以得到更精确的时间间隔。
• select_date 方法返回年、月、日的选择列表标签，并通过 Date 对象来设置默认值。
• select_datetime 方法返回年、月、日、时、分的选择列表标签，并通过 Datetime 对象来设置默认值。
• select_day 方法返回当月全部日子的选择列表标签，如 1 到 31，并把当日设置为默认值。
• select_hour 方法返回一天中 24 小时的选择列表标签，即 0 到 23，并把当前小时设置为默认值。
• select_second 方法返回一分钟中 60 秒的选择列表标签，即 0 到 59，并把当前秒设置为默认值。
• select_time 方法返回时、分的选择列表标签，并通过 Time 对象来设置默认值。
• select_year 方法返回当年和前后各五年的选择列表标签，并把当年设置为默认值。可以通过 :start_year 和 :end_year 选项自定义年份范围。
• time_ago_in_words 方法和 distance_of_time_in_words 方法类似，区别在于 time_ago_in_words 方法计算的是指定时间到 Time.now 对应的当前时间的时间间隔。
• time_select 方返回时、分、秒的选择列表标签（其中秒可选），用于设置 time 类型的属性的值。选择的结果作为多个参数赋值给 Active Record 对象。

7 FormHelper 模块

• form_for 辅助方法是 FormHelper 模块中最核心的方法，用于创建处理模型实例的表单。
• check_box 方法:返回用于处理指定模型属性的复选框标签。
• fields_for 方法创建用于处理指定模型对象的作用域，区别在于 fields_for 方法不会创建 form 标签。fields_for 方法适用于在同一个表单中指明附加的模型对象。
• file_field 方法返回用于处理指定模型属性的文件上传组件标签。
• hidden_​​field 方法返回用于处理指定模型属性的隐藏输入字段标签。
• label 方法返回用于处理指定模型属性的文本框的 label 标签。
• password_field 方法返回用于处理指定模型属性的密码框标签。
• radio_button 方法返回用于处理指定模型属性的单选按钮标签。
• text_area 方法返回用于处理指定模型属性的文本区域标签。
• email_field 方法返回用于处理指定模型属性的电子邮件地址输入框标签。
• url_field 方法返回用于处理指定模型属性的 URL 地址输入框标签。

8 FormOptionsHelper 模块

• collection_select 方法返回一个集合的选择列表标签，其中每个集合元素的两个指定方法的返回值分别是每个选项的值和文本。
• collection_radio_buttons 方法返回一个集合的单选按钮标签，其中每个集合元素的两个指定方法的返回值分别是每个选项的值和文本。
• collection_radio_buttons 方法返回一个集合的单选按钮标签，其中每个集合元素的两个指定方法的返回值分别是每个选项的值和文本。
• collection_check_boxes 方法返回一个集合的复选框标签，其中每个集合元素的两个指定方法的返回值分别是每个选项的值和文本。
• options_for_select 方法接受容器（如散列、数组、可枚举对象、自定义类型）作为参数，返回一组选项标签。
• options_from_collection_for_select 方法通过遍历集合返回一组选项标签，其中每个集合元素的 value_method 和 text_method 方法的返回值分别是每个选项的值和文本。
  方法只返回 option 标签，我们要把这些 option 标签放在 select 标签里。
• select 方法使用指定对象和方法创建选择列表标签。
• time_zone_options_for_select 方法返回一组选项标签，其中每个选项对应一个时区，这些时区几乎包含了世界上所有的时区。
• time_zone_select 方法返回时区的选择列表标签，其中选项标签是通过time_zone_options_for_select 方法生成的。
• date_field 方法返回用于处理指定模型属性的日期输入框标签。

9 FormTagHelper 模块

和 FormHelper 模块不同，FormTagHelper 模块提供的方法不依赖于传递给模板的 Active Record 对象。

• check_box_tag 方法用于创建复选框标签。
• field_set_tag 方法用于创建 fieldset 标签。
• form_tag 方法用于创建表单标签。和 ActionController::Base#url_for 方法类似，form_tag 方法的第一个参数是 url_for_options 选项，用于说明提交表单的 URL。
• hidden_​​field_tag 方法用于创建隐藏输入字段标签。隐藏输入字段用于传递因 HTTP 无状态特性而丢失的数据，或不想让用户看到的数据。
• image_submit_tag 方法会显示一张图像，点击这张图像会提交表单。
• label_tag 方法用于创建 label 标签。
• password_field_tag 方法用于创建密码框标签。用户在密码框中输入的密码会被隐藏起来。
• select_tag 方法用于创建选择列表标签。
• submit_tag 方法用于创建提交按钮标签，并在按钮上显示指定的文本。
• text_area_tag 方法用于创建文本区域标签。文本区域用于输入较长的文本，如博客帖子或页面描述。
• email_field_tag 方法用于创建电子邮件地址输入框标签。
• url_field_tag 方法用于创建 URL 地址输入框标签。
• date_field_tag 方法用于创建日期输入框标签。

10 JavaScriptHelper 模块

• javascript_tag 方法返回放在 script 标签里的 JavaScript 代码。

11 NumberHelper 模块

• number_to_currency 方法用于把数字转换为货币字符串（例如 $13.65）。
• number_to_human_size 方法用于把数字转换为容易阅读的形式，常用于显示文件大小。
• number_to_percentage 方法用于把数字转换为百分数字符串。
• number_to_phone 方法用于把数字转换为电话号码（默认为美国）。
• number_with_delimiter 方法用于把数字转换为带有千位分隔符的数字。
• number_with_precision 方法用于把数字转换为具有指定精度的数字，默认精度为 3。

12 SanitizeHelper 模块

SanitizeHelper 模块提供从文本中清除不需要的 HTML 元素的方法。

• sanitize 方法会对所有标签进行 HTML 编码，并清除所有未明确允许的属性。
• strip_tags(html) 方法用于清除包括注释在内的所有 HTML 标签。这个方法的功能由 rails-html-sanitizer gem 提供。使用 strip_tags(html) 方法清除后的文本仍然可能包含 <、> 和 & 字符，从而导致浏览器显示异常。

13 CsrfHelper 模块

• csrf_meta_tags 方法用于生成 csrf-param 和 csrf-token 这两个元标签，它们分别是跨站请求伪造保护的参数和令牌。