Attention
TYPO3 v9 has reached its end-of-life September 30th, 2021 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.
You can order Extended Long Term Support (ELTS) here: TYPO3 ELTS.
be.widget.paginate¶
This ViewHelper renders a Pagination of objects for the TYPO3 Backend.
Examples¶
Minimum call with required arguments only:
<f:be.widget.paginate objects="{blogs}" as="paginatedBlogs">
use {paginatedBlogs} as you used {blogs} before, most certainly inside
a <f:for> loop.
</f:be.widget.paginate>
Full example with all configuration options:
<f:be.widget.paginate objects="{blogs}" as="paginatedBlogs" configuration="{itemsPerPage: 5, insertAbove: 1, insertBelow: 0, recordsLabel: 'MyRecords'}">
use {paginatedBlogs} as you used {blogs} before, most certainly inside
a <f:for> loop.
</f:be.widget.paginate>
The recordsLabel
option can be used to replace the text in "Records 1 - 99" with a custom label.
Performance characteristics¶
In the above examples, it looks like {blogs}
contains all Blog objects, thus
you might wonder if all objects were fetched from the database.
However, the blogs are NOT fetched from the database until you actually use them,
so the paginate ViewHelper will adjust the query sent to the database and receive
only the small subset of objects.
So, there is no negative performance overhead in using the Be Paginate Widget.
Arguments¶
customWidgetId¶
- DataType
string
- Required
false
- Description
Extend the widget identifier with a custom widget id
objects¶
- DataType
mixed
- Required
false
- Description
The QueryResult containing all objects.
as¶
- DataType
string
- Required
false
- Description
As
configuration¶
- DataType
mixed
- Default
array ( 'itemsPerPage' => 10, 'insertAbove' => false, 'insertBelow' => true, 'maximumNumberOfLinks' => 99,)
- Required
false
- Description
Configuration