Module: ActionText::Attachable

Extended by:
ActiveSupport::Concern
Defined in:
lib/action_text/attachable.rb

Overview

# Action Text Attachable

Include this module to make a record attachable to an ActionText::Content.

class Person < ApplicationRecord
  include ActionText::Attachable
end

person = Person.create! name: "Javan"
html = %Q(<action-text-attachment sgid="#{person.attachable_sgid}"></action-text-attachment>)
content = ActionText::Content.new(html)
content.attachables # => [person]

Constant Summary collapse

LOCATOR_NAME = 
"attachable"

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.from_attachable_sgid(sgid, options = {}) ⇒ Object 



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

def from_attachable_sgid(sgid, options = {})
  method = sgid.is_a?(Array) ? :locate_many_signed : :locate_signed
  record = GlobalID::Locator.public_send(method, sgid, options.merge(for: LOCATOR_NAME))
  record || raise(ActiveRecord::RecordNotFound)
end

.from_node(node) ⇒ Object

Extracts the ‘ActionText::Attachable` from the attachment HTML node:

person = Person.create! name: "Javan"
html = %Q(<action-text-attachment sgid="#{person.attachable_sgid}"></action-text-attachment>)
fragment = ActionText::Fragment.wrap(html)
attachment_node = fragment.find_all(ActionText::Attachment.tag_name).first
ActionText::Attachable.from_node(attachment_node) # => person



31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/action_text/attachable.rb', line 31

def from_node(node)
  if attachable = attachable_from_sgid(node["sgid"])
    attachable
  elsif attachable = ActionText::Attachables::ContentAttachment.from_node(node)
    attachable
  elsif attachable = ActionText::Attachables::RemoteImage.from_node(node)
    attachable
  else
    ActionText::Attachables::MissingAttachable.new(node["sgid"])
  end
end

Instance Method Details

#attachable_content_type ⇒ Object 



83
84
85
 
# File 'lib/action_text/attachable.rb', line 83

def attachable_content_type
  try(:content_type) || "application/octet-stream"
end

#attachable_filename ⇒ Object 



87
88
89
 
# File 'lib/action_text/attachable.rb', line 87

def attachable_filename
  filename.to_s if respond_to?(:filename)
end

#attachable_filesize ⇒ Object 



91
92
93
 
# File 'lib/action_text/attachable.rb', line 91

def attachable_filesize
  try(:byte_size) || try(:filesize)
end

#attachable_metadata ⇒ Object 



95
96
97
 
# File 'lib/action_text/attachable.rb', line 95

def attachable_metadata
  try(:metadata) || {}
end

#attachable_sgid ⇒ Object

Returns the Signed Global ID for the attachable. The purpose of the ID is set to ‘attachable’ so it can’t be reused for other purposes.



79
80
81
 
# File 'lib/action_text/attachable.rb', line 79

def attachable_sgid
  to_sgid(expires_in: nil, for: LOCATOR_NAME).to_s
end

#previewable_attachable? ⇒ Boolean

Returns:

  • (Boolean) 


99
100
101
 
# File 'lib/action_text/attachable.rb', line 99

def previewable_attachable?
  false
end

#to_attachable_partial_path ⇒ Object

Returns the path to the partial that is used for rendering the attachable. Defaults to ‘to_partial_path`.

Override to render a different partial:

class User < ApplicationRecord
  def to_attachable_partial_path
    "users/attachable"
  end
end



127
128
129
 
# File 'lib/action_text/attachable.rb', line 127

def to_attachable_partial_path
  to_partial_path
end

#to_rich_text_attributes(attributes = {}) ⇒ Object 



131
132
133
134
135
136
137
138
139
140
141
 
# File 'lib/action_text/attachable.rb', line 131

def to_rich_text_attributes(attributes = {})
  attributes.dup.tap do |attrs|
    attrs[:sgid] = attachable_sgid
    attrs[:content_type] = attachable_content_type
    attrs[:previewable] = true if previewable_attachable?
    attrs[:filename] = attachable_filename
    attrs[:filesize] = attachable_filesize
    attrs[:width] = attachable_metadata[:width]
    attrs[:height] = attachable_metadata[:height]
  end.compact
end

#to_trix_content_attachment_partial_path ⇒ Object

Returns the path to the partial that is used for rendering the attachable in Trix. Defaults to ‘to_partial_path`.

Override to render a different partial:

class User < ApplicationRecord
  def to_trix_content_attachment_partial_path
    "users/trix_content_attachment"
  end
end



113
114
115
 
# File 'lib/action_text/attachable.rb', line 113

def to_trix_content_attachment_partial_path
  to_partial_path
end