Class: ActionText::Attachment
Relationships & Source Files | |
Super Chains via Extension / Inclusion / Inheritance | |
Instance Chain:
|
|
Inherits: | Object |
Defined in: | actiontext/lib/action_text/attachment.rb |
Overview
Attachments
serialize attachables to HTML or plain text.
class Person < ApplicationRecord
include ActionText::Attachable
end
attachable = Person.create! name: "Javan"
= ActionText::Attachment.from_attachable(attachable)
.to_html # => "<action-text-attachment sgid=\"BAh7CEk..."
Constant Summary
-
ATTRIBUTES =
# File 'actiontext/lib/action_text/attachment.rb', line 22%w( sgid content-type url href filename filesize width height previewable presentation caption content )
Class Attribute Summary
- .tag_name (also: #tag_name) rw
Class Method Summary
Instance Attribute Summary
- #attachable readonly
- #node readonly
- #tag_name rw
Instance Method Summary
- #caption
- #full_attributes
- #inspect
-
#to_html
Converts the attachment to HTML.
- #to_param
-
#to_plain_text
Converts the attachment to plain text.
- #to_s
- #with_full_attributes
Attachments::TrixConversion
- Included
Attachments::Caching
- Included
Constructor Details
.new(node, attachable) ⇒ Attachment
# File 'actiontext/lib/action_text/attachment.rb', line 66
def initialize(node, attachable) @node = node @attachable = attachable end
Class Attribute Details
.tag_name (rw) Also known as: #tag_name
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 20
mattr_accessor :tag_name, default: "action-text-attachment"
Class Method Details
.fragment_by_canonicalizing_attachments(content)
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 25
def (content) ( (content)) end
.from_attachable(attachable, attributes = {})
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 37
def from_attachable(attachable, attributes = {}) if node = node_from_attributes(attachable.to_rich_text_attributes(attributes)) new(node, attachable) end end
.from_attachables(attachables)
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 33
def from_attachables(attachables) Array(attachables).filter_map { |attachable| from_attachable(attachable) } end
.from_attributes(attributes, attachable = nil)
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 43
def from_attributes(attributes, attachable = nil) if node = node_from_attributes(attributes) from_node(node, attachable) end end
.from_node(node, attachable = nil)
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 29
def from_node(node, attachable = nil) new(node, attachable || ActionText::Attachable.from_node(node)) end
Instance Attribute Details
#attachable (readonly)
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 61
attr_reader :node, :attachable
#node (readonly)
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 61
attr_reader :node, :attachable
#tag_name (rw)
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 20
mattr_accessor :tag_name, default: "action-text-attachment"
Instance Method Details
#full_attributes
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 75
def full_attributes node_attributes.merge(attachable_attributes).merge(sgid_attributes) end
#inspect
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 129
def inspect "#<#{self.class.name} attachable=#{attachable.inspect}>" end
#to_html
Converts the attachment to HTML.
attachable = Person.create! name: "Javan"
= ActionText::Attachment.from_attachable(attachable)
.to_html # => "<action-text-attachment sgid=\"BAh7CEk...
# File 'actiontext/lib/action_text/attachment.rb', line 121
def to_html HtmlConversion.node_to_html(node) end
#to_param
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 63
delegate :to_param, to: :attachable
#to_plain_text
Converts the attachment to plain text.
attachable = ActiveStorage::Blob.find_by filename: "racecar.jpg"
= ActionText::Attachment.from_attachable(attachable)
.to_plain_text # => "[racecar.jpg]"
Use the #caption when set:
= ActionText::Attachment.from_attachable(attachable, caption: "Vroom vroom")
.to_plain_text # => "[Vroom vroom]"
The presentation can be overridden by implementing the attachable_plain_text_representation
method:
class Person < ApplicationRecord
include ActionText::Attachable
def attachable_plain_text_representation
"[#{name}]"
end
end
attachable = Person.create! name: "Javan"
= ActionText::Attachment.from_attachable(attachable)
.to_plain_text # => "[Javan]"
# File 'actiontext/lib/action_text/attachment.rb', line 108
def to_plain_text if respond_to?(:attachable_plain_text_representation) attachable_plain_text_representation( ) else .to_s end end
#to_s
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 125
def to_s to_html end
#with_full_attributes
[ GitHub ]# File 'actiontext/lib/action_text/attachment.rb', line 79
def with_full_attributes self.class.from_attributes(full_attributes, attachable) end