README

要求

此插件需要 Craft CMS 3.0.0 或更高版本。

安装

要安装插件，请按照以下说明操作。

1. 打开您的终端并转到您的 Craft 项目

    cd /path/to/project
   

2. 然后告诉 Composer 加载插件

    composer require hashtagerrors/craft-pagination
   

3. 在控制面板中，转到设置 → 插件，然后点击 Pagination 的“安装”按钮。

分页概述

此插件可以帮助您渲染以下类型的分页

• 第一页和下一页分页
• 省略号分页
• 数字分页

使用分页

要渲染分页，您需要使用以下代码

{% paginate craft.entries.section('blog').limit(1) as pageInfo, pageEntries %}
{{ craft.pagination.render(pageInfo, type, options) }}

• pageInfo 是在 {% paginate %} 标签中提供的 Craft 的 PaginateVariable。
• type 是您想要渲染的分页类型。可用的值有
  • firstNext
  • ellipsis
  • numeric
• options 提供了一种自定义通过插件渲染的 HTML 的方法。可用的选项有
  • ulClass : 在 <ul> 中添加的类
  • liClass : 在 <li> 中添加的类
  • aClass : 在 <a> 中添加的类
  • activeClass : 在当前页 <li> 上添加的类。默认为 active。
  • includeFirstLast : 如果您需要在分页中显示“第一页”和“最后一页”链接，请设置为 true。默认为 false。（仅适用于数字分页）
  • firstText : 第一页链接的文本。默认 **First **。
  • lastText : 最后一页链接的文本。默认 **last **。
  • includePrevNext : 如果您需要在分页中显示“上一页”和“下一页”链接，请设置为 true。（仅适用于数字分页）。默认为 false。（仅适用于数字分页）
  • prevText : 上一页链接的文本。默认 < Prev。
  • nextText : 下一页链接的文本。默认 Next >。
  • pageRange : 您想要显示的上一页和下一页链接的数量。默认 3。
  • showPageInfo : 设置为 true 以显示当前页码和总页数。默认 false。

模板示例

第一页和下一页分页

{{ craft.pagination.render(pageInfo, 'firstNext', {
	ulClass: 'pagination',
	liClass: 'page-item',
	aClass: 'page-link',
	showPageInfo : true,
	prevText: '<i class="fa fa-angle-double-left" aria-hidden="true"></i> Prev',
	nextText: 'Next <i class="fa fa-angle-double-right" aria-hidden="true"></i>'
}) }}

省略号分页

{{ craft.pagination.render(pageInfo, 'ellipsis', {
	ulClass: 'pagination',
	liClass: 'page-item',
	aClass: 'page-link',
	activeClass: 'active',
	includeFirstLast: true,
	includePrevNext: true,
	prevText: '<i class="fa fa-angle-double-left" aria-hidden="true"></i> Prev',
	nextText: 'Next <i class="fa fa-angle-double-right" aria-hidden="true"></i>',
	pageRange: 1
}) }}

数字分页

{{ craft.pagination.render(pageInfo, 'numeric', {
	ulClass: 'pagination',
	liClass: 'page-item',
	aClass: 'page-link',
	activeClass: 'active',
	includeFirstLast: true,
	includePrevNext: true,
	pageRange: 3
}) }}

分页路线图

• 为用户提供更多选项，使分页更加动态。

总是欢迎新的想法。您可以在 此处 发布您的想法或请求。

归属权

图标由 Freepik 制作，来源 Flaticon。

由 Hashtag Errors 提供