渲染集合时使用局部视图特别方便。通过 :collection 选项把集合传给局部视图时,会把集合中每个元素套入局部视图渲染:
<
h1
>Products</
h1
>
<%=
render partial:
"product"
, collection:
@products
%>
|
<
p
>Product Name:
<%=
product.name
%>
</
p
>
|
传入复数形式的集合时,在局部视图中可以使用和局部视图同名的变量引用集合中的成员。在上面的代码中,局部视图是 _product,在其中可以使用 product 引用渲染的实例。
渲染集合还有个简写形式。假设 @products 是 product 实例集合,在 index.html.erb 中可以直接写成下面的形式,得到的结果是一样的:
<
h1
>Products</
h1
>
<%=
render
@products
%>
|
Rails 根据集合中各元素的模型名决定使用哪个局部视图。其实,集合中的元素可以来自不同的模型,Rails 会选择正确的局部视图进行渲染。
<
h1
>Contacts</
h1
>
<%=
render [customer1, employee1, customer2, employee2]
%>
|
<
p
>Customer:
<%=
customer.name
%>
</
p
>
|
<
p
>Employee:
<%=
employee.name
%>
</
p
>
|
在上面几段代码中,Rails 会根据集合中各成员所属的模型选择正确的局部视图。
如果集合为空,render 方法会返回 nil,所以最好提供替代文本。
<
h1
>Products</
h1
>
<%=
render(
@products
) ||
"There are no products available."
%>
|
3.4.6 本地变量
要在局部视图中自定义本地变量的名字,调用局部视图时可通过 :as 选项指定:
<%=
render partial:
"product"
, collection:
@products
, as:
:item
%>
|
这样修改之后,在局部视图中可以使用本地变量 item 访问 @products 集合中的实例。
使用 locals: {} 选项可以把任意本地变量传入局部视图:
<%=
render partial:
"product"
, collection:
@products
,
as:
:item
, locals: {title:
"Products Page"
}
%>
|
在局部视图中可以使用本地变量 title,其值为 "Products Page"。
在局部视图中还可使用计数器变量,变量名是在集合后加上 _counter。例如,渲染 @products 时,在局部视图中可以使用 product_counter 表示局部视图渲染了多少次。不过不能和 as: :value 一起使用。
在使用主局部视图渲染两个实例中间还可使用 :spacer_template 选项指定第二个局部视图。
3.4.7 间隔模板
<%=
render partial:
@products
, spacer_template:
"product_ruler"
%>
|
Rails 会在两次渲染 _product 局部视图之间渲染 _product_ruler 局部视图(不传入任何数据)。
3.4.8 集合局部视图的布局
渲染集合时也可使用 :layout 选项。
<%=
render partial:
"product"
, collection:
@products
, layout:
"special_layout"
%>
|
使用局部视图渲染集合中的各元素时会套用指定的模板。和局部视图一样,当前渲染的对象以及 object_counter 变量也可在布局中使用。