wllionel/pagination

一个简单的分页生成库。

v1.0.6 2022-10-12 08:55 UTC

This package is auto-updated.

Last update: 2024-09-12 13:57:42 UTC


README

这是一个用于创建分页的简单PHP库。

基本用法

以下是在WordPress中创建分页的示例。

global $wp_query;

// The total number of items
$total       = (int)$wp_query->found_posts;

// The number of items are going to be displayed per page.
$perPage     = (int)$wp_query->query_vars['posts_per_page'];

// The current page number.
$currentPage = (int)$wp_query->query_vars['paged'];

// additional options
$options     = ['urlStyle' => 'pretty'];


$paginator   = new Paginator($total, $perPage, $currentPage, $options);
    
echo $paginator->toHtml();

自定义标记

如果您不喜欢默认的标记,您可以指定自己的视图文件以输出标记。

$paginator = new Paginator($total, $perPage, $currentPage, ['view'=> '/www/var/example.com/pagination.php']);

您还可以使用点符号指定视图,例如 ['view'=> 'components.pagination'];通过使用点符号,它将尝试使用Blade模板(如果可能的话)。

查看预设视图以获取更多详细信息。

选项

onEachSide

中心链接两侧的链接数量。

type

渲染类型。

  • default
  • menu
  • simple

view

视图文件的路径。

可以是Blade模板或普通PHP文件。
如果您想使用PHP文件,应在字符串末尾添加.php

urlStyle

链接样式。

  • pretty:example.com/news/page/10
  • queryString:example.com/news/?page=10

nextPageText

下一页链接文本。

prevPageText

上一页链接文本。

path

用户定义的基本路径。

suffix

添加到URL末尾的后缀。例如片段或查询字符串。