TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,47 @@
+.. include:: /Includes.rst.txt
+
+.. _breaking-79196:
+
+======================================================
+Breaking: #79196 - Toolbar item event handling changed
+======================================================
+
+See :issue:`79196`
+
+Description
+===========
+
+With the introduction of the topbar reloading mechanism, the event handling of toolbar items has changed. Reason is
+that the event information gets lost, as the whole topbar is rendered from scratch after a reload.
+
+
+Impact
+======
+
+After reloading the topbar, non-migrated events will not get triggered anymore.
+
+
+Affected Installations
+======================
+
+All installations with old-fashioned toolbar item registrations.
+
+
+Migration
+=========
+
+In most cases it's sufficient to replace the register function with :js:`Viewport.Topbar.Toolbar.registerEvent()`.
+
+Example:
+
+.. code-block:: javascript
+
+	define(['jquery', 'TYPO3/CMS/Backend/Viewport'], function($, Viewport) {
+	   // old registration
+	   MyAwesomeItem.doStuff)
+
+	   // new registration
+	   Viewport.Topbar.Toolbar.registerEvent(MyAwesomeItem.doStuff);
+	});
+
+.. index:: Backend, JavaScript