# frozen_string_literal: true module ActionText # = Action Text \Content # # The +ActionText::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 # +ActionText::Content+. # # class Message < ActiveRecord::Base # has_rich_text :content # end # # message = Message.create!(content: "

Funny times!

") # body = message.content.body # => # # body.to_s # => "

Funny times!

" # body.to_plain_text # => "Funny times!" class Content include Rendering, Serialization, ContentHelper attr_reader :fragment delegate :blank?, :empty?, :html_safe, :present?, to: :to_html # Delegating to to_html to avoid including the layout class << self 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 end 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 # Extracts links from the HTML fragment: # # html = 'Example' # content = ActionText::Content.new(html) # content.links # => ["http://example.com/"] def links @links ||= fragment.find_all("a[href]").map { |a| a["href"] }.uniq end # Extracts +ActionText::Attachment+s from the HTML fragment: # # attachable = ActiveStorage::Blob.first # html = %Q() # content = ActionText::Content.new(html) # content.attachments # => [#) # content = ActionText::Content.new(html) # content.attachables # => [attachable] def attachables @attachables ||= attachment_nodes.map do |node| ActionText::Attachable.from_node(node) end end def append_attachables(attachables) attachments = ActionText::Attachment.from_attachables(attachables) self.class.new([self.to_s.presence, *attachments].compact.join("\n")) end def render_attachments(**options, &block) content = fragment.replace(ActionText::Attachment.tag_name) do |node| node["content"] = sanitize_content_attachment(node["content"]) block.call(attachment_for_node(node, **options)) end self.class.new(content, canonicalize: false) end 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 # Returns the content as plain text with all HTML tags removed. # # content = ActionText::Content.new("

Funny times!

") # content.to_plain_text # => "Funny times!" def to_plain_text render_attachments(with_full_attributes: false, &:to_plain_text).fragment.to_plain_text end def to_trix_html render_attachments(&:to_trix_attachment).to_html end def to_html fragment.to_html end def to_rendered_html_with_layout render layout: "action_text/contents/content", partial: to_partial_path, formats: :html, locals: { content: self } end def to_partial_path "action_text/contents/content" end def to_s to_rendered_html_with_layout end def as_json(*) to_html end def inspect "#<#{self.class.name} #{to_html.truncate(25).inspect}>" end 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 private def attachment_nodes @attachment_nodes ||= fragment.find_all(ActionText::Attachment.tag_name) end def attachment_gallery_nodes @attachment_gallery_nodes ||= ActionText::AttachmentGallery.find_attachment_gallery_nodes(fragment) end def attachment_for_node(node, with_full_attributes: true) attachment = ActionText::Attachment.from_node(node) with_full_attributes ? attachment.with_full_attributes : attachment end def attachment_gallery_for_node(node) ActionText::AttachmentGallery.from_node(node) end end end ActiveSupport.run_load_hooks :action_text_content, ActionText::Content