---
title: "paginate"
doc_type: static
doc_category: static
doc_version: v20270301
source_url:
html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/paginate'
md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/paginate.md'
---
# paginate
一组分页信息，可用于构建分页导航和展示页面数据。
## 属性
array of [part](https://developer.shopline.com/zh-hans-cn/docs/sline/object/part.md)]}
>
分页部件，用于构建分页导航。
array of any]}
>
当前页的数据列表。
integer]}
>
当前页之前所有页面已显示的项目总数。
例如，如果每页显示 5 个项目且当前页为第 3 页，则 `paginate.current_offset` 返回 `10`。
integer]}
>
当前页的页码。
integer]}
>
所有页面显示的项目总数。
例如，如果你对一个共包含 120 个商品的集合进行分页，则 `paginate.items` 返回 `120`。
string]}
>
表示分页的 URL 参数。
默认值：`page`
integer]}
>
每页显示的项目数。
integer]}
>
总页数。
[part](https://developer.shopline.com/zh-hans-cn/docs/sline/object/part.md)]}
>
用于跳转到上一页的分页部件。
[part](https://developer.shopline.com/zh-hans-cn/docs/sline/object/part.md)]}
>
用于跳转到下一页的分页部件。
## 例子
以下示例通过 [get_product_pagination](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/get-product-pagination.md) filter 获取店铺内的一组商品，返回一个 `paginate` object。
```sline
{{#var paginate = collection | get_product_pagination(5) /}}
{{#for product in paginate.list}}
{{#link_to product.url}}
{{product.title}}
{{/link_to}}
{{/for}}
```