跳至内容 跳至搜索

Action Text 内容

ActionText::Content 类包装一个 HTML 片段，以添加对解析、渲染和序列化的支持。它可用于提取链接和附件、将片段转换为纯文本或将片段序列化到数据库。

ActionText::RichText 记录将“正文”属性序列化为 ActionText::Content。

class Message < ActiveRecord::Base
  has_rich_text :content
end

message = Message.create!(content: "<h1>Funny times!</h1>")
body = message.content.body # => #<ActionText::Content "<div class=\"trix-conte...">
body.to_s # => "<h1>Funny times!</h1>"
body.to_plain_text # => "Funny times!"
方法
#
A
F
G
I
L
N
R
T

属性

[R] fragment

类公共方法

fragment_by_canonicalizing_content(content)

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 30
def fragment_by_canonicalizing_content(content)
  fragment = ActionText::Attachment.fragment_by_canonicalizing_attachments(content)
  fragment = ActionText::AttachmentGallery.fragment_by_canonicalizing_attachment_galleries(fragment)
  fragment
end

new(content = nil, options = {})

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 37
def initialize(content = nil, options = {})
  options.with_defaults! canonicalize: true

  if options[:canonicalize]
    @fragment = self.class.fragment_by_canonicalizing_content(content)
  else
    @fragment = ActionText::Fragment.wrap(content)
  end
end

实例公共方法

==(other)

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 145
def ==(other)
  if self.class == other.class
    to_html == other.to_html
  elsif other.is_a?(self.class)
    to_s == other.to_s
  end
end

append_attachables(attachables)

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 90
def append_attachables(attachables)
  attachments = ActionText::Attachment.from_attachables(attachables)
  self.class.new([self.to_s.presence, *attachments].compact.join("\n"))
end

as_json(*)

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 137
def as_json(*)
  to_html
end

attachables()

从 HTML 片段中提取 +ActionText::Attachable+s

attachable = ActiveStorage::Blob.first
html = %Q(<action-text-attachment sgid="#{attachable.attachable_sgid}" caption="Captioned"></action-text-attachment>)
content = ActionText::Content.new(html)
content.attachables # => [attachable]

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 84
def attachables
  @attachables ||= attachment_nodes.map do |node|
    ActionText::Attachable.from_node(node)
  end
end

attachment_galleries()

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 68
def attachment_galleries
  @attachment_galleries ||= attachment_gallery_nodes.map do |node|
    attachment_gallery_for_node(node)
  end
end

attachments()

从 HTML 片段中提取 +ActionText::Attachment+s

attachable = ActiveStorage::Blob.first
html = %Q(<action-text-attachment sgid="#{attachable.attachable_sgid}" caption="Captioned"></action-text-attachment>)
content = ActionText::Content.new(html)
content.attachments # => [#<ActionText::Attachment attachable=#<ActiveStorage::Blob...

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 62
def attachments
  @attachments ||= attachment_nodes.map do |node|
    attachment_for_node(node)
  end
end

来源：显示 | 在 GitHub 上

inspect()

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 141
def inspect
  "#<#{self.class.name} #{to_html.truncate(25).inspect}>"
end

从 HTML 片段中提取链接

html = '<a href="http://example.com/">Example</a>'
content = ActionText::Content.new(html)
content.links # => ["http://example.com/"]

来源：显示 | 在 GitHub 上

render_attachment_galleries(&block)

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 102
def render_attachment_galleries(&block)
  content = ActionText::AttachmentGallery.fragment_by_replacing_attachment_gallery_nodes(fragment) do |node|
    block.call(attachment_gallery_for_node(node))
  end
  self.class.new(content, canonicalize: false)
end

render_attachments(**options, &block)

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 95
def render_attachments(**options, &block)
  content = fragment.replace(ActionText::Attachment.tag_name) do |node|
    block.call(attachment_for_node(node, **options))
  end
  self.class.new(content, canonicalize: false)
end

to_html()

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 121
def to_html
  fragment.to_html
end

to_partial_path()

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 129
def to_partial_path
  "action_text/contents/content"
end

to_plain_text()

以纯文本形式返回内容，并删除所有 HTML 标签。

content = ActionText::Content.new("<h1>Funny times!</h1>")
content.to_plain_text # => "Funny times!"

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 113
def to_plain_text
  render_attachments(with_full_attributes: false, &:to_plain_text).fragment.to_plain_text
end

to_rendered_html_with_layout()

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 125
def to_rendered_html_with_layout
  render layout: "action_text/contents/content", partial: to_partial_path, formats: :html, locals: { content: self }
end

to_s()

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 133
def to_s
  to_rendered_html_with_layout
end

to_trix_html()

来源：显示 | 在 GitHub 上 

# File actiontext/lib/action_text/content.rb, line 117
def to_trix_html
  render_attachments(&:to_trix_attachment).to_html
end