CursorPaginator
class CursorPaginator extends AbstractCursorPaginator implements Arrayable, ArrayAccess, Countable, IteratorAggregate, Jsonable, JsonSerializable, CursorPaginator
Traits
Properties
| protected bool | $hasMore | Indicates whether there are more items in the data source. |
|
| protected TValue> | $items | All of the items being paginated. |
from AbstractCursorPaginator |
| protected int | $perPage | The number of items to be shown per page. |
from AbstractCursorPaginator |
| protected string | $path | The base path to assign to all URLs. |
from AbstractCursorPaginator |
| protected array<string, mixed> | $query | The query parameters to add to all URLs. |
from AbstractCursorPaginator |
| protected string|null | $fragment | The URL fragment to add to all URLs. |
from AbstractCursorPaginator |
| protected string | $cursorName | The cursor string variable used to store the page. |
from AbstractCursorPaginator |
| protected Cursor|null | $cursor | The current cursor. |
from AbstractCursorPaginator |
| protected array<int, string> | $parameters | The paginator parameters for the cursor. |
from AbstractCursorPaginator |
| protected array<string, mixed> | $options | The paginator options. |
from AbstractCursorPaginator |
| static protected Closure|null | $currentCursorResolver | The current cursor resolver callback. |
from AbstractCursorPaginator |
Methods
Forward a method call to the given object.
Forward a method call to the given object, returning $this if the forwarded call returned itself.
Throw a bad method call exception for the given method.
Call the given Closure with this instance then return the instance.
Create a new resource collection instance for the given resource.
Guess the resource collection for the items.
Get the resource class from the class attribute.
Get the resource collection class from the class attribute.
Render the paginator using the given view.
Get the "cursor" that points to the previous set of items.
Get the "cursor" that points to the next set of items.
Get a cursor instance for the given item.
Get the cursor parameters for a given object.
Get the cursor parameter value from a pivot model if applicable.
Ensure the parameter is a primitive type.
Get / set the URL fragment to be appended to URLs.
Add a set of query string values to the paginator.
Add an array of query string values.
Add all current query string values to the paginator.
Add a query string value to the paginator.
Load a set of relationships onto the mixed relationship collection.
Load a set of relationship counts onto the mixed relationship collection.
Transform each item in the slice of items using a callback.
Get the query string variable used to store the cursor.
Set the query string variable used to store the cursor.
Set the base path to assign to all URLs.
Set the base path to assign to all URLs.
Resolve the current cursor or return the default value.
Get an instance of the view factory from the resolver.
Set the item at the given offset.
Make dynamic calls into the collection.
Render the contents of the paginator when casting to a string.
Create a new paginator instance.
Set the items for the paginator.
Render the paginator using the given view.
Determine if there are more items in the data source.
Determine if there are enough items to split into multiple pages.
Determine if the paginator is on the first page.
Determine if the paginator is on the last page.
Get the instance as an array.
Convert the object into something JSON serializable.
Convert the object to its JSON representation.
Convert the object to pretty print formatted JSON.
Details
in
ForwardsCalls at line 22
protected mixed
forwardCallTo(mixed $object, string $method, array $parameters)
Forward a method call to the given object.
in
ForwardsCalls at line 52
protected mixed
forwardDecoratedCallTo(mixed $object, string $method, array $parameters)
Forward a method call to the given object, returning $this if the forwarded call returned itself.
in
ForwardsCalls at line 66
static protected never
throwBadMethodCallException(string $method)
Throw a bad method call exception for the given method.
in
Tappable at line 15
mixed
tap(callable|null $callback = null)
Call the given Closure with this instance then return the instance.
in
TransformsToResourceCollection at line 25
ResourceCollection
toResourceCollection(string|null $resourceClass = null)
Create a new resource collection instance for the given resource.
in
TransformsToResourceCollection at line 39
protected ResourceCollection
guessResourceCollection()
Guess the resource collection for the items.
in
TransformsToResourceCollection at line 92
protected string|null
resolveResourceFromAttribute(string $class)
Get the resource class from the class attribute.
in
TransformsToResourceCollection at line 111
protected string|null
resolveResourceCollectionFromAttribute(string $class)
Get the resource collection class from the class attribute.
at line 90
Htmlable
render(string|null $view = null, array $data = [])
Render the paginator using the given view.
in
AbstractCursorPaginator at line 110
string
url(Cursor|null $cursor)
Get the URL for a given cursor.
in
AbstractCursorPaginator at line 130
string|null
previousPageUrl()
Get the URL for the previous page.
in
AbstractCursorPaginator at line 142
string|null
nextPageUrl()
The URL for the next page, or null.
in
AbstractCursorPaginator at line 154
Cursor|null
previousCursor()
Get the "cursor" that points to the previous set of items.
in
AbstractCursorPaginator at line 171
Cursor|null
nextCursor()
Get the "cursor" that points to the next set of items.
in
AbstractCursorPaginator at line 188
Cursor
getCursorForItem(array|object $item, bool $isNext = true)
Get a cursor instance for the given item.
in
AbstractCursorPaginator at line 200
array
getParametersForItem(array|object $item)
Get the cursor parameters for a given object.
in
AbstractCursorPaginator at line 232
protected string|null
getPivotParameterForItem(Model $item, string $parameterName)
Get the cursor parameter value from a pivot model if applicable.
in
AbstractCursorPaginator at line 252
protected mixed
ensureParameterIsPrimitive(mixed $parameter)
Ensure the parameter is a primitive type.
This can resolve issues that arise the developer uses a value object for an attribute.
in
AbstractCursorPaginator at line 264
AbstractCursorPaginator|string|null
fragment(string|null $fragment = null)
Get / set the URL fragment to be appended to URLs.
in
AbstractCursorPaginator at line 280
AbstractCursorPaginator
appends(array|string|null $key, string|null $value = null)
Add a set of query string values to the paginator.
in
AbstractCursorPaginator at line 299
protected AbstractCursorPaginator
appendArray(array $keys)
Add an array of query string values.
in
AbstractCursorPaginator at line 313
AbstractCursorPaginator
withQueryString()
Add all current query string values to the paginator.
in
AbstractCursorPaginator at line 327
protected AbstractCursorPaginator
addQuery(string $key, mixed $value)
Add a query string value to the paginator.
in
AbstractCursorPaginator at line 339
protected string
buildFragment()
Build the full fragment portion of a URL.
in
AbstractCursorPaginator at line 350
AbstractCursorPaginator
loadMorph(string $relation, array $relations)
Load a set of relationships onto the mixed relationship collection.
in
AbstractCursorPaginator at line 364
AbstractCursorPaginator
loadMorphCount(string $relation, array $relations)
Load a set of relationship counts onto the mixed relationship collection.
in
AbstractCursorPaginator at line 377
array
items()
Get the slice of items being paginated.
in
AbstractCursorPaginator at line 392
AbstractCursorPaginator
through(callable $callback)
Transform each item in the slice of items using a callback.
in
AbstractCursorPaginator at line 402
int
perPage()
Get the number of items shown per page.
in
AbstractCursorPaginator at line 410
Cursor|null
cursor()
Get the current cursor being paginated.
in
AbstractCursorPaginator at line 418
string
getCursorName()
Get the query string variable used to store the cursor.
in
AbstractCursorPaginator at line 428
AbstractCursorPaginator
setCursorName(string $name)
Set the query string variable used to store the cursor.
in
AbstractCursorPaginator at line 440
AbstractCursorPaginator
withPath(string $path)
Set the base path to assign to all URLs.
in
AbstractCursorPaginator at line 450
AbstractCursorPaginator
setPath(string $path)
Set the base path to assign to all URLs.
in
AbstractCursorPaginator at line 460
string|null
path()
Get the base path for paginator generated URLs.
in
AbstractCursorPaginator at line 468
static Cursor|null
resolveCurrentCursor(string $cursorName = 'cursor', Cursor|null $default = null)
Resolve the current cursor or return the default value.
in
AbstractCursorPaginator at line 483
static void
currentCursorResolver(Closure $resolver)
Set the current cursor resolver callback.
Boot-only. The resolver persists in a static property for the worker lifetime and runs on every subsequent cursor-paginator's cursor lookup.
in
AbstractCursorPaginator at line 491
static mixed
viewFactory()
Get an instance of the view factory from the resolver.
in
AbstractCursorPaginator at line 499
static void
flushState()
Flush all static state.
in
AbstractCursorPaginator at line 509
Traversable
getIterator()
Get an iterator for the items.
in
AbstractCursorPaginator at line 517
bool
isEmpty()
Determine if the list of items is empty.
in
AbstractCursorPaginator at line 525
bool
isNotEmpty()
Determine if the list of items is not empty.
in
AbstractCursorPaginator at line 533
int
count()
Get the number of items for the current page.
in
AbstractCursorPaginator at line 543
Collection
getCollection()
Get the paginator's underlying collection.
in
AbstractCursorPaginator at line 559
AbstractCursorPaginator
setCollection(Collection $collection)
Set the paginator's underlying collection.
in
AbstractCursorPaginator at line 572
array
getOptions()
Get the paginator options.
in
AbstractCursorPaginator at line 582
bool
offsetExists(TKey $key)
Determine if the given item exists.
in
AbstractCursorPaginator at line 593
mixed
offsetGet(TKey $key)
Get the item at the given offset.
in
AbstractCursorPaginator at line 604
void
offsetSet(null|TKey $key, TValue $value)
Set the item at the given offset.
in
AbstractCursorPaginator at line 614
void
offsetUnset(TKey $key)
Unset the item at the given key.
in
AbstractCursorPaginator at line 622
string
toHtml()
Render the contents of the paginator to HTML.
in
AbstractCursorPaginator at line 634
mixed
__call(string $method, array $parameters)
Make dynamic calls into the collection.
in
AbstractCursorPaginator at line 642
string
__toString()
Render the contents of the paginator when casting to a string.
at line 42
__construct(mixed $items, int $perPage, Cursor|null $cursor = null, array $options = [])
Create a new paginator instance.
at line 62
protected void
setItems(mixed $items)
Set the items for the paginator.
at line 80
Htmlable
links(string|null $view = null, array $data = [])
Render the paginator using the given view.
at line 100
bool
hasMorePages()
Determine if there are more items in the data source.
at line 110
bool
hasPages()
Determine if there are enough items to split into multiple pages.
at line 118
bool
onFirstPage()
Determine if the paginator is on the first page.
at line 126
bool
onLastPage()
Determine if the paginator is on the last page.
at line 136
array
toArray()
Get the instance as an array.
at line 154
array
jsonSerialize()
Convert the object into something JSON serializable.
at line 162
string
toJson(int $options = 0)
Convert the object to its JSON representation.
at line 170
string
toPrettyJson(int $options = 0)
Convert the object to pretty print formatted JSON.