aboutsummaryrefslogtreecommitdiffstats
path: root/guides
diff options
context:
space:
mode:
authorCarlos Antonio da Silva <carlosantoniodasilva@gmail.com>2012-04-26 22:06:41 -0300
committerCarlos Antonio da Silva <carlosantoniodasilva@gmail.com>2012-04-29 14:45:48 -0300
commitab318d2828683521f75cfa448a6560ef7edd2246 (patch)
tree04e922671cefbe1f42afbfc130701e692302eb43 /guides
parent228f9910389cad7fe0dd7f2bd010fe654f794b37 (diff)
downloadrails-ab318d2828683521f75cfa448a6560ef7edd2246.tar.gz
rails-ab318d2828683521f75cfa448a6560ef7edd2246.tar.bz2
rails-ab318d2828683521f75cfa448a6560ef7edd2246.zip
Add changelog entry and some docs for collection + layout
Diffstat (limited to 'guides')
-rw-r--r--guides/source/layouts_and_rendering.textile10
1 files changed, 10 insertions, 0 deletions
diff --git a/guides/source/layouts_and_rendering.textile b/guides/source/layouts_and_rendering.textile
index c2bba56581..f69afaa281 100644
--- a/guides/source/layouts_and_rendering.textile
+++ b/guides/source/layouts_and_rendering.textile
@@ -1193,6 +1193,16 @@ h5. Spacer Templates
Rails will render the +_product_ruler+ partial (with no data passed in to it) between each pair of +_product+ partials.
+h5. Partial Layouts
+
+When rendering collections it is also possible to use the +:layout+ option:
+
+<erb>
+<%= render :partial => "product", :collection => @products, :layout => "special_layout" %>
+</erb>
+
+The layout will be rendered together with the partial for each item in the collection. The current object and object_counter variables will be available in the layout as well, the same way they do within the partial.
+
h4. Using Nested Layouts
You may find that your application requires a layout that differs slightly from your regular application layout to support one particular controller. Rather than repeating the main layout and editing it, you can accomplish this by using nested layouts (sometimes called sub-templates). Here's an example: