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,53 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-98168-1660890228:
+
+=========================================================
+Deprecation: #98168 - Binding context menu item to `this`
+=========================================================
+
+See :issue:`98168`
+
+Description
+===========
+
+Due to historical reasons, a context menu item is bound to :js:`this` in its callback action
+which was used to access the context menu item's :js:`dataset`. The invocation of assigned callback actions
+is adapted to pass the :js:`dataset` as the 3rd argument.
+
+Binding the context menu item to :js:`this` in the callback is now marked as deprecated.
+
+Impact
+======
+
+Using :js:`this` in a context menu item callback will trigger a deprecated log entry in the browser's console.
+
+Affected installations
+======================
+
+All extensions providing custom context menu actions are affected.
+
+Migration
+=========
+
+To access data attributes, use the :js:`dataset` argument passed as the 3rd argument in the context menu callback action.
+
+..  code-block:: js
+
+    // Before
+    ContextMenuActions.renameFile(table, uid): void {
+      const actionUrl = $(this).data('action-url');
+      top.TYPO3.Backend.ContentContainer.setUrl(
+        actionUrl + '&target=' + encodeURIComponent(uid) + '&returnUrl=' + ContextMenuActions.getReturnUrl()
+      );
+    }
+
+    // After
+    ContextMenuActions.renameFile(table, uid, dataset): void {
+      const actionUrl = dataset.actionUrl;
+      top.TYPO3.Backend.ContentContainer.setUrl(
+        actionUrl + '&target=' + encodeURIComponent(uid) + '&returnUrl=' + ContextMenuActions.getReturnUrl()
+      );
+    }
+
+.. index:: Backend, JavaScript, NotScanned, ext:backend