[BUGFIX] Fix PageTS config example of CKEditor RTE
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.6 / Breaking-79196-ToolbarItemEventHandlingChanged.rst
1 .. include:: ../../Includes.txt
2
3 ======================================================
4 Breaking: #79196 - Toolbar item event handling changed
5 ======================================================
6
7 See :issue:`79196`
8
9 Description
10 ===========
11
12 With the introduction of the topbar reloading mechanism, the event handling of toolbar items has changed. Reason is
13 that the event information gets lost, as the whole topbar is rendered from scratch after a reload.
14
15
16 Impact
17 ======
18
19 After reloading the topbar, non-migrated events will not get triggered anymore.
20
21
22 Affected Installations
23 ======================
24
25 All installations with old-fashioned toolbar item registrations.
26
27
28 Migration
29 =========
30
31 In most cases it's sufficient to replace the register function with `Viewport.Topbar.Toolbar.registerEvent()`.
32
33 Example:
34
35 .. code-block:: javascript
36
37         define(['jquery', 'TYPO3/CMS/Backend/Viewport'], function($, Viewport) {
38                 // old registration
39                 $(MyAwesomeItem.doStuff)
40
41                 // new registration
42                 Viewport.Topbar.Toolbar.registerEvent(MyAwesomeItem.doStuff);
43         });
44
45 .. index:: Backend, JavaScript