- Stable
3.0.0- Canary
3.0.1-alpha.1
Toggle Menu
1.93s70.65sGet Next or Previous Collection Item Universal Filters
Contents
getPreviousCollectionItem and getNextCollectionItem
Fetch the previous and next items in a collection when you pass in the current page object.
{% assign previousPost = collections.posts | getPreviousCollectionItem: page %}
{% assign nextPost = collections.posts | getNextCollectionItem: page %}
<!-- in v2.0.0 the page argument is optional -->
{% assign previousPost = collections.posts | getPreviousCollectionItem %}
{% assign nextPost = collections.posts | getNextCollectionItem %}{% set previousPost = collections.posts | getPreviousCollectionItem(page) %}
{% set nextPost = collections.posts | getNextCollectionItem(page) %}
<!-- in v2.0.0 the page argument is optional -->
{% set previousPost = collections.posts | getPreviousCollectionItem %}
{% set nextPost = collections.posts | getNextCollectionItem %}This example has not yet been added—you can swap to another template language above! Or maybe you want to contribute it? Edit this page
This example has not yet been added—you can swap to another template language above! Or maybe you want to contribute it? Edit this page
Useful when you’d like to link to the previous or next template in your collection:
{% if previousPost %}Previous Blog Post: <a href="{{ previousPost.url }}">{{ previousPost.data.title }}</a>{% endif %}
{% if nextPost %}Next Blog Post: <a href="{{ nextPost.url }}">{{ nextPost.data.title }}</a>{% endif %}{% if previousPost %}Previous Blog Post: <a href="{{ previousPost.url }}">{{ previousPost.data.title }}</a>{% endif %}
{% if nextPost %}Next Blog Post: <a href="{{ nextPost.url }}">{{ nextPost.data.title }}</a>{% endif %}This example has not yet been added—you can swap to another template language above! Or maybe you want to contribute it? Edit this page
This example has not yet been added—you can swap to another template language above! Or maybe you want to contribute it? Edit this page
The Collections documentation outlines the default sorting algorithm and how to override it.
getCollectionItemIndex Added in v2.0.0
The getCollectionItemIndex filter returns the 0-based numeric index of the current (or passed) page in the collection.
{% assign index = collections.posts | getCollectionItemIndex %}
Or pass it in:
{% assign index = collections.posts | getCollectionItemIndex: page %}{% set index = collections.posts | getCollectionItemIndex %}
Or pass it in:
{% set index = collections.posts | getCollectionItemIndex(page) %}This example has not yet been added—you can swap to another template language above! Or maybe you want to contribute it? Edit this page
This example has not yet been added—you can swap to another template language above! Or maybe you want to contribute it? Edit this page
getCollectionItem
For completeness, a getCollectionItem filter is also included that fetches the current page from a collection.
{% assign currentPost = collections.posts | getCollectionItem: page %}
<!-- in v2.0.0 the page argument is optional -->
{% assign currentPost = collections.posts | getCollectionItem %}{% set currentPost = collections.posts | getCollectionItem(page) %}
<!-- in v2.0.0 the page argument is optional -->
{% set currentPost = collections.posts | getCollectionItem %}This example has not yet been added—you can swap to another template language above! Or maybe you want to contribute it? Edit this page
This example has not yet been added—you can swap to another template language above! Or maybe you want to contribute it? Edit this page