diff options
author | David Heinemeier Hansson <david@loudthinking.com> | 2007-06-23 17:49:18 +0000 |
---|---|---|
committer | David Heinemeier Hansson <david@loudthinking.com> | 2007-06-23 17:49:18 +0000 |
commit | b00e6a984df51a2f891c2a4c819ac2ab08359eed (patch) | |
tree | 963bdbbc51159f294be459788c2a57eef0624f1d /actionpack/lib/action_view/helpers/cache_helper.rb | |
parent | 8aefa3ee75e261488a39ea9d26a767c9db696c20 (diff) | |
download | rails-b00e6a984df51a2f891c2a4c819ac2ab08359eed.tar.gz rails-b00e6a984df51a2f891c2a4c819ac2ab08359eed.tar.bz2 rails-b00e6a984df51a2f891c2a4c819ac2ab08359eed.zip |
Massive documentation update for all helpers (closes #8223, #8177, #8175, #8108, #7977, #7972, #7971, #7969) [jeremymcanally]
git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@7106 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
Diffstat (limited to 'actionpack/lib/action_view/helpers/cache_helper.rb')
-rw-r--r-- | actionpack/lib/action_view/helpers/cache_helper.rb | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/actionpack/lib/action_view/helpers/cache_helper.rb b/actionpack/lib/action_view/helpers/cache_helper.rb index de2707ac75..cf5420a35e 100644 --- a/actionpack/lib/action_view/helpers/cache_helper.rb +++ b/actionpack/lib/action_view/helpers/cache_helper.rb @@ -1,7 +1,36 @@ module ActionView module Helpers + # This helper to exposes a method for caching of view fragments. # See ActionController::Caching::Fragments for usage instructions. module CacheHelper + # A method for caching fragments of a view rather than an entire + # action or page. This technique is useful caching pieces like + # menus, lists of news topics, static HTML fragments, and so on. + # This method takes a block that contains the content you wish + # to cache. See ActionController::Caching::Fragments for more + # information. + # + # ==== Examples + # If you wanted to cache a navigation menu, you could do the + # following. + # + # <% cache do %> + # <%= render :partial => "menu" %> + # <% end %> + # + # You can also cache static content... + # + # <% cache do %> + # <p>Hello users! Welcome to our website!</p> + # <% end %> + # + # ...and static content mixed with RHTML content. + # + # <% cache do %> + # Topics: + # <%= render :partial => "topics", :collection => @topic_list %> + # <i>Topics listed alphabetically</i> + # <% end %> def cache(name = {}, &block) @controller.cache_erb_fragment(block, name) end |