From 84361478256f620cc3c4d31235eeec28bba058f0 Mon Sep 17 00:00:00 2001
From: Sam Stephenson <sam@37signals.com>
Date: Mon, 23 Jan 2006 06:52:26 +0000
Subject: Add the ability to call JavaScriptGenerator methods from helpers
 called in update blocks

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@3470 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
---
 .../lib/action_view/helpers/prototype_helper.rb    | 58 ++++++++++++++++------
 1 file changed, 44 insertions(+), 14 deletions(-)

(limited to 'actionpack/lib/action_view')

diff --git a/actionpack/lib/action_view/helpers/prototype_helper.rb b/actionpack/lib/action_view/helpers/prototype_helper.rb
index d35334a98c..edf6f50a06 100644
--- a/actionpack/lib/action_view/helpers/prototype_helper.rb
+++ b/actionpack/lib/action_view/helpers/prototype_helper.rb
@@ -370,34 +370,52 @@ module ActionView
       # this in your Ajax response bodies, either in a <script> tag or as plain
       # JavaScript sent with a Content-type of "text/javascript".
       #
-      # Create new instances with PrototypeHelper#update_page, then call 
-      # #insert_html, #replace_html, #remove, #show, or #hide on the yielded
-      # generator in any order you like to modify the content and appearance of
-      # the current page.  (You can also call other helper methods which
-      # return JavaScript, such as 
-      # ActionView::Helpers::ScriptaculousHelper#visual_effect.)
+      # Create new instances with PrototypeHelper#update_page or with 
+      # ActionController::Base#render, then call #insert_html, #replace_html, 
+      # #remove, #show, #hide, #visual_effect, or any other of the built-in 
+      # methods on the yielded generator in any order you like to modify the 
+      # content and appearance of the current page. 
       #
       # Example:
       #
       #   update_page do |page|
-      #     page.insert_html :bottom, 'list', '<li>Last item</li>'
+      #     page.insert_html :bottom, 'list', "<li>#{@item.name}</li>"
       #     page.visual_effect :highlight, 'list'
       #     page.hide 'status-indicator', 'cancel-link'
       #   end
       # 
       # generates the following JavaScript:
       #
-      #   new Insertion.Bottom("list", "<li>Last item</li>");
+      #   new Insertion.Bottom("list", "<li>Some item</li>");
       #   new Effect.Highlight("list");
       #   ["status-indicator", "cancel-link"].each(Element.hide);
       #
+      # Helper methods can be used in conjunction with JavaScriptGenerator.
+      # When a helper method is called inside an update block on the +page+ 
+      # object, that method will also have access to a +page+ object.
+      # 
+      # Example:
+      #
+      #   module ApplicationHelper
+      #     def update_time
+      #       page.replace_html 'time', Time.now.to_s(:db)
+      #       page.visual_effect :highlight, 'time'
+      #     end
+      #   end
+      #
+      #   # Controller action
+      #   def poll
+      #     render :update { |page| page.update_time }
+      #   end
+      #
       # You can also use PrototypeHelper#update_page_tag instead of 
       # PrototypeHelper#update_page to wrap the generated JavaScript in a
       # <script> tag.
       class JavaScriptGenerator
-        def initialize(context) #:nodoc:
+        def initialize(context, &block) #:nodoc:
           @context, @lines = context, []
-          yield self
+          include_helpers_from_context
+          @context.instance_exec(self, &block)
         end
   
         def to_s #:nodoc:
@@ -501,12 +519,24 @@ module ActionView
           yield
           record "}, #{(seconds * 1000).to_i})"
         end
-
+        
+        # Starts a Scriptaculous visual effect. See 
+        # ActionView::Helpers::ScriptaculousHelper for more information.
+        def visual_effect(name, id, options = {})
+          record ScriptaculousHelper::visual_effect(name, id, options)
+        end
+        
       private
-        def method_missing(method, *arguments, &block)
-          record(@context.send(method, *arguments, &block))
+        def include_helpers_from_context
+          @context.extended_by.each do |mod|
+            extend mod unless mod.name =~ /^ActionView::Helpers/
+          end
         end
-
+        
+        def page
+          self
+        end
+        
         def record(line)
           returning line = "#{line.to_s.chomp.gsub /\;$/, ''};" do
             self << line
-- 
cgit v1.2.3