当创建 Laravel 分页器的新实例时,我知道如何使用它的
__construct
方法的所有参数,除了一个。根据 Paginator Laravel API 页面,它应该看起来像这样:
void __construct(mixed $items, int $perPage, int|null $currentPage = null, array $options = [])
我需要有关
options
参数的帮助。页面上写着:
Parameters ... array $options (path, query, fragment, pageName)
所有这些选项都有什么作用以及如何使用它们?我找不到任何合适的文档,我所拥有的所有信息都是其他编码员使用
path
元素的一些示例。
没有什么特别使用这个
$options
参数。当您传递此参数时,它会在类上设置 $options
,并且还会迭代 $options
数组,并使用从键到选项的名称设置类变量。因此,当您手动创建 Paginator 实例时,您可以使用“options”参数作为设置 Paginator 实例本身的一些属性的一种方式。您还可以将其用作额外数据来与分页器一起传递,因为您可以从 getOptions()
访问这些选项
当然不再需要了,但为了以后的访问:
挑剔文档以查找每个可能的值,发现以下内容:
给定数组的 4 个可能值(随意省略任意一对
'key' => value
):
['path' => '/categories/misc', # Base Path for all generated links.
'query' => ['sort' => 'age', # Some additional variables on the links.
'thing' => 5],
'fragment' => 'SeaTurtles', # Value that will appear after the '#' sign.
'pageName' => 'myPageNumber'] /* The name of the variable used for
pagination that will appear on the
url/request. The default value is 'page'. */
这些选项将生成以下形式的链接:(以第 3 页为例)
http[s]://theSite.com/categories/misc?myPageNumber=3&sort=age&thing=5#SeaTurtles
'路径' -> 路径选项文档
'query' -> 查询选项文档(注意我可能会弄错这个语法。)
'fragment' -> 片段选项文档
'pageName' -> 无文档。在 AbstractPaginator 类中,它显示为出现在 url 中“?”之后的默认页码变量名称。它显示在“路径”文档中。