модуль ActionText::Attribute
Публичные методы экземпляра
# File actiontext/lib/action_text/attribute.rb, line 50
def has_rich_text(name, encrypted: false, strict_loading: strict_loading_by_default)
class_eval <<-CODE, __FILE__, __LINE__ + 1
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
CODE
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,
strict_loading: strict_loading
scope :"with_rich_text_#{name}", -> { includes("rich_text_#{name}") }
scope :"with_rich_text_#{name}_and_embeds", -> { includes("rich_text_#{name}": { embeds_attachments: :blob }) }
end Предоставляет доступ к зависимой модели RichText, которая содержит тело и вложения для атрибута с указанным именем. Этот зависимый атрибут инициализируется лениво и будет автоматически сохранен, когда он изменится. Пример:
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!"
Зависимая модель RichText также автоматически обработает ссылки на вложения, отправленные через редактор Trix. Эти вложения связаны с моделью RichText с помощью Active Storage.
Если вы хотите предварительно загрузить зависимую модель RichText, вы можете использовать именованный запрос:
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.
Параметры
-
:encrypted- Установите значение true, чтобы зашифровать атрибут rich text. Шифрование будет не детерминированным. См.ActiveRecord::Encryption::EncryptableRecord.encrypts. По умолчанию: false. -
:strict_loading- Установите значение true, чтобы принудительно загрузить данные строго. Если параметр опущен,strict_loading:будет установлен в значение атрибута классаstrict_loading_by_default(по умолчанию false).
Примечание: Action Text полагается на полиморфные ассоциации, которые, в свою очередь, хранят имена классов в базе данных. При переименовании классов, использующих has_rich_text, убедитесь, что вы также обновили имена классов в столбце полиморфного типа action_text_rich_texts.record_type соответствующих строк.
# File actiontext/lib/action_text/attribute.rb, line 80
def rich_text_association_names
reflect_on_all_associations(:has_one).collect(&:name).select { |n| n.start_with?("rich_text_") }
end Возвращает имена всех ассоциаций rich text.
# File actiontext/lib/action_text/attribute.rb, line 75 def with_all_rich_text includes(rich_text_association_names) end
Загружает все зависимые модели RichText оптом.
© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.