Class: ActionText::Content

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

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from ActiveSupport::Concern

#append_features, #class_methods, extended, #included, #prepend_features, #prepended

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 'actiontext/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 'actiontext/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 'actiontext/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


106
107
108
109
110
# File 'actiontext/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


55
56
57
58
# File 'actiontext/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


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

def as_json(*)
  to_html
end

#attachablesObject


49
50
51
52
53
# File 'actiontext/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 'actiontext/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 'actiontext/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 'actiontext/lib/action_text/content.rb', line 45

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

#inspectObject


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

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

29
30
31
# File 'actiontext/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 'actiontext/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 'actiontext/lib/action_text/content.rb', line 60

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_htmlObject


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

def to_html
  fragment.to_html
end

#to_partial_pathObject


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

def to_partial_path
  "action_text/contents/content"
end

#to_plain_textObject


74
75
76
# File 'actiontext/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 'actiontext/lib/action_text/content.rb', line 86

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

#to_sObject


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

def to_s
  to_rendered_html_with_layout
end

#to_trix_htmlObject


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

def to_trix_html
  render_attachments(&:to_trix_attachment).to_html
end