laraish/pagination

一个用于生成分页的简单库。

v3.0.0 2023-12-05 07:36 UTC

This package is auto-updated.

Last update: 2024-09-05 09:19:44 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末尾的后缀。例如片段或查询字符串。