Quelqu'un peut-il m'expliquer collection_select en termes clairs et simples?

Je suis en train de parcourir les documents de l'API Rails pour collection_selectet ils sont horribles.

Le titre est le suivant:

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

Et c'est le seul exemple de code qu'ils donnent:

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

Quelqu'un peut-il expliquer, en utilisant une simple association (disons a Userhas_many Plans, et a Planappartient à a User), ce que je veux utiliser dans la syntaxe et pourquoi?

Edit 1: De plus, ce serait génial si vous expliquiez comment cela fonctionne dans un form_helperformulaire ou un formulaire régulier. Imaginez que vous expliquez cela à un développeur Web qui comprend le développement Web, mais qui est «relativement nouveau» pour Rails. Comment l'expliquerais-tu?

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 votre exemple peut être représenté comme le code suivant:

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

Ce n'est pas documenté dans le FormBuilder, mais dans leFormOptionsHelper

J'ai moi-même passé pas mal de temps sur les permutations des balises sélectionnées.

collection_selectcrée une balise de sélection à partir d'une collection d'objets. Gardant cela à l'esprit,

object: Nom de l'objet. Ceci est utilisé pour générer le nom de la balise et pour générer la valeur sélectionnée. Cela peut être un objet réel ou un symbole - dans ce dernier cas, la variable d'instance de ce nom est recherchée dans la liaison duActionController (c'est-à-dire qu'elle :postrecherche une instance var appelée @postdans votre contrôleur.)

method: Nom de la méthode. Ceci est utilisé pour générer le nom de la balise. En d'autres termes, l'attribut de l'objet que vous essayez d'obtenir de la sélection

collection : La collection d'objets

value_method : Pour chaque objet de la collection, cette méthode est utilisée pour la valeur

text_method : Pour chaque objet de la collection, cette méthode est utilisée pour afficher du texte

Paramètres facultatifs:

options: Options que vous pouvez passer. Ceux-ci sont documentés ici , sous la rubrique Options.

html_options: Tout ce qui est passé ici, est simplement ajouté à la balise html générée. Si vous souhaitez fournir une classe, un identifiant ou tout autre attribut, il va ici.

Votre association pourrait s'écrire:

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

En ce qui concerne l'utilisation form_for, encore une fois en termes très simples, pour toutes les balises qui entrent dans form_for, par exemple.f.text_field, vous n'avez pas besoin de fournir le premier objectparamètre ( ). Ceci est tiré de la form_forsyntaxe.