diff options
author | Prem Sichanugrist <s@sikachu.com> | 2010-11-21 01:36:27 +0700 |
---|---|---|
committer | Xavier Noria <fxn@hashref.com> | 2010-11-21 03:29:44 +0100 |
commit | e65c23dc3e775be3162de25548f3192939ff3da3 (patch) | |
tree | 0d2b47dc3a63586c1e7594d66570de206e38ed56 /actionpack | |
parent | f975f35147d7d6df7f6094bfd60e3b7dd45aa2b3 (diff) | |
download | rails-e65c23dc3e775be3162de25548f3192939ff3da3.tar.gz rails-e65c23dc3e775be3162de25548f3192939ff3da3.tar.bz2 rails-e65c23dc3e775be3162de25548f3192939ff3da3.zip |
Mention the case that `render` will return nil if given `:collection` is nil or empty when rendering partial.
Diffstat (limited to 'actionpack')
-rw-r--r-- | actionpack/lib/action_view/partials.rb | 5 |
1 files changed, 5 insertions, 0 deletions
diff --git a/actionpack/lib/action_view/partials.rb b/actionpack/lib/action_view/partials.rb index 844c3e9572..cd3f130dc4 100644 --- a/actionpack/lib/action_view/partials.rb +++ b/actionpack/lib/action_view/partials.rb @@ -75,6 +75,11 @@ module ActionView # # <%= render :partial => "ad", :collection => @advertisements, :spacer_template => "ad_divider" %> # + # If the given <tt>:collection</tt> is nil or empty, <tt>render</tt> will return nil. This will allow you + # to specify a text which will displayed instead by using this form: + # + # <%= render(:partial => "ad", :collection => @advertisements) || "There's no ad to be displayed" %> + # # NOTE: Due to backwards compatibility concerns, the collection can't be one of hashes. Normally you'd also # just keep domain objects, like Active Records, in there. # |