Class: ActiveStorage::Attached::Many
Relationships & Source Files | |
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
|
|
Instance Chain:
|
|
Inherits: |
ActiveStorage::Attached
|
Defined in: | activestorage/lib/active_storage/attached/many.rb |
Overview
Decorated proxy object representing of multiple attachments to a model.
Class Method Summary
::ActiveStorage::Attached
- Inherited
Instance Attribute Summary
-
#attached? ⇒ Boolean
readonly
Returns true if any attachments have been made.
-
#detach
readonly
Deletes associated attachments without purging them, leaving their respective blobs in place.
-
#purge
readonly
Directly purges each associated attachment (i.e.
-
#purge_later
readonly
Purges each associated attachment through the queuing system.
::ActiveStorage::Attached
- Inherited
Instance Method Summary
-
#attach(*attachables)
Attaches one or more
attachables
to the record. -
#attachments
Returns all the associated attachment records.
-
#blobs
Returns all attached blobs.
Constructor Details
This class inherits a constructor from ActiveStorage::Attached
Instance Attribute Details
#attached? ⇒ Boolean
(readonly)
Returns true if any attachments have been made.
class Gallery < ApplicationRecord
has_many_attached :photos
end
Gallery.new.photos.attached? # => false
# File 'activestorage/lib/active_storage/attached/many.rb', line 66
def attached? .any? end
#detach (readonly)
Deletes associated attachments without purging them, leaving their respective blobs in place.
# File 'activestorage/lib/active_storage/attached/many.rb', line 25
delegate :detach, to: :detach_many
#purge (readonly)
Directly purges each associated attachment (i.e. destroys the blobs and attachments and deletes the files on the service).
# File 'activestorage/lib/active_storage/attached/many.rb', line 13
delegate :purge, to: :purge_many
#purge_later (readonly)
Purges each associated attachment through the queuing system.
# File 'activestorage/lib/active_storage/attached/many.rb', line 19
delegate :purge_later, to: :purge_many
Instance Method Details
#attach(*attachables)
Attaches one or more attachables
to the record.
If the record is persisted and unchanged, the attachments are saved to the database immediately. Otherwise, they’ll be saved to the DB when the record is next saved.
document.images.attach(params[:images]) # Array of ActionDispatch::Http::UploadedFile objects
document.images.attach(params[:signed_blob_id]) # Signed reference to blob from direct upload
document.images.attach(io: File.open("/path/to/racecar.jpg"), filename: "racecar.jpg", content_type: "image/jpeg")
document.images.attach([ first_blob, second_blob ])
#attachments
Returns all the associated attachment records.
All methods called on this proxy object that aren’t listed here will automatically be delegated to attachments
.
#blobs
Returns all attached blobs.