web-dev-qa-db-fra.com

Est-ce que quelqu'un peut m'expliquer collection_select en termes simples et clairs?

Je suis en train de parcourir les Rails docs de l'API pour collection_select Et ils sont affreux.

Le titre est ceci:

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

Et ceci 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 un User has_many Plans, et un Plan appartient à un 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_helper Ou un formulaire normal. Imaginez que vous l'expliquiez à un développeur Web qui comprend le développement Web, mais qui est "relativement nouveau" pour Rails. Comment l'expliquerais-tu?

ruby-on-railsruby-on-rails-3
128
marcamillion
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é par le code suivant:

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

Ceci n’est pas documenté dans le FormBuilder, mais dans le FormOptionsHelper

281
alexkv

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

collection_select Construit une balise select à 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 de ActionController (c'est-à-dire, :post Recherche une instance var appelée @post Dans 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 valeur

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

Paramètres optionnels:

options: Options que vous pouvez passer. Celles-ci sont documentées 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, cela se trouve ici.

Votre association pourrait être écrite comme:

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

En ce qui concerne l'utilisation de form_for, Encore une fois en termes très simples, pour toutes les balises comprises dans form_for, Par exemple. f.text_field, Vous n'avez pas besoin de fournir le premier paramètre (object). Ceci est tiré de la syntaxe form_for.

20
zsquare