# paginate

> paginate Liquid 对象：描述 Shoplazza Theme 中一对 paginate 标签内的分页状态，用于渲染分页导航。

关于一组 [paginate tags](../tags/iteration#paginate) 内分页的信息。

| Properties       | Type                                | Description                                                                                                                                      |
| :--------------- | :---------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |
| `current_offset` | [number](../basics/liquid-types#string) | 当前页面之前所有页面的项目总数。                                                                                 |
| `current_page`   | [number](../basics/liquid-types#string) | 当前页面的页码。                                                                                                             |
| `items`          | [number](../basics/liquid-types#string) | 待分页的项目总数。例如，若您对包含 120 个商品的 collection 进行分页，则 `paginate.items` 的值为 120。 |
| `next`           | [part](./part)                  | 跳转至下一页的分页部分。                                                                                                   |
| `pahe_size`      | [number](../basics/liquid-types#string) | 每页显示的项目数。                                                                                                          |
| `pages`          | [number](../basics/liquid-types#string) | 总页数。                                                                                                                       |
| `parts`          | an array of [part](./part)      | 分页部分，用于构建分页导航。                                                                  |

```json title="对象"
{
  "page_size": 8,
  "current_page": 1,
  "current_offset": 0,
  "pages": 11,
  "items": 85,
  "next": {
    "url": "/collections/all-products?preview_theme_id=&page=2",
    "is_link": true
  },
  "parts": [
    {
      "is_link": false,
      "title": "1",
      "url": ""
    },
    {
      "is_link": true,
      "title": "2",
      "url": "/collections/all-products?preview_theme_id=&page=2"
    },
    {
      "is_link": true,
      "title": "3",
      "url": "/collections/all-products?preview_theme_id=&page=3"
    },
    {
      "is_link": false,
      "title": "...",
      "url": ""
    }
  ]
}
```