Documentation · ViewHelper reference

Be / TableListViewHelper

View helper which renders a record list as known from the TYPO3 list module
Note: This feature is experimental!



<f:be.tableList tableName="fe_users" />


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.


<f:be.tableList tableName="fe_users" fieldList="{0: 'name', 1: 'email'}" storagePid="1" levels="2" filter='foo' recordsPerPage="10" sortField="name" sortDescending="true" readOnly="true" enableClickMenu="false" clickTitleMode="info" />


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

  • Tag usage example

    <f:be.tableList tableName="foo" fieldList="{foo: 'bar'}" storagePid="123" levels="123" filter="''" recordsPerPage="123" sortField="''" sortDescending="1" readOnly="1" enableClickMenu="1" clickTitleMode="NULL" alternateBackgroundColors="1">
    	<!-- tag content - may be ignored! -->
  • Inline usage example

    {f:be.tableList(tableName: 'foo', fieldList: {foo: 'bar'}, storagePid: 123, levels: 123, filter: '''', recordsPerPage: 123, sortField: '''', sortDescending: 1, readOnly: 1, enableClickMenu: 1, clickTitleMode: 'NULL', alternateBackgroundColors: 1)}


Argument Description Type

Deprecated since TYPO3 CMS 7, will be removed in TYPO3 CMS 8


one of "edit", "show" (only pages, tt_content), "info


enables context menu


list of fields to be displayed. If empty, only the title column (configured in $TCA[$tableName]['ctrl']['title']) is shown


corresponds to the "Search String" textbox of the TYPO3 list module. If not empty, only records matching the string will be fetched


corresponds to the level selector of the TYPO3 list module. By default only records from the current storagePid are fetched


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!


amount of records to be displayed at once. Defaults to $TCA[$tableName]['interface']['maxSingleDBListItems'] or (if that's not set) to 100


if TRUE records will be sorted in descending order


table field to sort the results by


by default, records are fetched from the storage PID configured in persistence.storagePid. With this argument, the storage PID can be overwritten


name of the database table

Required attribute

Revision history

commit ff44e717bfec159d9ce96917bd10c26bf613672b
Author: Bastian Waidelich <*****>
Date:   Wed Sep 23 15:33:06 2009 +0000

    [+FEATURE] Fluid(ViewHelpers): Added BE view helpers be.container, be.buttons.csh, be.buttons.icon, be.menus.actionMenu, be.pageInfo & be.tableList. NOTE: BE view helpers are still experimental and subject of change!
    [+FEATURE] Fluid(ViewHelpers): TranslateViewHelper now fully works in BE mode and respects BE user language. This relates to #3292
    [~BUGFIX] Fluid(ViewHelpers): Email addresses are now prepend with "mailto:" in view helper (BE mode)
    [+TASK] Fluid(ViewHelpers): uri.resource view helper now prepends "../" to relative URIs in BE mode
    [~BUGFIX] Fluid(Tests): Fixed some unit tests so that they run green. We still need more tests and a way to simulate FE mode from phpunit.

commit 9b2830bc1c17588dd69a463773c5f05f61b5cf94
Author: Sebastian Kurfürst <*****>
Date:   Sat Oct 24 11:01:38 2009 +0000

    * A*****@api annotations
    * Changed the fluid-specific RuntimeException to SPL's RuntimeException.

commit 1d36de6ed90007e324b773782e8f0a1d1c1191a2
Author: Bastian Waidelich <*****>
Date:   Tue Jul 13 10:12:30 2010 +0000

    [-TASK] Fluid: R*****@package/@subpackage annotations from all Fluid classes. They have already been removed in FLOW3 packages in r2813.

commit c98945130824aebbdef271d7244aec8cd29c794e
Author: Bastian Waidelich <*****>
Date:   Tue Nov 16 23:49:43 2010 +0000

    [+BUGFIX] Fluid (ViewHelpers): replaced two occurrences of Tx_Extbase_Dispatcher::*() by using the injected ConfigurationManager
    [+TASK] Fluid (ViewHelpers): uri.image now works in BE mode too

commit dd8928aed4c119d8db37322acb91ded24ba5cc35
Author: Bastian Waidelich <*****>
Date:   Thu Dec 30 16:21:11 2010 +0000

    [+TASK] Fluid (ViewHelpers): Fix, cleanup and extend inline documentation of ViewHelpers
    Resolves #10908

commit fd09d197fa8886b97cb20aa9573f39cd08ce989e
Author: Bastian Waidelich <*****>
Date:   Thu Nov 10 18:27:58 2011 +0100

    [TASK] S*****@author annotations
    This backports three recent changes of the TYPO3.Fluid package:
    - R*****@license annotation from files (290f4f5)
    - Simplify license header in PHP files (14bacba)
    - D*****@author tags from source code (9c2e837)
    This should not contain any functional change!
    Change-Id: I9376dca4af78c4f0f82413011d115b8ad04634dd

commit ca40f8a066da4ea3c849d74f68a9bc73758976c5
Author: dkd-egerer Sascha Egerer <*****>
Date:   Sat Apr 14 21:43:10 2012 +0200

    [TASK] Remove trailing whitespace
    There must be no empty lines after the closing
    PHP tag. Empty lines after closing tags break
    output compression in PHP and/or result in AJAX
    Change-Id: I0484ca29d8134d0828cf30880d5aafd43ed9d78e
    Resolves: #36076
    Releases: 6.0
    Reviewed-by: Ingo Pfennigstorf
    Tested-by: Ingo Pfennigstorf
    Reviewed-by: Daniel Lorenz
    Tested-by: Daniel Lorenz
    Reviewed-by: Christian Kuhn
    Tested-by: Christian Kuhn

commit ec3891d8d4e339d8319428211207e6201be9fd73
Author: Thomas Maroschik <*****>
Date:   Wed Oct 17 21:18:26 2012 +0200

    [TASK][WIP] Move non class code back to source files
    Change-Id: I620d2e61860142cdc89cc83474c95542799961c0

commit 554e8f890dcc0dd86a27518b58e2b54be26fd37e
Author: Thomas Maroschik <*****>
Date:   Wed Oct 17 22:20:17 2012 +0200

    [TASK] Namespace classes
    Change-Id: Ia7432e1c923826ed58206bca15fb94509adbd508

commit 02db0d4bb0ade04b6b640aeb672d39edfae13b67
Author: Christian Kuhn <*****>
Date:   Sun Aug 26 14:37:49 2012 +0200

    [BUGFIX] TableListViewHelper fatal
    Namespace declaration is at wrong position
    Change-Id: Ifd3c9091b835a528bd254d8d2970e12f2efe7120
    Resolves: #40228
    Related: #40095
    Releases: 6.0
    Reviewed-by: Christian Kuhn
    Tested-by: Christian Kuhn

commit 9d13dedf017b614b834261b1bf5d4acb2201f1d4
Author: Alexander Schnitzler <*****>
Date:   Fri Nov 16 19:49:02 2012 +0100

    [CLEANUP] Replace FLOW3 with TYPO3 Flow
    Releases: 6.0
    Fixes: #43036
    Change-Id: I62df23587301b4cde3ddeae3686b34f54fe1182e
    Reviewed-by: Alexander Schnitzler
    Tested-by: Alexander Schnitzler

commit 9d46e6932d35c79bf87c96fa38b8e537c4192f23
Author: Alexander Schnitzler <*****>
Date:   Tue Nov 20 16:27:02 2012 +0100

    [CLEANUP] Adjust code to CGL and fix small namespace bugs
    * whitespaces, tabs and blank line issues
    * bool -> boolean
    * int -> integer
    * fix wrong namespace annotations
    Fixes: #43157
    Releases: 6.0
    Change-Id: I8397948e19248db029d8efd1555ee56e4982742d
    Reviewed-by: Helmut Hummel
    Tested-by: Helmut Hummel

commit 3355f39561b079433387ca7b34f6210902bc8601
Author: Christian Kuhn <*****>
Date:   Thu Apr 11 19:54:03 2013 +0200

    [TASK] Update t3lib mentions
    Some core parts still mention t3lib classes after namespaces,
    mostly in comments.
    Related: #47138
    Releases: 6.1
    Change-Id: I6e732159f92fb539462eba93f8578d90be097327
    Reviewed-by: Anja Leichsenring
    Tested-by: Anja Leichsenring

commit 5568148f834af25d6f5a485002a9865d64d7ddb6
Author: Stefan Neufeind <*****>
Date:   Sun Apr 14 00:20:36 2013 +0200

    [TASK] Add namespaing to ConfigurationManagerInterface
    Resolves: #47201
    Releases: 6.0, 6.1
    Change-Id: I5098a63e9cad8848e2c14da9d9e99de6885d45e9
    Reviewed-by: Thomas Maroschik
    Tested-by: Thomas Maroschik
    Reviewed-by: Wouter Wolters
    Tested-by: Wouter Wolters

commit 77f29a3c69a7cbb27b34072754aa503bace6c9f1
Author: Christian Kuhn <*****>
Date:   Tue Oct 1 14:40:56 2013 +0200

    [TASK] Remove closing PHP tags
    Change-Id: Iaa92566c53301e49396fc9fb26b0b339c48d567b
    Resolves: #52360
    Releases: 6.2
    Reviewed-by: Christian Kuhn
    Tested-by: Christian Kuhn
    Reviewed-by: Ernesto Baschny
    Tested-by: Ernesto Baschny
    Reviewed-by: Anja Leichsenring
    Tested-by: Anja Leichsenring

commit e316f7cd6dc115103bfab9336fd48fe0e97af680
Author: Stefan Froemken <*****>
Date:   Tue Sep 17 10:59:14 2013 +0200

    [TASK] Change injectMethods to annotations
    Change injectMethods as already done in extbase
    to inject annotations
    Resolves: #52040
    Releases: 6.2
    Change-Id: I1e4ba873981c4692cc0b3d867bd3756934661a90
    Reviewed-by: Stefan Neufeind
    Tested-by: Stefan Neufeind
    Reviewed-by: Markus Klein
    Tested-by: Markus Klein

commit 9646d26bac991dd23b5d58e7b85ab72d7a4af870
Author: Jo Hasenau <*****>
Date:   Sat Feb 1 21:49:09 2014 +0100

    [TASK] Use (int) instead of intval() or (integer)
    This patch replaces most of around 1600 occurrences of
    intval() and every (integer) in the whole core.
    Additionally it changes GeneralUtility::intExplode to use references
    and typecasting as well.
    Some occurrences of strstr() together with intval() have been replaced
    with strpos() as well.
    And some superfluous intval calls have been removed or reduced
    to a single one i.e. for protected variables or before loops.
    Patch updated after Core CGL decision from 30.01.2014
    Resolves: #54265
    Releases: 6.2
    Change-Id: Iba57ffad1f4233ffa1a9f7d3ca5bfe9d2b53f1e8
    Reviewed-by: Stefan Neufeind
    Tested-by: Stefan Neufeind