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

#fragment ⇒ Object (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_json ⇒ Object 


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

def as_json(*)
  to_html
end

#attachables ⇒ Object 


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


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

#attachments ⇒ Object 


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

#gallery_attachments ⇒ Object 


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

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

#inspect ⇒ Object 


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

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

#links ⇒ Object 


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


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

def to_html
  fragment.to_html
end

#to_partial_path ⇒ Object 


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

def to_partial_path
  "action_text/contents/content"
end

#to_plain_text ⇒ Object 


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


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


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

def to_s
  to_rendered_html_with_layout
end

#to_trix_html ⇒ Object 


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

def to_trix_html
  render_attachments(&:to_trix_attachment).to_html
end