Class: ActionText::Content

Inherits:
Object
  • Object
show all
Includes:
Rendering, Serialization
Defined in:
lib/action_text/content.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Serialization

#_dump

Constructor Details

#initialize(content = nil, options = {}) ⇒ Content

Returns a new instance of Content.



19
20
21
22
23
24
25
26
27
# File 'lib/action_text/content.rb', line 19

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

Instance Attribute Details

#fragmentObject (readonly)

Returns the value of attribute fragment.



7
8
9
# File 'lib/action_text/content.rb', line 7

def fragment
  @fragment
end

Class Method Details

.fragment_by_canonicalizing_content(content) ⇒ Object



12
13
14
15
16
# File 'lib/action_text/content.rb', line 12

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 Method Details

#==(other) ⇒ Object



102
103
104
105
106
# File 'lib/action_text/content.rb', line 102

def ==(other)
  if other.is_a?(self.class)
    to_s == other.to_s
  end
end

#append_attachables(attachables) ⇒ Object



55
56
57
58
# File 'lib/action_text/content.rb', line 55

def append_attachables(attachables)
  attachments = ActionText::Attachment.from_attachables(attachables)
  self.class.new([self.to_s.presence, *attachments].compact.join("\n"))
end

#as_jsonObject



94
95
96
# File 'lib/action_text/content.rb', line 94

def as_json(*)
  to_html
end

#attachablesObject



49
50
51
52
53
# File 'lib/action_text/content.rb', line 49

def attachables
  @attachables ||= attachment_nodes.map do |node|
    ActionText::Attachable.from_node(node)
  end
end

#attachment_galleriesObject



39
40
41
42
43
# File 'lib/action_text/content.rb', line 39

def attachment_galleries
  @attachment_galleries ||= attachment_gallery_nodes.map do |node|
    attachment_gallery_for_node(node)
  end
end

#attachmentsObject



33
34
35
36
37
# File 'lib/action_text/content.rb', line 33

def attachments
  @attachments ||= attachment_nodes.map do |node|
    attachment_for_node(node)
  end
end


45
46
47
# File 'lib/action_text/content.rb', line 45

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

#inspectObject



98
99
100
# File 'lib/action_text/content.rb', line 98

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


29
30
31
# File 'lib/action_text/content.rb', line 29

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

#render_attachment_galleries(&block) ⇒ Object



67
68
69
70
71
72
# File 'lib/action_text/content.rb', line 67

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) ⇒ Object



60
61
62
63
64
65
# File 'lib/action_text/content.rb', line 60

def render_attachments(**options, &block)
  content = fragment.replace(ActionText::Attachment::SELECTOR) do |node|
    block.call(attachment_for_node(node, **options))
  end
  self.class.new(content, canonicalize: false)
end

#to_htmlObject



82
83
84
# File 'lib/action_text/content.rb', line 82

def to_html
  fragment.to_html
end

#to_plain_textObject



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

def to_plain_text
  render_attachments(with_full_attributes: false, &:to_plain_text).fragment.to_plain_text
end

#to_rendered_html_with_layoutObject



86
87
88
# File 'lib/action_text/content.rb', line 86

def to_rendered_html_with_layout
  render partial: "action_text/content/layout", locals: { content: self }
end

#to_sObject



90
91
92
# File 'lib/action_text/content.rb', line 90

def to_s
  to_rendered_html_with_layout
end

#to_trix_htmlObject



78
79
80
# File 'lib/action_text/content.rb', line 78

def to_trix_html
  render_attachments(&:to_trix_attachment).to_html
end