Class: ActiveStorage::Attached::Many

Inherits:
ActiveStorage::Attached show all
Defined in:
activestorage/lib/active_storage/attached/many.rb

Overview

Decorated proxy object representing of multiple attachments to a model.

Instance Attribute Summary

Attributes inherited from ActiveStorage::Attached

#name, #record

Instance Method Summary collapse

Methods inherited from ActiveStorage::Attached

#initialize

Constructor Details

This class inherits a constructor from ActiveStorage::Attached

Instance Method Details

#attach(*attachables) ⇒ Object

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/jpg")
document.images.attach([ first_blob, second_blob ])


30
31
32
33
34
35
36
# File 'activestorage/lib/active_storage/attached/many.rb', line 30

def attach(*attachables)
  if record.persisted? && !record.changed?
    record.update(name => blobs + attachables.flatten)
  else
    record.public_send("#{name}=", (change&.attachables || blobs) + attachables.flatten)
  end
end

#attached?Boolean

Returns true if any attachments have been made.

class Gallery < ApplicationRecord
  has_many_attached :photos
end

Gallery.new.photos.attached? # => false

Returns:

  • (Boolean)


45
46
47
# File 'activestorage/lib/active_storage/attached/many.rb', line 45

def attached?
  attachments.any?
end

#attachmentsObject

Returns all the associated attachment records.

All methods called on this proxy object that aren’t listed here will automatically be delegated to attachments.



11
12
13
# File 'activestorage/lib/active_storage/attached/many.rb', line 11

def attachments
  change.present? ? change.attachments : record.public_send("#{name}_attachments")
end

#blobsObject

Returns all attached blobs.



16
17
18
# File 'activestorage/lib/active_storage/attached/many.rb', line 16

def blobs
  change.present? ? change.blobs : record.public_send("#{name}_blobs")
end

#detachObject

Deletes associated attachments without purging them, leaving their respective blobs in place.



50
51
52
# File 'activestorage/lib/active_storage/attached/many.rb', line 50

def detach
  attachments.delete_all if attached?
end