Mention the case that `render` will return nil if given `:collection` is nil or empty when rendering partial.

This commit is contained in:
Prem Sichanugrist 2010-11-21 01:36:27 +07:00 committed by Xavier Noria
parent f975f35147
commit e65c23dc3e
1 changed files with 5 additions and 0 deletions

View File

@ -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.
#