跳至内容 跳至搜索

Action View 原生输出助手 ↑

方法
R
S
T

实例公共方法

raw(stringish)

此方法将字符串以不转义的方式输出。由于现在默认转义标签，当您不希望 Rails 自动转义标签时可以使用此方法。如果数据来自用户输入，则不推荐使用此方法。

例如

raw @user.name
# => 'Jimmy <alert>Tables</alert>'

来源: 显示 | 在 GitHub 上

# File actionview/lib/action_view/helpers/output_safety_helper.rb, line 18
def raw(stringish)
  stringish.to_s.html_safe
end

safe_join(array, sep = $,)

此方法返回一个 HTML 安全字符串，类似于 Array#join 的返回值。数组会被展平，并且所有元素，包括提供的分隔符，都会被 HTML 转义，除非它们已经是 HTML 安全的，然后返回的字符串会被标记为 HTML 安全。

safe_join([tag.p("foo"), "<p>bar</p>"], "<br>")
# => "<p>foo</p>&lt;br&gt;&lt;p&gt;bar&lt;/p&gt;"

safe_join([tag.p("foo"), tag.p("bar")], tag.br)
# => "<p>foo</p><br><p>bar</p>"

来源: 显示 | 在 GitHub 上

# File actionview/lib/action_view/helpers/output_safety_helper.rb, line 33
def safe_join(array, sep = $,)
  sep = ERB::Util.unwrapped_html_escape(sep)

  array.flatten.map! { |i| ERB::Util.unwrapped_html_escape(i) }.join(sep).html_safe
end

to_sentence(array, options = {})

将数组转换为一个逗号分隔的句子，其中最后一个元素通过连接词连接。这是 ActiveSupport 的 Array#to_sentence 的 html_safe 感知版本。

来源: 显示 | 在 GitHub 上

# File actionview/lib/action_view/helpers/output_safety_helper.rb, line 42
def to_sentence(array, options = {})
  options.assert_valid_keys(:words_connector, :two_words_connector, :last_word_connector, :locale)

  default_connectors = {
    words_connector: ", ",
    two_words_connector: " and ",
    last_word_connector: ", and "
  }
  if defined?(I18n)
    i18n_connectors = I18n.translate(:'support.array', locale: options[:locale], default: {})
    default_connectors.merge!(i18n_connectors)
  end
  options = default_connectors.merge!(options)

  case array.length
  when 0
    "".html_safe
  when 1
    ERB::Util.html_escape(array[0])
  when 2
    safe_join([array[0], array[1]], options[:two_words_connector])
  else
    safe_join([safe_join(array[0...-1], options[:words_connector]), options[:last_word_connector], array[-1]], nil)
  end
end