Permalink
Browse files

Added TIP about resources when using the short form_for syntax.

  • Loading branch information...
1 parent c9d7aff commit ece603cdf9ce20cf6acd84b3df669c5d516de2d3 @JosephPecoraro JosephPecoraro committed May 30, 2009
Showing with 2 additions and 0 deletions.
  1. +2 −0 railties/guides/source/form_helpers.textile
@@ -292,6 +292,8 @@ form_for(:article, @article, :url => article_path(@article), :method => "put")
form_for(@article)
</ruby>
+TIP: Declaring a resource will automatically generate the +*_path+ functions above. The short syntax expects such a function to exist based on the model of the object it is acting on. To declare a model as a resource, add the model to the resources list in the routes file +config/routes.rb+ like so: <pre>map.resources :articles</pre> Declaring a resource has a number of side-affects. See "Rails Routing From the Outside In":http://guides.rubyonrails.org/routing.html#restful-routing-the-rails-default for more information on setting up and using resources.
+
Notice how the short-style +form_for+ invocation is conveniently the same, regardless of the record being new or existing. Record identification is smart enough to figure out if the record is new by asking +record.new_record?+. It also selects the correct path to submit to and the name based on the class of the object.
Rails will also automatically set the +class+ and +id+ of the form appropriately: a form creating an article would have +id+ and +class+ +new_article+. If you were editing the article with id 23, the +class+ would be set to +edit_article+ and the id to +edit_article_23+. These attributes will be omitted for brevity in the rest of this guide.

0 comments on commit ece603c

Please sign in to comment.