X-Git-Url: https://git.njae.me.uk/?a=blobdiff_plain;f=vendor%2Frails%2Factionpack%2Flib%2Faction_view%2Fhelpers%2Fcapture_helper.rb;fp=vendor%2Frails%2Factionpack%2Flib%2Faction_view%2Fhelpers%2Fcapture_helper.rb;h=e86ca27f31843c09f464397d700a7c28a8836a11;hb=d115f2e23823271635bad69229a42cd8ac68debe;hp=0000000000000000000000000000000000000000;hpb=37cb670bf3ddde90b214e591f100ed4446469484;p=depot.git
diff --git a/vendor/rails/actionpack/lib/action_view/helpers/capture_helper.rb b/vendor/rails/actionpack/lib/action_view/helpers/capture_helper.rb
new file mode 100644
index 0000000..e86ca27
--- /dev/null
+++ b/vendor/rails/actionpack/lib/action_view/helpers/capture_helper.rb
@@ -0,0 +1,136 @@
+module ActionView
+ module Helpers
+ # CaptureHelper exposes methods to let you extract generated markup which
+ # can be used in other parts of a template or layout file.
+ # It provides a method to capture blocks into variables through capture and
+ # a way to capture a block of markup for use in a layout through content_for.
+ module CaptureHelper
+ # The capture method allows you to extract part of a template into a
+ # variable. You can then use this variable anywhere in your templates or layout.
+ #
+ # ==== Examples
+ # The capture method can be used in ERb templates...
+ #
+ # <% @greeting = capture do %>
+ # Welcome to my shiny new web page! The date and time is
+ # <%= Time.now %>
+ # <% end %>
+ #
+ # ...and Builder (RXML) templates.
+ #
+ # @timestamp = capture do
+ # "The current timestamp is #{Time.now}."
+ # end
+ #
+ # You can then use that variable anywhere else. For example:
+ #
+ #
+ # <%= @greeting %>
+ #
+ # <%= @greeting %>
+ #
+ #
+ def capture(*args, &block)
+ # Return captured buffer in erb.
+ if block_called_from_erb?(block)
+ with_output_buffer { block.call(*args) }
+ else
+ # Return block result otherwise, but protect buffer also.
+ with_output_buffer { return block.call(*args) }
+ end
+ end
+
+ # Calling content_for stores a block of markup in an identifier for later use.
+ # You can make subsequent calls to the stored content in other templates or the layout
+ # by passing the identifier as an argument to yield.
+ #
+ # ==== Examples
+ #
+ # <% content_for :not_authorized do %>
+ # alert('You are not authorized to do that!')
+ # <% end %>
+ #
+ # You can then use yield :not_authorized anywhere in your templates.
+ #
+ # <%= yield :not_authorized if current_user.nil? %>
+ #
+ # You can also use this syntax alongside an existing call to yield in a layout. For example:
+ #
+ # <%# This is the layout %>
+ #
+ #
+ # My Website
+ # <%= yield :script %>
+ #
+ #
+ # <%= yield %>
+ #
+ #
+ #
+ # And now, we'll create a view that has a content_for call that
+ # creates the script identifier.
+ #
+ # <%# This is our view %>
+ # Please login!
+ #
+ # <% content_for :script do %>
+ #
+ # <% end %>
+ #
+ # Then, in another view, you could to do something like this:
+ #
+ # <%= link_to_remote 'Logout', :action => 'logout' %>
+ #
+ # <% content_for :script do %>
+ # <%= javascript_include_tag :defaults %>
+ # <% end %>
+ #
+ # That will place