Class: ActionText::Content

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Instance Chain: self, `Rendering`, `Serialization`
Inherits:	Object
Defined in:	actiontext/lib/action_text/content.rb

Overview

The Content class wraps an HTML fragment to add support for parsing, rendering and serialization. It can be used to extract links and attachments, convert the fragment to plain text, or serialize the fragment to the database.

The ActionText::RichText record serializes the body attribute as 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!"

`Rendering` - Attributes & Methods

#render readonly

Class Method Summary

.fragment_by_canonicalizing_content(content)
.new(content = nil, options = {}) ⇒ Content constructor

Instance Attribute Summary

#fragment readonly
#html_safe readonly

Instance Method Summary

#==(other)
#append_attachables(attachables)
#as_json
#attachables

Extracts Attachables from the HTML fragment:
#attachment_galleries
#attachments

Extracts Attachments from the HTML fragment:
#blank? ⇒ Boolean
#empty? ⇒ Boolean
#gallery_attachments
#inspect
#links

Extracts links from the HTML fragment:
#present? ⇒ Boolean
#render_attachment_galleries(&block)
#render_attachments(**options, &block)
#to_html
#to_partial_path
#to_plain_text

Returns the content as plain text with all HTML tags removed.
#to_rendered_html_with_layout
#to_s
#to_trix_html
#attachment_for_node(node, with_full_attributes: true) private
#attachment_gallery_for_node(node) private
#attachment_gallery_nodes private
#attachment_nodes private

`Serialization` - Included

#_dump

Constructor Details

.new(content = nil, options = {}) ⇒ `Content`

[ 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

Class Method Details

.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

Instance Attribute Details

#fragment (readonly)

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 25


attr_reader :fragment

#html_safe (readonly)

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 27


delegate :blank?, :empty?, :html_safe, :present?, to: :to_html # Delegating to to_html to avoid including the layout

#render (readonly)

[ GitHub ]

# File 'actiontext/lib/action_text/rendering.rb', line 12


delegate :render, to: :class

Instance Method Details

#==(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

Extracts Attachables from the HTML fragment:

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_for_node(node, with_full_attributes: true) (private)

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 162


def attachment_for_node(node, with_full_attributes: true)
  attachment = ActionText::Attachment.from_node(node)
  with_full_attributes ? attachment.with_full_attributes : attachment
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

#attachment_gallery_for_node(node) (private)

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 167


def attachment_gallery_for_node(node)
  ActionText::AttachmentGallery.from_node(node)
end

#attachment_gallery_nodes (private)

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 158


def attachment_gallery_nodes
  @attachment_gallery_nodes ||= ActionText::AttachmentGallery.find_attachment_gallery_nodes(fragment)
end

#attachment_nodes (private)

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 154


def attachment_nodes
  @attachment_nodes ||= fragment.find_all(ActionText::Attachment.tag_name)
end

#attachments

Extracts Attachments from the HTML fragment:

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

#blank? ⇒ `Boolean`

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 27


delegate :blank?, :empty?, :html_safe, :present?, to: :to_html # Delegating to to_html to avoid including the layout

#empty? ⇒ `Boolean`

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 27


delegate :blank?, :empty?, :html_safe, :present?, to: :to_html # Delegating to to_html to avoid including the layout

#gallery_attachments

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 74


def gallery_attachments
  @gallery_attachments ||= attachment_galleries.flat_map(&:attachments)
end

#inspect

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 141


def inspect
  "#<#{self.class.name} #{to_html.truncate(25).inspect}>"
end

#links

Extracts links from the HTML fragment:

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

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 52


def links
  @links ||= fragment.find_all("a[href]").map { |a| a["href"] }.uniq
end

#present? ⇒ `Boolean`

[ GitHub ]

# File 'actiontext/lib/action_text/content.rb', line 27


delegate :blank?, :empty?, :html_safe, :present?, to: :to_html # Delegating to to_html to avoid including the layout

#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

Returns the content as plain text with all HTML tags removed.

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

Class: ActionText::Content

Overview

Rendering - Attributes & Methods

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Serialization - Included

Constructor Details

.new(content = nil, options = {}) ⇒ Content

Class Method Details

.fragment_by_canonicalizing_content(content)

Instance Attribute Details

#fragment (readonly)

#html_safe (readonly)

#render (readonly)

Instance Method Details

#==(other)

#append_attachables(attachables)

#as_json

#attachables

#attachment_for_node(node, with_full_attributes: true) (private)

#attachment_galleries

#attachment_gallery_for_node(node) (private)

#attachment_gallery_nodes (private)

#attachment_nodes (private)

#attachments

#blank? ⇒ Boolean

#empty? ⇒ Boolean

#gallery_attachments

#inspect

#links

#present? ⇒ Boolean

#render_attachment_galleries(&block)

#render_attachments(**options, &block)

#to_html

#to_partial_path

#to_plain_text

#to_rendered_html_with_layout

#to_s

#to_trix_html

`Rendering` - Attributes & Methods

`Serialization` - Included

.new(content = nil, options = {}) ⇒ `Content`

#blank? ⇒ `Boolean`

#empty? ⇒ `Boolean`

#present? ⇒ `Boolean`