Class: ActionText::Content

Inherits:
Object
  • Object
show all
Includes:
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.



23
24
25
26
27
28
29
30
31
# File 'lib/action_text/content.rb', line 23

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.



11
12
13
# File 'lib/action_text/content.rb', line 11

def fragment
  @fragment
end

Class Method Details

.fragment_by_canonicalizing_content(content) ⇒ Object



16
17
18
19
20
# File 'lib/action_text/content.rb', line 16

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



106
107
108
109
110
# File 'lib/action_text/content.rb', line 106

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

#append_attachables(attachables) ⇒ Object



59
60
61
62
# File 'lib/action_text/content.rb', line 59

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

#as_jsonObject



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

def as_json(*)
  to_html
end

#attachablesObject



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

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

#attachment_galleriesObject



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

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

#attachmentsObject



37
38
39
40
41
# File 'lib/action_text/content.rb', line 37

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


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

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

#inspectObject



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

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


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

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

#render_attachment_galleries(&block) ⇒ Object



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

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



64
65
66
67
68
69
# File 'lib/action_text/content.rb', line 64

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



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

def to_html
  fragment.to_html
end

#to_plain_textObject



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

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

#to_rendered_html_with_layoutObject



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

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

#to_sObject



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

def to_s
  to_rendered_html_with_layout
end

#to_trix_htmlObject



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

def to_trix_html
  render_attachments(&:to_trix_attachment).to_html
end