Issue Bug Closed

#109394RecordLinkHandler::render() missing @typo3/backend/recordlist.js causes link browser to reload when expanding/collapsing record tables

Christoph Erdmann 03/27/26, 07:29 updated 04/21/26, 11:30

Description

Description

RecordLinkHandler::render() does not load @typo3/backend/recordlist.js. This module is responsible for the collapse/expand toggle behavior of record tables in the list view (typo3/cms-backend/Resources/Public/JavaScript/recordlist.js). Without it, clicking the collapse/expand icon on a record table header in the link browser does not toggle the table locally — instead it triggers a full reload of the link browser iframe.

Steps to reproduce

1. Open the TYPO3 backend and open any RTE or link field.
2. Open the link browser.
3. Navigate to a tab that uses a RecordLinkHandler (configured via page TSconfig TCEMAIN.linkHandler).
4. Make sure at least one record table with multiple entries is displayed.
5. Click the collapse icon on the record table header to fold it.
6. Observe: instead of collapsing the table inline, the entire link browser reloads.

Expected behavior

The record table collapses/expands inline without a page reload, identical to the behavior in the regular list module (web > List).

Actual behavior

Clicking the collapse icon triggers a full reload of the link browser.

Root cause

RecordLinkHandler::render() loads these JS modules (lines 148–152):

$this->pageRenderer->loadJavaScriptModule('@typo3/backend/record-link-handler.js'); 
$this->pageRenderer->loadJavaScriptModule('@typo3/backend/record-search.js'); 
$this->pageRenderer->loadJavaScriptModule('@typo3/backend/viewport/resizable-navigation.js'); 
$this->pageRenderer->loadJavaScriptModule('@typo3/backend/column-selector-button.js'); 
$this->pageRenderer->loadJavaScriptModule('@typo3/backend/tree/page-browser.js');

@typo3/backend/recordlist.js is missing. This module registers the event listener that handles the collapse/expand toggle client-side. Without it, the collapse icon’s default link behavior is not suppressed and the browser follows the href, reloading the link browser.

Proposed fix

Add the missing module load in RecordLinkHandler::render():

$this->pageRenderer->loadJavaScriptModule(‘@typo3/backend/recordlist.js’);

This resolves the issue. We confirmed the fix in a custom RecordLinkHandler subclass by adding the same call.

File: typo3/cms-backend/Classes/LinkHandler/RecordLinkHandler.php, method render(), after line 152.

Reviews 2

History 24

  1. Georg Ringer commented and changed status Under Review Resolved done 0 % 100 % <span data-processor="relativetime" data-value="2026-04-02T07:35:10+00:00" > 04/02/26, 07:35 </span>

    Applied in changeset commit:18beb8555306a743c68c2a30208daa0b73cf8d1d.