Issue Bug Closed

#107410Custom link browser tutorial should use "backend.form" tag in Configuration/JavaScriptModules.php

Leonie Philine 09/08/25, 13:07 updated 09/08/25, 16:12

Description

The example does not use any tags:

https://docs.typo3.org/m/typo3/reference-coreapi/12.4/en-us/ApiOverview/LinkHandling/Tutorials/CustomLinkBrowser.html#tutorial-backend-link-handler-javascript

The example repository uses the "backend.contextmenu" tag, since the repository also contains a context menu handler. But it does not use "backend.form", either:

https://github.com/TYPO3-Documentation/t3docs-examples/blob/1631a33bfe7c07e543ebb48c13baf77a7e4c0b6e/Configuration/JavaScriptModules.php

Tag "backend.form" should be necessary since this changelog entry:

https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/12.2/Important-99490-ProvideTagToAddJavaScriptModulesToImportmapInBackendForm.html#important-99490-provide-tag-to-add-javascript-modules-to-importmap-in-backend-form

Following the tutorial, setting up Configuration/JavaScriptModules.php without "backend.form" tag (as documented), yields this JavaScript error:

Uncaught (in promise) Error: Unable to resolve specifier '@<vendor>/<package>/<JS file path>'

However, adding the "backend.form" tag to the javascript modules declaration fixes this issue.

There is a number of issues which were closed with issue authors adding "backend.form" to their javascript module tags:

Only the documentation seems to need to be updated.

Reviews 0

No change resolves or names this issue in its commit message, and no comment links one.