Action View 文本帮助器

在视图中输出文本的首选方法是使用 <%= "text" %> eRuby 语法。常规的 puts 和 print 方法在 eRuby 代码块中无法按预期工作。如果您必须在非输出代码块（即 <% %>）中输出文本，可以使用 concat 方法。

<% concat "hello" %> is equivalent to <%= "hello" %>

<%
   unless signed_in?
     concat link_to("Sign In", action: :sign_in)
   end
%>

is equivalent to

<% unless signed_in? %>
  <%= link_to "Sign In", action: :sign_in %>
<% end %>

在循环开始后返回当前循环字符串。对于需要在多个地方使用当前循环字符串的复杂表格突出显示或任何其他设计需求很有用。

<%# Alternate background colors %>
<% @items = [1,2,3,4] %>
<% @items.each do |item| %>
  <div style="background-color:<%= cycle("red","white","blue") %>">
    <span style="background-color:<%= current_cycle %>"><%= item %></span>
  </div>
<% end %>

创建一个 Cycle 对象，其 to_s 方法在每次调用时循环遍历数组的元素。例如，这可以用于交替表格行的类。可以使用命名循环来允许在循环中嵌套。将 Hash 作为最后一个参数传递，其中包含一个 :name 键，将创建一个命名循环。对于没有 :name 键的循环，默认名称为 "default"。您可以通过调用 reset_cycle 并传递循环名称来手动重置循环。可以使用 current_cycle 方法随时获取当前循环字符串。

 <%# Alternate CSS classes for even and odd numbers... %>
 <% @items = [1,2,3,4] %>
 <table>
 <% @items.each do |item| %>
   <tr class="<%= cycle("odd", "even") -%>">
     <td><%= item %></td>
   </tr>
 <% end %>
 </table>

 <%# Cycle CSS classes for rows, and text colors for values within each row %>
 <% @items = [
   { first: "Robert", middle: "Daniel", last: "James" },
   { first: "Emily", middle: "Shannon", maiden: "Pike", last: "Hicks" },
   { first: "June", middle: "Dae", last: "Jones" },
 ] %>
 <% @items.each do |item| %>
   <tr class="<%= cycle("odd", "even", name: "row_class") -%>">
     <td>
       <% item.values.each do |value| %>
         <%# Create a named cycle "colors" %>
         <span style="color:<%= cycle("red", "green", "blue", name: "colors") -%>">
           <%= value %>
         </span>
       <% end %>
       <% reset_cycle("colors") %>
     </td>
  </tr>
<% end %>

从 text 中提取 phrase 的第一次出现及其周围的文本。如果结果的开始/结束与 text 的开始/结束不一致，则会添加省略号标记。无论如何，结果始终会被剥离。如果找不到 phrase，则返回 nil。

选项

:radius

要包含在结果中的 phrase 周围的字符数（或标记 - 请参阅 :separator 选项）。默认为 100。

:omission

当摘要的开始/结束与 text 的开始/结束不一致时要添加的标记。默认为 "..."。

:separator

用于 :radius 的标记之间的分隔符。默认为 ""，将每个字符视为一个标记。

示例

excerpt('This is an example', 'an', radius: 5)
# => "...s is an exam..."

excerpt('This is an example', 'is', radius: 5)
# => "This is a..."

excerpt('This is an example', 'is')
# => "This is an example"

excerpt('This next thing is an example', 'ex', radius: 2)
# => "...next..."

excerpt('This is also an example', 'an', radius: 8, omission: '<chop> ')
# => "<chop> is also an example"

excerpt('This is a very beautiful morning', 'very', separator: ' ', radius: 1)
# => "...a very beautiful..."

通过使用突出显示字符串对它们进行格式化，突出显示 text 中 phrases 的出现。phrases 可以是一个或多个字符串或正则表达式。结果将被标记为 HTML 安全。默认情况下，text 会在突出显示之前进行清理，以防止可能的 XSS 攻击。

如果指定了块，则将使用它而不是突出显示字符串。phrases 的每次出现都将传递给块，并且其返回值将被插入到最终结果中。

选项

:highlighter

突出显示字符串。使用 \1 作为短语的占位符，类似于 +String#sub+。默认为 "<mark>\1</mark>"。如果指定了块，则忽略此选项。

:sanitize

是否在突出显示之前清理 text。默认为 true。

示例

highlight('You searched for: rails', 'rails')
# => "You searched for: <mark>rails</mark>"

highlight('You searched for: rails', /for|rails/)
# => "You searched <mark>for</mark>: <mark>rails</mark>"

highlight('You searched for: ruby, rails, dhh', 'actionpack')
# => "You searched for: ruby, rails, dhh"

highlight('You searched for: rails', ['for', 'rails'], highlighter: '<em>\1</em>')
# => "You searched <em>for</em>: <em>rails</em>"

highlight('You searched for: rails', 'rails', highlighter: '<a href="search?q=\1">\1</a>')
# => "You searched for: <a href=\"search?q=rails\">rails</a>"

highlight('You searched for: rails', 'rails') { |match| link_to(search_path(q: match)) }
# => "You searched for: <a href=\"search?q=rails\">rails</a>"

highlight('<a href="javascript:alert(\'no!\')">ruby</a> on rails', 'rails', sanitize: false)
# => "<a href=\"javascript:alert('no!')\">ruby</a> on <mark>rails</mark>"

尝试将 singular 单词复数化，除非 count 为 1。如果提供了 plural，则在 count > 1 时将使用它，否则它将使用 Inflector 为给定的区域设置确定复数形式，该区域设置默认为 I18n.locale。

该单词将使用为区域设置定义的规则进行复数化（您必须为英语以外的语言定义自己的词形变化规则）。参见 ActiveSupport::Inflector.pluralize

pluralize(1, 'person')
# => "1 person"

pluralize(2, 'person')
# => "2 people"

pluralize(3, 'person', plural: 'users')
# => "3 users"

pluralize(0, 'person')
# => "0 people"

pluralize(2, 'Person', locale: :de)
# => "2 Personen"

重置循环，以便下次调用时从第一个元素开始。传入 name 以重置命名循环。

<%# Alternate CSS classes for even and odd numbers... %>
<% @items = [[1,2,3,4], [5,6,3], [3,4,5,6,7,4]] %>
<table>
<% @items.each do |item| %>
  <tr class="<%= cycle("even", "odd") -%>">
      <% item.each do |value| %>
        <span style="color:<%= cycle("#333", "#666", "#999", name: "colors") -%>">
          <%= value %>
        </span>
      <% end %>

      <% reset_cycle("colors") %>
  </tr>
<% end %>
</table>

返回使用简单格式化规则转换为 HTML 的 text。两个或更多个连续的换行符 (\n\n 或 \r\n\r\n) 被视为一个段落，并用 <p> 标签包装。一个换行符 (\n 或 \r\n) 被视为一个换行符，并追加一个 <br /> 标签。此方法不会从 text 中删除换行符。

可以将任何 HTML 属性传递给 html_options。这些将被添加到所有创建的段落中。

选项

• :sanitize - 如果为 false，则不会清理 text。

• :sanitize_options - 您要添加到清理中的任何其他选项。

• :wrapper_tag - String 代表包装标签，默认为 "p"

示例

my_text = "Here is some basic text...\n...with a line break."

simple_format(my_text)
# => "<p>Here is some basic text...\n<br />...with a line break.</p>"

simple_format(my_text, {}, wrapper_tag: "div")
# => "<div>Here is some basic text...\n<br />...with a line break.</div>"

more_text = "We want to put a paragraph...\n\n...right there."

simple_format(more_text)
# => "<p>We want to put a paragraph...</p>\n\n<p>...right there.</p>"

simple_format("Look ma! A class!", class: 'description')
# => "<p class='description'>Look ma! A class!</p>"

simple_format("<blink>Unblinkable.</blink>")
# => "<p>Unblinkable.</p>"

simple_format("<blink>Blinkable!</blink> It's true.", {}, sanitize: false)
# => "<p><blink>Blinkable!</blink> It's true.</p>"

simple_format("<a target=\"_blank\" href=\"http://example.com\">Continue</a>", {}, { sanitize_options: { attributes: %w[target href] } })
# => "<p><a target=\"_blank\" href=\"http://example.com\">Continue</a></p>"

如果 text 长于指定的 :length，则截断 text。如果截断了 text，则会将省略号标记追加到结果中，其总长度不超过 :length。

您还可以传递一个块来渲染并在截断 text 后将额外的内容追加到省略号标记。但是，此内容 *可能* 会导致总长度超过 :length 个字符。

除非指定了 escape: false，否则结果将被转义。无论如何，结果将被标记为 HTML 安全。如果 text 可能包含 HTML 标签或实体，则应谨慎，因为截断可能会产生无效的 HTML，例如不平衡或不完整的标签。

选项

:length

应返回的最大字符数，不包括来自块的任何额外内容。默认为 30。

:omission

截断后要追加的字符串。默认为 "..."。

:separator

用于查找截断断点的字符串或正则表达式。默认情况下，截断可以在 text 中的任何字符处发生。

:escape

是否转义结果。默认为 true。

示例

truncate("Once upon a time in a world far far away")
# => "Once upon a time in a world..."

truncate("Once upon a time in a world far far away", length: 17)
# => "Once upon a ti..."

truncate("Once upon a time in a world far far away", length: 17, separator: ' ')
# => "Once upon a..."

truncate("And they found that many people were sleeping better.", length: 25, omission: '... (continued)')
# => "And they f... (continued)"

truncate("<p>Once upon a time in a world far far away</p>")
# => "&lt;p&gt;Once upon a time in a wo..."

truncate("<p>Once upon a time in a world far far away</p>", escape: false)
# => "<p>Once upon a time in a wo..."

truncate("Once upon a time in a world far far away") { link_to "Continue", "#" }
# => "Once upon a time in a world...<a href=\"#\">Continue</a>"

将 text 包装成不超过 line_width 宽度行的行。此方法在第一个不超过 line_width（默认值为 80）的空白字符处断开。

word_wrap('Once upon a time')
# => "Once upon a time"

word_wrap('Once upon a time, in a kingdom called Far Far Away, a king fell ill, and finding a successor to the throne turned out to be more trouble than anyone could have imagined...')
# => "Once upon a time, in a kingdom called Far Far Away, a king fell ill, and finding\na successor to the throne turned out to be more trouble than anyone could have\nimagined..."

word_wrap('Once upon a time', line_width: 8)
# => "Once\nupon a\ntime"

word_wrap('Once upon a time', line_width: 1)
# => "Once\nupon\na\ntime"

您还可以指定自定义 break_sequence（默认值为“n”）。

word_wrap('Once upon a time', line_width: 1, break_sequence: "\r\n")
# => "Once\r\nupon\r\na\r\ntime"