.. include:: ../../../../Includes.txt
.. _typo3-fluid-be-tablelist:
============
be.tableList
============
View helper which renders a record list as known from the TYPO3 list module
Note: This feature is experimental!
Examples
========
Minimal::
Output::
List of all "Website user" records stored in the configured storage PID.
Records will be editable, if the current BE user has got edit rights for the table "fe_users".
Only the title column (username) will be shown.
Context menu is active.
Full::
Output::
List of "Website user" records with a text property of "foo" stored on PID 1 and two levels down.
Clicking on a username will open the TYPO3 info popup for the respective record
Arguments
=========
.. _be.tablelist_tablename:
tableName
---------
:aspect:`DataType`
string
:aspect:`Required`
true
:aspect:`Description`
Name of the database table
.. _be.tablelist_fieldlist:
fieldList
---------
:aspect:`DataType`
mixed
:aspect:`Default`
array ()
:aspect:`Required`
true
:aspect:`Description`
List of fields to be displayed. If empty, only the title column (configured in $TCA[$tableName]['ctrl']['title']) is shown
.. _be.tablelist_storagepid:
storagePid
----------
:aspect:`DataType`
mixed
:aspect:`Required`
true
:aspect:`Description`
By default, records are fetched from the storage PID configured in persistence.storagePid. With this argument, the storage PID can be overwritten
.. _be.tablelist_levels:
levels
------
:aspect:`DataType`
mixed
:aspect:`Required`
true
:aspect:`Description`
Corresponds to the level selector of the TYPO3 list module. By default only records from the current storagePid are fetched
.. _be.tablelist_filter:
filter
------
:aspect:`DataType`
string
:aspect:`Required`
true
:aspect:`Description`
Corresponds to the "Search String" textbox of the TYPO3 list module. If not empty, only records matching the string will be fetched
.. _be.tablelist_recordsperpage:
recordsPerPage
--------------
:aspect:`DataType`
mixed
:aspect:`Required`
true
:aspect:`Description`
Amount of records to be displayed at once. Defaults to $TCA[$tableName]['interface']['maxSingleDBListItems'] or (if that's not set) to 100
.. _be.tablelist_sortfield:
sortField
---------
:aspect:`DataType`
string
:aspect:`Required`
true
:aspect:`Description`
Table field to sort the results by
.. _be.tablelist_sortdescending:
sortDescending
--------------
:aspect:`DataType`
mixed
:aspect:`Required`
true
:aspect:`Description`
If TRUE records will be sorted in descending order
.. _be.tablelist_readonly:
readOnly
--------
:aspect:`DataType`
mixed
:aspect:`Required`
true
:aspect:`Description`
If TRUE, the edit icons won't be shown. Otherwise edit icons will be shown, if the current BE user has edit rights for the specified table!
.. _be.tablelist_enableclickmenu:
enableClickMenu
---------------
:aspect:`DataType`
mixed
:aspect:`Default`
true
:aspect:`Required`
true
:aspect:`Description`
Enables context menu
.. _be.tablelist_clicktitlemode:
clickTitleMode
--------------
:aspect:`DataType`
string
:aspect:`Required`
true
:aspect:`Description`
One of "edit", "show" (only pages, tt_content), "info