Representation of a single attachment to a model.
Instance Public methods
attachable to the record.
If the record is persisted and unchanged, the attachment is saved to the database immediately. Otherwise, it’ll be saved to the DB when the record is next saved.
person.avatar.attach(params[:avatar]) # ActionDispatch::Http::UploadedFile object person.avatar.attach(params[:signed_blob_id]) # Signed reference to blob from direct upload person.avatar.attach(io: File.open("/path/to/face.jpg"), filename: "face.jpg", content_type: "image/jpeg") person.avatar.attach(avatar_blob) # ActiveStorage::Blob object
true if an attachment has been made.
class User < ApplicationRecord has_one_attached :avatar end User.new.avatar.attached? # => false
Returns the associated attachment record.
You don’t have to call this method to access the attachment’s methods as they are all available at the model level.
true if an attachment is not attached.
class User < ApplicationRecord has_one_attached :avatar end User.new.avatar.blank? # => true
Deletes the attachment without purging it, leaving its blob in place.
Directly purges the attachment (i.e. destroys the blob and attachment and deletes the file on the service).