method

has_rich_text

v7.0.0 - Show latest stable - Class: ActionText::Attribute

has_rich_text(name, encrypted: false)

public

Provides access to a dependent RichText model that holds the body and attachments for a single named rich text attribute. This dependent attribute is lazily instantiated and will be auto-saved when it’s been changed. Example:

class Message < ActiveRecord::Base
  has_rich_text :content
end

message = Message.create!(content: "<h1>Funny times!</h1>")
message.content? #=> true
message.content.to_s # => "<h1>Funny times!</h1>"
message.content.to_plain_text # => "Funny times!"

The dependent RichText model will also automatically process attachments links as sent via the Trix-powered editor. These attachments are associated with the RichText model using Active Storage.

If you wish to preload the dependent RichText model, you can use the named scope:

 Message.all.with_rich_text_content # Avoids N+1 queries when you just want the body, not the attachments.
 Message.all.with_rich_text_content_and_embeds # Avoids N+1 queries when you just want the body and attachments.
 Message.all.with_all_rich_text # Loads all rich text associations.

=== Options

* <tt>:encrypted</tt> - Pass true to encrypt the rich text attribute. The encryption will be non-deterministic. See
+ActiveRecord::Encryption::EncryptableRecord.encrypts+. Default: false.

# File actiontext/lib/action_text/attribute.rb, line 33
      def has_rich_text(name, encrypted: false)
        class_eval           def #{name}            rich_text_#{name} || build_rich_text_#{name}          end          def #{name}?            rich_text_#{name}.present?          end          def #{name}=(body)            self.#{name}.body = body          end, __FILE__, __LINE__ + 1

        rich_text_class_name = encrypted ? "ActionText::EncryptedRichText" : "ActionText::RichText"
        has_one :"rich_text_#{name}", -> { where(name: name) },
          class_name: rich_text_class_name, as: :record, inverse_of: :record, autosave: true, dependent: :destroy

        scope :"with_rich_text_#{name}", -> { includes("rich_text_#{name}") }
        scope :"with_rich_text_#{name}_and_embeds", -> { includes("rich_text_#{name}": { embeds_attachments: :blob }) }
      end

has_rich_text

Related methods