класс ActionText::Content

Родитель:: Объект

Контент Action Text

Класс ActionText::Content оборачивает фрагмент HTML для добавления поддержки парсинга, рендеринга и сериализации. Он может использоваться для извлечения ссылок и вложений, преобразования фрагмента в обычный текст или сериализации фрагмента в базу данных.

Запись ActionText::RichText сериализует атрибут `body` как 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!"

Атрибуты

fragment[R]

Публичные методы класса

fragment_by_canonicalizing_content(content) Показать исходный код

# 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 = {}) Показать исходный код

# 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) Показать исходный код

# 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) Показать исходный код

# 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(*) Показать исходный код

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

attachables() Показать исходный код

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

Извлекает +ActionText::Attachable+ из фрагмента HTML:

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]

attachment_galleries() Показать исходный код

# 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() Показать исходный код

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

Извлекает +ActionText::Attachment+ из фрагмента HTML:

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...

gallery_attachments() Показать исходный код

# File actiontext/lib/action_text/content.rb, line 74
def gallery_attachments
  @gallery_attachments ||= attachment_galleries.flat_map(&:attachments)
end

inspect() Показать исходный код

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

links() Показать исходный код

# File actiontext/lib/action_text/content.rb, line 52
def links
  @links ||= fragment.find_all("a[href]").map { |a| a["href"] }.uniq
end

Извлекает ссылки из фрагмента HTML:

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

render_attachment_galleries(&block) Показать исходный код

# 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) Показать исходный код

# 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() Показать исходный код

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

to_partial_path() Показать исходный код

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

to_plain_text() Показать исходный код

# 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

Возвращает содержимое в виде простого текста со всеми тегами HTML, удалёнными.

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

to_rendered_html_with_layout() Показать исходный код

# 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() Показать исходный код

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

to_trix_html() Показать исходный код

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