Revert "Revert "updated the ajax_on_rails.textile for rails3" because of invalid git user"

This reverts commit 5d2ffbb992b4ab875a121761fc0cf14dcaa12033.

1 files changed, 65 insertions, 4 deletions

diff --git a/railties/guides/source/ajax_on_rails.textile b/railties/guides/source/ajax_on_rails.textile
index 29d4fae888..b5d4fb10f8 100644
--- a/railties/guides/source/ajax_on_rails.textile
+++ b/railties/guides/source/ajax_on_rails.textile
@@ -3,7 +3,7 @@ h2. AJAX on Rails
 This guide covers the built-in Ajax/JavaScript functionality of Rails (and more); it will enable you to create rich and dynamic AJAX applications with ease! We will cover the following topics:
 
 * Quick introduction to AJAX and related technologies
-* Handling JavaScript the Rails way: Rails helpers, Prototype and script.aculo.us
+* Unobtrusive JavaScript helpers with drivers for Prototype, jQuery, and more coming (end of inline JS)
 * Testing JavaScript functionality
 
 endprologue.
@@ -26,13 +26,74 @@ How do 'standard' and AJAX requests differ, why does this matter for understandi
 
 h3. Built-in Rails Helpers
 
-Rails' JavaScript framework of choice is "Prototype":http://www.prototypejs.org. Prototype is a generic-purpose JavaScript framework that aims to ease the development of dynamic web applications by offering DOM manipulation, AJAX and other JavaScript functionality ranging from utility functions to object oriented constructs. It is not specifically written for any language, so Rails provides a set of helpers to enable seamless integration of Prototype with your Rails views.
+Rails 3.1 default javaScript framework of choice is Jquery "http://jquery.com".
+
+jQuery is a new kind of JavaScript Library and jQuery is a fast and concise JavaScript Library that simplifies HTML document traversing, event handling, animating, and Ajax interactions for rapid web development. jQuery is designed to change the way that you write JavaScript.
+
+jquery-rails is default gem and it adds Ruby on Rails style restful HTTP verbs to the jQuery library. Instead of sending an actual PUT or DELETE request (many browsers only support GET and POST), jQuery will make a POST request with an additional data parameter called _method set to the proper verb. Ruby on Rails can then act accordingly.
+
+Jquery helpers you can access defaultly - typically in your master layout, application.html.erb - like so:
+
+<ruby>
+javascript_include_tag :defaults
+</ruby>
+
+jquery-rails is default in Gemfile.
+
+<ruby>
+javascript_include_tag :defaults
+</ruby>
+
+All the remote_<method< helpers has been removed. To make them working with AJAX, simply pass the :remote => true option to the original non-remote method
+
+==== Examples
+<ruby>
+ button_to "New", :action => "new", :form_class => "new-thing"
+</ruby>
+# => "<form method="post" action="/controller/new" class="new-thing">
+#      <div><input value="New" type="submit" /></div>
+#    </form>"
 
-To get access to these helpers, all you have to do is to include the prototype framework in your pages - typically in your master layout, application.html.erb - like so:
 
 <ruby>
-javascript_include_tag 'prototype'
+ button_to "Create", :action => "create", :remote => true, :form => { "data-type" => "json" }
 </ruby>
+# => "<form method="post" action="/images/create" class="button_to" data-remote="true" data-type="json">
+#      <div><input value="Create" type="submit" /></div>
+#    </form>"
+
+
+<ruby>
+
+button_to "Delete Image", { :action => "delete", :id => @image.id },
+             :confirm => "Are you sure?", :method => :delete
+</ruby>
+
+# => "<form method="post" action="/images/delete/1" class="button_to">
+#      <div>
+#        <input type="hidden" name="_method" value="delete" />
+#        <input data-confirm='Are you sure?' value="Delete" type="submit" />
+#      </div>
+#    </form>"
+
+
+<ruby> button_to('Destroy', 'http://www.example.com', :confirm => 'Are you sure?',
+          :method => "delete", :remote => true, :disable_with => 'loading...')
+</ruby>
+# => "<form class='button_to' method='post' action='http://www.example.com' data-remote='true'>
+#       <div>
+#         <input name='_method' value='delete' type='hidden' />
+#         <input value='Destroy' type='submit' disable_with='loading...' data-confirm='Are you sure?' />
+#       </div>
+#     </form>"
+
+TODO: Write more Jquery helpers here.
+
+You can also specify the prototype to use instead of jquery or any other libraries
+
+rails new app_name -j prototype
+
+Prototype is a generic-purpose JavaScript framework that aims to ease the development of dynamic web applications by offering DOM manipulation, AJAX and other JavaScript functionality ranging from utility functions to object oriented constructs. It is not specifically written for any language, so Rails provides a set of helpers to enable seamless integration of Prototype with your Rails views.
 
 You are ready to add some AJAX love to your Rails app!