Qualcuno può spiegarmi collection_select in termini chiari e semplici?

Sto esaminando i documenti API di Rails per collection_selecte sono terribili.

L'intestazione è questa:

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

E questo è l'unico codice di esempio che danno:

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

Qualcuno può spiegare, usando una semplice associazione (ad esempio Userhas_many Planse a Planappartiene a a User), cosa voglio usare nella sintassi e perché?

Modifica 1: Inoltre, sarebbe fantastico se spiegassi come funziona all'interno di un form_helpermodulo normale. Immagina di spiegarlo a uno sviluppatore web che capisce lo sviluppo web, ma è "relativamente nuovo" per Rails. Come lo spiegheresti?

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

Oppure il tuo esempio può essere rappresentato come il seguente codice:

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

Questo non è documentato in FormBuilder, ma inFormOptionsHelper

Ho trascorso un bel po 'di tempo sulle permutazioni dei tag select da solo.

collection_selectcrea un tag di selezione da una raccolta di oggetti. Tenendo presente questo,

object: Nome dell'oggetto. Viene utilizzato per generare il nome del tag e per generare il valore selezionato. Questo può essere un oggetto reale o un simbolo: in quest'ultimo caso, la variabile di istanza con quel nome viene cercata nell'associazione diActionController (ovvero :postcerca un'istanza var chiamata @postnel controller).

method: Nome del metodo Questo è usato per generare il nome del tag. In altre parole, l'attributo dell'oggetto che stai cercando di ottenere dalla selezione

collection : La raccolta di oggetti

value_method : Per ciascun oggetto nella raccolta, questo metodo viene utilizzato per il valore

text_method : Per ciascun oggetto nella raccolta, questo metodo viene utilizzato per visualizzare il testo

Parametri opzionali:

options: Opzioni che puoi passare. Questi sono documentati qui , sotto la voce Opzioni.

html_options: Qualunque cosa venga passata qui, viene semplicemente aggiunta al tag html generato. Se si desidera fornire una classe, un ID o qualsiasi altro attributo, va qui.

La tua associazione potrebbe essere scritta come:

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

Per quanto riguarda l'utilizzo form_for, sempre in termini molto semplici, per tutti i tag che rientrano nel campo form_for, ad es. f.text_field, non è necessario fornire il primo objectparametro ( ). Questo è tratto dalla form_forsintassi.