Может кто-нибудь объяснить мне collection_select в ясных и простых терминах?

Я просматриваю документы по Rails API, collection_selectи они ужасны.

Заголовок это:

collection_select(object, method, collection, value_method, text_method, options = {}, html_options = {})

И это единственный пример кода, который они дают:

collection_select(:post, :author_id, Author.all, :id, :name_with_initial, :prompt => true)

Может кто-нибудь объяснить, используя простую связь (скажем, Userhas_many Plansи a Planпринадлежит a User), что я хочу использовать в синтаксисе и почему?

Изменить 1: Также было бы здорово, если бы вы объяснили, как это работает внутри form_helperили в обычной форме. Представьте, что вы объясняете это веб-разработчику, который понимает веб-разработку, но является «относительно новым» для Rails. Как бы вы это объяснили?

collection_select(
    :post, # field namespace 
    :author_id, # field name
    # result of these two params will be: <select name="post[author_id]">...

    # then you should specify some collection or array of rows.
    # It can be Author.where(..).order(..) or something like that. 
    # In your example it is:
    Author.all, 

    # then you should specify methods for generating options
    :id, # this is name of method that will be called for every row, result will be set as key
    :name_with_initial, # this is name of method that will be called for every row, result will be set as value

    # as a result, every option will be generated by the following rule: 
    # <option value=#{author.id}>#{author.name_with_initial}</option>
    # 'author' is an element in the collection or array

    :prompt => true # then you can specify some params. You can find them in the docs.
)

Или ваш пример может быть представлен в виде следующего кода:

<select name="post[author_id]">
    <% Author.all.each do |author| %>
        <option value="<%= author.id %>"><%= author.name_with_initial %></option>
    <% end %>
</select>

Это не задокументировано в FormBuilder, но вFormOptionsHelper

Я потратил довольно много времени на перестановку тегов select самостоятельно.

collection_selectсоздает тег выбора из коллекции объектов. Имея это в виду,

object: Название объекта. Это используется для генерации имени тега и для генерации выбранного значения. Это может быть реальный объект или символ - в последнем случае переменная экземпляра с таким именем ищется в привязкеActionController (то есть :postищет экземпляр var, вызываемый @postв вашем контроллере).

method: Название метода. Это используется для генерации имени тега. Другими словами, атрибут объекта, который вы пытаетесь получить из выбора

collection : Коллекция предметов

value_method : Для каждого объекта в коллекции этот метод используется для значения

text_method : Для каждого объекта в коллекции этот метод используется для отображения текста

Необязательные параметры:

options: Параметры, которые вы можете передать. Они задокументированы здесь , под заголовком Опции.

html_optionsВсе, что здесь передано, просто добавляется в сгенерированный тег HTML. Если вы хотите указать класс, идентификатор или любой другой атрибут, он идет сюда.

Ваша ассоциация может быть записана как:

collection_select(:user, :plan_ids, Plan.all, :id, :name, {:prompt => true, :multiple=>true })

Что касается использования form_for, опять же в очень простых терминах, для всех тегов, которые входят в form_for, например. f.text_fieldВам не нужно указывать параметр first ( object). Это взято из form_forсинтаксиса.