---
title: "get_pagination"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/filter/get-pagination'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/filter/get-pagination.md'
---

# get_pagination


    对指定的资源集合进行分页，并返回包含分页信息与资源列表的分页对象 [paginate](https://developer.shopline.com/zh-hans-cn/docs/sline/object/paginate.md)。

    适用于跟以下对象结合使用：

- [all_collections](https://developer.shopline.com/zh-hans-cn/docs/sline/object/all-collections.md)
- [all_pages](https://developer.shopline.com/zh-hans-cn/docs/sline/object/all-pages.md)

> **注意**
>
> 为确保商店的性能和响应速度，在渲染一个页面的过程中，该过滤器的调用次数上限是 50 次。如果多次调用的传入参数一致，则这些调用在计数时会被视为一次。调用次数达到上限后，后续调用将会返回 `nil`。



    
`obj | get_pagination(page_size)` 返回一个 [`paginate`](https://developer.shopline.com/zh-hans-cn/docs/sline/object/paginate.md) 对象。
    



    
## 必选参数

        
            - `obj` [`all_collections`](https://developer.shopline.com/zh-hans-cn/docs/sline/object/all-collections.md), [`all_pages`](https://developer.shopline.com/zh-hans-cn/docs/sline/object/all-pages.md)：给定类型的全部资源对象。
        
            - `page_size` `integer`：每页的资源数量。
        
    





    
## 例子

        
            

            


            

            
<SlineExample path={''} objects={ 
    [""] 
}>
```sline
{{#var paginate = all_collections | get_pagination(10) /}}
{{#for collection in paginate.list}}
    {{forloop.index}}: {{ collection.title }}
{{/for}}
```
</SlineExample>