Decorated proxy object representing of multiple attachments to a model.

Methods

Instance Public methods

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/jpg")
document.images.attach([ first_blob, second_blob ])
📝 Source code 
# File activestorage/lib/active_storage/attached/many.rb, line 30
    def attach(*attachables)
      if record.persisted? && !record.changed?
        record.public_send("#{name}=", blobs + attachables.flatten)
        record.save
      else
        record.public_send("#{name}=", (change&.attachables || blobs) + attachables.flatten)
      end
    end
🔎 See on GitHub

attached?()

Returns true if any attachments have been made.

class Gallery < ApplicationRecord
  has_many_attached :photos
end

Gallery.new.photos.attached? # => false
📝 Source code 
# File activestorage/lib/active_storage/attached/many.rb, line 46
    def attached?
      attachments.any?
    end
🔎 See on GitHub

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.

📝 Source code 
# File activestorage/lib/active_storage/attached/many.rb, line 11
    def attachments
      change.present? ? change.attachments : record.public_send("#{name}_attachments")
    end
🔎 See on GitHub

blobs()

Returns all attached blobs.

📝 Source code 
# File activestorage/lib/active_storage/attached/many.rb, line 16
    def blobs
      change.present? ? change.blobs : record.public_send("#{name}_blobs")
    end
🔎 See on GitHub

detach()

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

📝 Source code 
# File activestorage/lib/active_storage/attached/many.rb, line 51
    def detach
      attachments.delete_all if attached?
    end
🔎 See on GitHub

purge

Directly purges each associated attachment (i.e. destroys the blobs and attachments and deletes the files on the service).

🔎 See on GitHub

purge_later

Purges each associated attachment through the queuing system.

🔎 See on GitHub