модуль ActionView::RecordIdentifier

Action View Идентификатор записи

RecordIdentifier обобщает методы, используемые различными ActionView помощниками для сопоставления записей с элементами DOM.

Рассмотрим, например, следующий код, который формирует пост:

<%= form_for(post) do |f| %>
  <%= f.text_field :body %>
<% end %>

Когда post является новой, несохраненной ActiveRecord::Base записью, результирующий HTML выглядит так:

<form class="new_post" id="new_post" action="/posts" accept-charset="UTF-8" method="post">
  <input type="text" name="post[body]" id="post_body" />
</form>

Когда post является сохраненной ActiveRecord::Base записью, результирующий HTML выглядит так:

<form class="edit_post" id="edit_post_42" action="/posts/42" accept-charset="UTF-8" method="post">
  <input type="text" value="What a wonderful world!" name="post[body]" id="post_body" />
</form>

В обоих случаях id и class обертывающего элемента DOM автоматически генерируются, следуя соглашениям об именовании, которые определены методами RecordIdentifier dom_id и dom_class:

dom_id(Post)             # => "new_post"
dom_class(Post)          # => "post"
dom_id(Post.new)         # => "new_post"
dom_class(Post.new)      # => "post"
dom_id(Post.find 42)     # => "post_42"
dom_class(Post.find 42)  # => "post"

Обратите внимание, что эти методы не требуют строго, чтобы Post был подклассом ActiveRecord::Base. Любой класс Post будет работать, если его экземпляры реагируют на to_key и model_name, при условии, что model_name реагирует на param_key. Например:

class Post
  attr_accessor :to_key

  def model_name
    OpenStruct.new param_key: 'post'
  end

  def self.find(id)
    new.tap { |post| post.to_key = [id] }
  end
end

Константы

JOIN
NEW

Публичные методы экземпляров

dom_class(record_or_class, prefix = nil) Показать исходный код

# File actionview/lib/action_view/record_identifier.rb, line 78
def dom_class(record_or_class, prefix = nil)
  singular = model_name_from_record_or_class(record_or_class).param_key
  prefix ? "#{prefix}#{JOIN}#{singular}" : singular
end

Соглашение по классам DOM заключается в использовании единственного числа для объекта или класса.

dom_class(post)   # => "post"
dom_class(Person) # => "person"

Если вам нужно обратиться к нескольким экземплярам одного класса в одном представлении, вы можете добавить префикс к dom_class:

dom_class(post, :edit)   # => "edit_post"
dom_class(Person, :edit) # => "edit_person"

dom_id(record_or_class, prefix = nil) Показать исходный код

# File actionview/lib/action_view/record_identifier.rb, line 93
def dom_id(record_or_class, prefix = nil)
  raise ArgumentError, "dom_id must be passed a record_or_class as the first argument, you passed #{record_or_class.inspect}" unless record_or_class

  record_id = record_key_for_dom_id(record_or_class) unless record_or_class.is_a?(Class)
  if record_id
    "#{dom_class(record_or_class, prefix)}#{JOIN}#{record_id}"
  else
    dom_class(record_or_class, prefix || NEW)
  end
end

Соглашение по идентификаторам DOM заключается в использовании единственного числа для объекта или класса с идентификатором, следующим за символом подчеркивания. Если идентификатор не найден, вместо этого используется префикс «new_».

dom_id(Post.find(45)) # => "post_45"
dom_id(Post)          # => "new_post"

Если вам нужно обратиться к нескольким экземплярам одного класса в одном представлении, вы можете добавить префикс к dom_id:

dom_id(Post.find(45), :edit) # => "edit_post_45"
dom_id(Post, :custom)        # => "custom_post"

Приватные методы экземпляров

record_key_for_dom_id(record) Показать исходный код

# File actionview/lib/action_view/record_identifier.rb, line 113
def record_key_for_dom_id(record) # :doc:
  key = convert_to_model(record).to_key
  key && key.all? ? key.join(JOIN) : nil
end

Возвращает строковое представление атрибута(ов) ключа, подходящего для использования в идентификаторе HTML DOM. Это можно переопределить, чтобы настроить стандартное строковое представление, если необходимо. Если вам нужно прочитать ключ из dom_id для запроса к записи в базе данных, вы должны написать помощник, например, «person_record_from_dom_id», который извлечет ключ, либо на основе стандартной реализации (которая просто объединяет все атрибуты ключа с помощью «_»), либо на основе вашего переопределенного метода. По умолчанию эта реализация передает строку ключа через метод, который заменяет все символы, недопустимые в идентификаторах DOM, допустимыми. Вам необходимо убедиться самим, что ваши идентификаторы DOM являются допустимыми, в случае если вы переопределяете этот метод.