Issue #3277311 by nod_, Wim Leers, catch, larowlan: Deprecate and mark internal contextual JS API (68f22f8d) · Commits · project / drupal

core/modules/contextual/js/contextual.es6.js

+24 −5

Original line number	Diff line number	Diff line
		@@ -132,11 +132,19 @@
		contextual.collection.add(model);

		// Let other JavaScript react to the adding of a new contextual link.
		$(document).trigger('drupalContextualLinkAdded', {
		$(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,

+9 −5

Original line number	Diff line number	Diff line
		@@ -84,11 +84,15 @@
		model
		}, options)));
		contextual.collection.add(model);
		$(document).trigger('drupalContextualLinkAdded', {
		$(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);
		}

+5 −0

Original line number	Diff line number	Diff line
		@@ -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,
		};

+3 −0

Original line number	Diff line number	Diff line
		@@ -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# */ {

+4 −0

Original line number	Diff line number	Diff line
		@@ -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# */ {
		/**