From d856403c448e5f286768c5df18710cea33b568d0 Mon Sep 17 00:00:00 2001
From: "Rico Sta. Cruz" <hi@ricostacruz.com>
Date: Thu, 16 Apr 2015 15:55:46 +0800
Subject: [PATCH] Update rails-forms

---
 rails-forms.md | 138 ++++++++++++++++++++++++++++++++++---------------
 1 file changed, 96 insertions(+), 42 deletions(-)

diff --git a/rails-forms.md b/rails-forms.md
index ff7fcc478..cc5592d50 100644
--- a/rails-forms.md
+++ b/rails-forms.md
@@ -3,58 +3,92 @@ title: Rails form helpers
 layout: default
 ---
 
-### Forms
+## Form builder (form_for)
 
-    # Model:
-    form_for @post do |f|
+### Building forms
 
-    form_for @post,
-      url: { method: 'put', action: 'create' },
-      html: { class: 'nifty_form' } do |f|
+```haml
+- form_for @post do |f|
+```
 
-      f.label :first_name
-      f.text_field :first_name
+### Options
 
-      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|
-      = 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" />
+```haml
+= form_for @post do |f|
+  = fields_for :author, @post.author do |ff|
+    = ff.text_field :name
+```
 
 ### Select dropdowns
 
-    f.time_zone_select :time_zone
-    f.date_select :birthday
+```rb
+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}"
-    helpers.submit.update = "Confirm changes to %{model}"
+```yaml
+helpers:
+  submit:
+    # helpers.submit.<action>
+    create: "Create a %{model}"
+    update: "Confirm changes to %{model}"
 
-    helpers.submit.article.create = "Publish article"
-    helpers.submit.article.update = "Update article"
+    # helpers.submit.<model>.<action>
+    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" />
+```