AddUserSettingsJavaScriptModulesEvent
JavaScript events in custom user settings configuration options should not be placed as inline JavaScript. Instead, use a dedicated JavaScript module to handle custom events.
Example: Load a JavaScript module in the user settings
EXT:my_extension/Classes/UserSettings/EventListener/MyEventListener.php
<?php
declare(strict_types=1);
namespace MyVendor\MyExtension\UserSettings\EventListener;
use TYPO3\CMS\Backend\Event\AddUserSettingsJavaScriptModulesEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;
#[AsEventListener(
identifier: 'my-extension/my-event-listener',
)]
final readonly class MyEventListener
{
public function __invoke(AddUserSettingsJavaScriptModulesEvent $event): void
{
$event->addJavaScriptModule('@my-extension/setupModule/some-file.js');
}
}
API
-
final class
AddUserSettingsJavaScriptModulesEvent -
- Fully qualified name
-
\TYPO3\CMS\ Backend\ Event\ Add User Settings Java Script Modules Event
Collects additional JavaScript modules to be loaded in SetupModuleController (User Settings).
Replacement for prior TYPO3\CMS\Setup\Event\AddJavaScriptModulesEvent.