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 %>

Source Code

# File action_view/helpers/cache_helper.rb, line 34
def cache(name = {}, options = nil, &block)
  handler = Base.handler_class_for_extension(current_render_extension.to_sym)
  handler.new(@controller).cache_fragment(block, name, options)
end