aboutsummaryrefslogtreecommitdiffstats
path: root/actionpack
diff options
context:
space:
mode:
authorPrem Sichanugrist <s@sikachu.com>2010-11-21 01:36:27 +0700
committerXavier Noria <fxn@hashref.com>2010-11-21 03:29:44 +0100
commite65c23dc3e775be3162de25548f3192939ff3da3 (patch)
tree0d2b47dc3a63586c1e7594d66570de206e38ed56 /actionpack
parentf975f35147d7d6df7f6094bfd60e3b7dd45aa2b3 (diff)
downloadrails-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.rb5
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.
#