diff --git a/core/modules/contextual/js/contextual.es6.js b/core/modules/contextual/js/contextual.es6.js index 1054b1ee78..b5fe7d094f 100644 --- a/core/modules/contextual/js/contextual.es6.js +++ b/core/modules/contextual/js/contextual.es6.js @@ -132,11 +132,19 @@ contextual.collection.add(model); // Let other JavaScript react to the adding of a new contextual link. - $(document).trigger('drupalContextualLinkAdded', { - $el: $contextual, - $region, - model, - }); + $(document).trigger( + 'drupalContextualLinkAdded', + Drupal.deprecatedProperty({ + target: { + $el: $contextual, + $region, + model, + }, + deprecatedProperty: 'model', + message: + 'The model property is deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no replacement.', + }), + ); // Fix visual collisions between contextual link triggers. adjustIfNestedAndOverlapping($contextual); @@ -240,6 +248,8 @@ * Namespace for contextual related functionality. * * @namespace + * + * @private */ Drupal.contextual = { /** @@ -247,6 +257,9 @@ * element of contextual links. * * @type {Array} + * + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. */ views: [], @@ -255,6 +268,9 @@ * contextual region element. * * @type {Array} + * + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. */ regionViews: [], }; @@ -263,6 +279,9 @@ * A Backbone.Collection of {@link Drupal.contextual.StateModel} instances. * * @type {Backbone.Collection} + * + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. */ Drupal.contextual.collection = new Backbone.Collection([], { model: Drupal.contextual.StateModel, diff --git a/core/modules/contextual/js/contextual.js b/core/modules/contextual/js/contextual.js index 7ef4bc9ec5..f4abf7ec15 100644 --- a/core/modules/contextual/js/contextual.js +++ b/core/modules/contextual/js/contextual.js @@ -84,11 +84,15 @@ model }, options))); contextual.collection.add(model); - $(document).trigger('drupalContextualLinkAdded', { - $el: $contextual, - $region, - model - }); + $(document).trigger('drupalContextualLinkAdded', Drupal.deprecatedProperty({ + target: { + $el: $contextual, + $region, + model + }, + deprecatedProperty: 'model', + message: 'The model property is deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no replacement.' + })); adjustIfNestedAndOverlapping($contextual); } diff --git a/core/modules/contextual/js/contextual.toolbar.es6.js b/core/modules/contextual/js/contextual.toolbar.es6.js index 79ed6cd8df..2cbac3e139 100644 --- a/core/modules/contextual/js/contextual.toolbar.es6.js +++ b/core/modules/contextual/js/contextual.toolbar.es6.js @@ -69,12 +69,17 @@ * Namespace for the contextual toolbar. * * @namespace + * + * @private */ Drupal.contextualToolbar = { /** * The {@link Drupal.contextualToolbar.StateModel} instance. * * @type {?Drupal.contextualToolbar.StateModel} + * + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is + * no replacement. */ model: null, }; diff --git a/core/modules/contextual/js/models/StateModel.es6.js b/core/modules/contextual/js/models/StateModel.es6.js index 1369bf52fa..09fe8ed4ee 100644 --- a/core/modules/contextual/js/models/StateModel.es6.js +++ b/core/modules/contextual/js/models/StateModel.es6.js @@ -10,6 +10,9 @@ * @constructor * * @augments Backbone.Model + * + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. */ Drupal.contextual.StateModel = Backbone.Model.extend( /** @lends Drupal.contextual.StateModel# */ { diff --git a/core/modules/contextual/js/toolbar/models/StateModel.es6.js b/core/modules/contextual/js/toolbar/models/StateModel.es6.js index ca10e080aa..07ab5dba47 100644 --- a/core/modules/contextual/js/toolbar/models/StateModel.es6.js +++ b/core/modules/contextual/js/toolbar/models/StateModel.es6.js @@ -4,6 +4,10 @@ */ (function (Drupal, Backbone) { + /** + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. + */ Drupal.contextualToolbar.StateModel = Backbone.Model.extend( /** @lends Drupal.contextualToolbar.StateModel# */ { /** diff --git a/core/modules/contextual/js/toolbar/views/AuralView.es6.js b/core/modules/contextual/js/toolbar/views/AuralView.es6.js index 97d2327a90..45449de62b 100644 --- a/core/modules/contextual/js/toolbar/views/AuralView.es6.js +++ b/core/modules/contextual/js/toolbar/views/AuralView.es6.js @@ -4,6 +4,10 @@ */ (function ($, Drupal, Backbone, _) { + /** + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. + */ Drupal.contextualToolbar.AuralView = Backbone.View.extend( /** @lends Drupal.contextualToolbar.AuralView# */ { /** diff --git a/core/modules/contextual/js/toolbar/views/VisualView.es6.js b/core/modules/contextual/js/toolbar/views/VisualView.es6.js index d5c5b32663..b939af8b25 100644 --- a/core/modules/contextual/js/toolbar/views/VisualView.es6.js +++ b/core/modules/contextual/js/toolbar/views/VisualView.es6.js @@ -4,6 +4,10 @@ */ (function (Drupal, Backbone) { + /** + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. + */ Drupal.contextualToolbar.VisualView = Backbone.View.extend( /** @lends Drupal.contextualToolbar.VisualView# */ { /** diff --git a/core/modules/contextual/js/views/AuralView.es6.js b/core/modules/contextual/js/views/AuralView.es6.js index a0da0fb572..1e317242c1 100644 --- a/core/modules/contextual/js/views/AuralView.es6.js +++ b/core/modules/contextual/js/views/AuralView.es6.js @@ -4,6 +4,10 @@ */ (function (Drupal, Backbone) { + /** + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. + */ Drupal.contextual.AuralView = Backbone.View.extend( /** @lends Drupal.contextual.AuralView# */ { /** diff --git a/core/modules/contextual/js/views/KeyboardView.es6.js b/core/modules/contextual/js/views/KeyboardView.es6.js index cbb0ef9e2f..d7bb101835 100644 --- a/core/modules/contextual/js/views/KeyboardView.es6.js +++ b/core/modules/contextual/js/views/KeyboardView.es6.js @@ -4,6 +4,10 @@ */ (function (Drupal, Backbone) { + /** + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. + */ Drupal.contextual.KeyboardView = Backbone.View.extend( /** @lends Drupal.contextual.KeyboardView# */ { /** diff --git a/core/modules/contextual/js/views/RegionView.es6.js b/core/modules/contextual/js/views/RegionView.es6.js index 74ce6a936c..08ec5880be 100644 --- a/core/modules/contextual/js/views/RegionView.es6.js +++ b/core/modules/contextual/js/views/RegionView.es6.js @@ -4,6 +4,10 @@ */ (function (Drupal, Backbone) { + /** + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. + */ Drupal.contextual.RegionView = Backbone.View.extend( /** @lends Drupal.contextual.RegionView# */ { /** diff --git a/core/modules/contextual/js/views/VisualView.es6.js b/core/modules/contextual/js/views/VisualView.es6.js index c599b988c7..7f984cc817 100644 --- a/core/modules/contextual/js/views/VisualView.es6.js +++ b/core/modules/contextual/js/views/VisualView.es6.js @@ -4,6 +4,10 @@ */ (function (Drupal, Backbone) { + /** + * @deprecated in drupal:9.4.0 and is removed from drupal:10.0.0. There is no + * replacement. + */ Drupal.contextual.VisualView = Backbone.View.extend( /** @lends Drupal.contextual.VisualView# */ { /** diff --git a/core/modules/contextual/src/ContextualController.php b/core/modules/contextual/src/ContextualController.php index 378b5236c4..9713925359 100644 --- a/core/modules/contextual/src/ContextualController.php +++ b/core/modules/contextual/src/ContextualController.php @@ -57,6 +57,8 @@ public static function create(ContainerInterface $container) { * @throws \Symfony\Component\HttpKernel\Exception\BadRequestHttpException * Thrown when the request contains no ids. * + * @internal + * * @see contextual_preprocess() */ public function render(Request $request) {