Files
cms-core/Documentation/Changelog/11.3/Deprecation-94058-JavaScriptGoToModule.rst
T

64 lines
1.5 KiB
ReStructuredText

.. include:: /Includes.rst.txt
.. _deprecation-94058:
=============================================
Deprecation: #94058 - JavaScript goToModule()
=============================================
See :issue:`94058`
Description
===========
One of the most prominent inline JavaScript functions
:js:`goToModule()` has been deprecated in favor of a streamlined
ActionHandler API for JavaScript.
Impact
======
When using the internal backend module entry objects via `setOnClick` and
`getOnClick` methods, PHP deprecation warnings are now triggered.
Affected Installations
======================
TYPO3 installations with custom extensions referencing these methods.
Migration
=========
Use the following HTML code to replace the inline :js:`goToModule()`
call to for example link to the page module:
.. code-block:: html
<a href="#"
data-dispatch-action="TYPO3.ModuleMenu.showModule"
data-dispatch-args-list="web_layout"
>
Go to page module
</a>
Inside actual JavaScript code, you can replace calls to :js:`goToModule()`
(or :js:`top.goToModule()`) like this:
.. code-block:: js
:caption: Example for TYPO3 v12+
// Utilize imports rather than straight usage of TYPO3.ModuleMenu.App.showModule()
import ModuleMenu from '@typo3/backend/module-menu.js';
ModuleMenu.App.showModule('web_layout')
.. code-block:: js
:caption: Example for TYPO3 v11
TYPO3.ModuleMenu.App.showModule('web_layout')
.. index:: JavaScript, FullyScanned, ext:backend