Update rails-forms

rails-forms.md

@@ -3,58 +3,92 @@ title: Rails form helpers
 layout: default
 ---
 
-### Forms
+## Form builder (form_for)
 
-    # Model:
+### Building forms
-    form_for @post do |f|
 
-    form_for @post,
+```haml
-      url: { method: 'put', action: 'create' },
+- form_for @post do |f|
-      html: { class: 'nifty_form' } do |f|
+```
 
-      f.label :first_name
+### Options
-      f.text_field :first_name
 
-      field :multiselect, f, :first_name
+```haml
+- form_for @post, |
+  url: { method: 'put', action: 'create' }, |
+  html: { class: 'nifty_form' } do |f|
+```
 
-### Stuff
+### Text
 
-    f.object
+```rb
+f.text_field :title
+f.text_area :body, size: '60x12'
+```
+
+### Checkbox
+
+```rb
+f.check_box :remember_me
+f.label :remember_me, "Remember me"
+```
+
+### Radio
+
+```rb
+f.radio_button :gender, 'male'
+f.label :gender_male, "Male"
+f.radio_button :gender, 'female'
+f.label :gender_female, "Female"
+```
+
+
+### Label
+
+```rb
+f.label :post, :title
+f.label :post, :title, "Title"
+f.label :post, :title, "Title", class: "title"
+f.label(:post, :terms) { "Accept terms" }
+#=> <label for="post_title">Title</labele>
+```
+
+### The model
+
+```ruby
+f.object
+```
 
 ### Fields for
 
-    = form_for @post do |f|
+```haml
-      = fields_for :author, @post.author do |ff|
+= form_for @post do |f|
-        = ff.text_field :name
+  = fields_for :author, @post.author do |ff|
-
+    = ff.text_field :name
-### Fields
+```
-
-    f.check_box :is_admin
-    f.text_field :title
-    f.text_area :body,
-      size: '60x12'
-
-    f.label :post, :title
-    f.label :post, :title, "Title"
-    f.label :post, :title, "Title", class: "title"
-    f.label(:post, :terms) { "Accept terms" }
-    #=> <label for="post_title">Title</labele>
-
-    radio_button("post", "category", "rails")
-    radio_button("post", "category", "java")
-    #=> <input type="radio" id="post_category_rails" name="post[category]"
-    #   value="rails" checked="checked" />
 
 ### Select dropdowns
 
-    f.time_zone_select :time_zone
+```rb
-    f.date_select :birthday
+f.select :city_id, [['Lisbon',1], ['Madrid',2], ...], 4   # (4 = selected)
 
-    f.select :city_id, [['Lisbon',1], ['Madrid',2], ...], 4   # (4 = selected)
+options_for_select [['Lisbon',1], ['Madrid', 2], ...], 4  # Just makes <option> tags
+```
 
-    f.collection_select :city_id, City.all, :id, :name
+### Collections
 
-    options_for_select [['Lisbon',1], ['Madrid', 2], ...], 4  # Just makes <option> tags
+```
+f.collection_radio_buttons :author_id, Author.all, :id, :name_with_initial
+f.collection_select :city_id, City.all, :id, :name
+# (field, collection, value_key, label_key)
+```
+
+### Time select
+
+```rb
+f.time_zone_select :time_zone
+f.date_select :birthday
+```
 
 ### The rest
 
@@ -63,11 +97,31 @@ layout: default
 
 ### I18n
 
-    helpers.submit.create = "Create a %{model}"
+```yaml
-    helpers.submit.update = "Confirm changes to %{model}"
+helpers:
+  submit:
+    # helpers.submit.<action>
+    create: "Create a %{model}"
+    update: "Confirm changes to %{model}"
 
-    helpers.submit.article.create = "Publish article"
+    # helpers.submit.<model>.<action>
-    helpers.submit.article.update = "Update article"
+    article:
+      create: "Publish article"
+      update: "Update article"
 
-    helpers.label.post.body = "Write your body text here"
+  # helpers.label.<model>.<field>
+  label:
+    post:
+      body: "Your body text"
+```
 
+### Outside `f`
+
+```rb
+radio_button("post", "category", "rails")
+radio_button("post", "category", "java")
+
+# picks from @post.category
+# <input type="radio" id="post_category_rails" name="post[category]"
+#  value="rails" checked="checked" />
+```