Alguém pode me explicar o collection_select em termos claros e simples?

Estou analisando os documentos da API do Rails collection_selecte eles são horríveis.

O cabeçalho é o seguinte:

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

E este é o único código de exemplo que eles fornecem:

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

Alguém pode explicar, usando uma associação simples (digamos, um Userhas_many Planse um Planpertence a User), o que eu quero usar na sintaxe e por quê?

Edit 1: Além disso, seria incrível se você explicasse como funciona dentro de um form_helperformulário ou em um formulário regular. Imagine que você está explicando isso a um desenvolvedor web que entende de desenvolvimento web, mas é "relativamente novo" para o Rails. Como você explicaria isso?

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.
)

Ou seu exemplo pode ser representado como o seguinte código:

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

Isso não está documentado no FormBuilder, mas noFormOptionsHelper

Passei bastante tempo nas permutações das tags de seleção.

collection_selectcria uma tag de seleção de uma coleção de objetos. Mantendo isso em mente,

object: Nome do objeto. Isso é usado para gerar o nome da tag e para gerar o valor selecionado. Pode ser um objeto real ou um símbolo - neste último caso, a variável de instância com esse nome é procurada na ligação doActionController (ou seja, :postprocura por uma instância var chamada @postno seu controlador).

method: Nome do método. Isso é usado para gerar o nome da tag. Em outras palavras, o atributo do objeto que você está tentando obter da seleção

collection : A coleção de objetos

value_method : Para cada objeto na coleção, esse método é usado para o valor

text_method : Para cada objeto da coleção, esse método é usado para exibir texto

Parâmetros opcionais:

options: Opções que você pode passar. Eles estão documentados aqui , sob o título Opções.

html_options: O que for passado aqui, é simplesmente adicionado à tag html gerada. Se você deseja fornecer uma classe, ID ou qualquer outro atributo, ele será exibido aqui.

Sua associação pode ser escrita como:

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

No que diz respeito ao uso form_for, novamente em termos muito simples, para todas as tags que vêm dentro do form_for, por exemplo. f.text_field, você não precisa fornecer o primeiro objectparâmetro ( ). Isso é retirado da form_forsintaxe.