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.

History 3

  1. Garvin Hicking commented and changed status New Needs Feedback <span data-processor="relativetime" data-value="2025-09-08T14:43:17+00:00" > 09/08/25, 14:43 </span>

    Hi!

    Thank you! This documentation is part of the Documentation effort and hosted on GitHub. There’s a link “Give feedback” for these pages where you could create a GitHub issue with this.

    Would you like to do this (so you are properly attributed) or should I copy+paste your report there?

    Thanks,
    Garvin

  2. Garvin Hicking commented and changed status Needs Feedback Closed <span data-processor="relativetime" data-value="2025-09-08T16:12:55+00:00" > 09/08/25, 16:12 </span>

    Thanks so much! We’ll adress it “over there”!