Merge branch 'feature-theme' into 'develop'

dependency add

See merge request manzarH/dic-global-dev!428

modules/jquery-ui-touch-punch/README.md

+# jQuery UI Touch Punch
+## Touch Event Support for jQuery UI
+
+> **jQuery UI Touch Punch is a small hack that enables the use of touch events on sites using the jQuery UI user interface library.**
+
+_[Visit the official Touch Punch website](http://touchpunch.furf.com)._
+
+Currently, [jQuery UI](http://jqueryui.com/) user interface library does not support the use of touch events in their widgets and interactions. This means that the slick UI you designed and tested in your desktop browser will fail on most, if not all, touch-enabled mobile devices, because jQuery UI listens to mouse events—mouseover, mousemove and mouseout—not touch events—touchstart, touchmove and touchend.
+
+That's where jQuery UI Touch Punch comes in. Touch Punch works by using [simulated events](https://developer.mozilla.org/en/DOM/document.createEvent) to map [touch events](http://www.html5rocks.com/en/mobile/touch/) to their mouse event analogs. Simply include the script on your page and your touch events will be turned into their corresponding mouse events to which jQuery UI will respond as expected.
+
+As I said, Touch Punch is a hack. It [duck punches](http://en.wikipedia.org/wiki/Monkey_patch) some of jQuery UI's core functionality to handle the mapping of touch events. Touch Punch works with all basic implementations of jQuery UI's interactions and widgets. However, you may find more complex cases where Touch Punch fails. If so, scroll down to learn how you can file and/or fix issues.
+
+This code is dual licensed under the MIT or GPL Version 2 licenses and is therefore free to use, modify and/or distribute, but if you include Touch Punch in other software packages or plugins, please include an attribution to the original software and a link to [this Touch Punch website](http://touchpunch.furf.com/).
+
+## Using Touch Punch is as easy as 1, 2…
+
+Just follow these simple steps to enable touch events in your jQuery UI app:
+
+1. Include jQuery and jQuery UI on your page.
+
+    ```html
+    <script src="http://code.jquery.com/jquery.min.js"></script>
+    <script src="http://code.jquery.com/ui/1.8.17/jquery-ui.min.js"></script>
+    ```
+
+2. Include Touch Punch after jQuery UI and before its first use.
+
+    Please note that if you are using jQuery UI's components, Touch Punch must be included after jquery.ui.mouse.js, as Touch Punch modifies its behavior.
+
+    ```html
+    <script src="jquery.ui.touch-punch.min.js"></script>
+    ```
+
+3. There is no 3. Just use jQuery UI as expected and watch it work at the touch of a finger.
+
+    ```html
+    <script>$('#widget').draggable();</script>
+    ```
+
+_Tested on iPad, iPhone, Android and other touch-enabled mobile devices._

modules/jquery-ui-touch-punch/bower.json

+{
+  "name": "jqueryui-touch-punch",
+  "version": "0.2.3",
+  "main": "jquery.ui.touch-punch.min.js",
+  "ignore": [],
+  "dependencies": {
+    "jquery": ">=1.6",
+    "jquery-ui": ">=1.8"
+  }
+}

modules/jquery-ui-touch-punch/jquery.ui.touch-punch.js

+/*!
+ * jQuery UI Touch Punch 0.2.3
+ *
+ * Copyright 2011–2014, Dave Furfero
+ * Dual licensed under the MIT or GPL Version 2 licenses.
+ *
+ * Depends:
+ *  jquery.ui.widget.js
+ *  jquery.ui.mouse.js
+ */
+(function ($) {
+
+  // Detect touch support
+  $.support.touch = 'ontouchend' in document;
+
+  // Ignore browsers without touch support
+  if (!$.support.touch) {
+    return;
+  }
+
+  var mouseProto = $.ui.mouse.prototype,
+      _mouseInit = mouseProto._mouseInit,
+      _mouseDestroy = mouseProto._mouseDestroy,
+      touchHandled;
+
+  /**
+   * Simulate a mouse event based on a corresponding touch event
+   * @param {Object} event A touch event
+   * @param {String} simulatedType The corresponding mouse event
+   */
+  function simulateMouseEvent (event, simulatedType) {
+
+    // Ignore multi-touch events
+    if (event.originalEvent.touches.length > 1) {
+      return;
+    }
+
+    event.preventDefault();
+
+    var touch = event.originalEvent.changedTouches[0],
+        simulatedEvent = document.createEvent('MouseEvents');
+    
+    // Initialize the simulated mouse event using the touch event's coordinates
+    simulatedEvent.initMouseEvent(
+      simulatedType,    // type
+      true,             // bubbles                    
+      true,             // cancelable                 
+      window,           // view                       
+      1,                // detail                     
+      touch.screenX,    // screenX                    
+      touch.screenY,    // screenY                    
+      touch.clientX,    // clientX                    
+      touch.clientY,    // clientY                    
+      false,            // ctrlKey                    
+      false,            // altKey                     
+      false,            // shiftKey                   
+      false,            // metaKey                    
+      0,                // button                     
+      null              // relatedTarget              
+    );
+
+    // Dispatch the simulated event to the target element
+    event.target.dispatchEvent(simulatedEvent);
+  }
+
+  /**
+   * Handle the jQuery UI widget's touchstart events
+   * @param {Object} event The widget element's touchstart event
+   */
+  mouseProto._touchStart = function (event) {
+
+    var self = this;
+
+    // Ignore the event if another widget is already being handled
+    if (touchHandled || !self._mouseCapture(event.originalEvent.changedTouches[0])) {
+      return;
+    }
+
+    // Set the flag to prevent other widgets from inheriting the touch event
+    touchHandled = true;
+
+    // Track movement to determine if interaction was a click
+    self._touchMoved = false;
+
+    // Simulate the mouseover event
+    simulateMouseEvent(event, 'mouseover');
+
+    // Simulate the mousemove event
+    simulateMouseEvent(event, 'mousemove');
+
+    // Simulate the mousedown event
+    simulateMouseEvent(event, 'mousedown');
+  };
+
+  /**
+   * Handle the jQuery UI widget's touchmove events
+   * @param {Object} event The document's touchmove event
+   */
+  mouseProto._touchMove = function (event) {
+
+    // Ignore event if not handled
+    if (!touchHandled) {
+      return;
+    }
+
+    // Interaction was not a click
+    this._touchMoved = true;
+
+    // Simulate the mousemove event
+    simulateMouseEvent(event, 'mousemove');
+  };
+
+  /**
+   * Handle the jQuery UI widget's touchend events
+   * @param {Object} event The document's touchend event
+   */
+  mouseProto._touchEnd = function (event) {
+
+    // Ignore event if not handled
+    if (!touchHandled) {
+      return;
+    }
+
+    // Simulate the mouseup event
+    simulateMouseEvent(event, 'mouseup');
+
+    // Simulate the mouseout event
+    simulateMouseEvent(event, 'mouseout');
+
+    // If the touch interaction did not move, it should trigger a click
+    if (!this._touchMoved) {
+
+      // Simulate the click event
+      simulateMouseEvent(event, 'click');
+    }
+
+    // Unset the flag to allow other widgets to inherit the touch event
+    touchHandled = false;
+  };
+
+  /**
+   * A duck punch of the $.ui.mouse _mouseInit method to support touch events.
+   * This method extends the widget with bound touch event handlers that
+   * translate touch events to mouse events and pass them to the widget's
+   * original mouse event handling methods.
+   */
+  mouseProto._mouseInit = function () {
+    
+    var self = this;
+
+    // Delegate the touch handlers to the widget's element
+    self.element.bind({
+      touchstart: $.proxy(self, '_touchStart'),
+      touchmove: $.proxy(self, '_touchMove'),
+      touchend: $.proxy(self, '_touchEnd')
+    });
+
+    // Call the original $.ui.mouse init method
+    _mouseInit.call(self);
+  };
+
+  /**
+   * Remove the touch event handlers
+   */
+  mouseProto._mouseDestroy = function () {
+    
+    var self = this;
+
+    // Delegate the touch handlers to the widget's element
+    self.element.unbind({
+      touchstart: $.proxy(self, '_touchStart'),
+      touchmove: $.proxy(self, '_touchMove'),
+      touchend: $.proxy(self, '_touchEnd')
+    });
+
+    // Call the original $.ui.mouse destroy method
+    _mouseDestroy.call(self);
+  };
+
+})(jQuery);
\ No newline at end of file

modules/jquery-ui-touch-punch/jquery.ui.touch-punch.min.js

+/*!
+ * jQuery UI Touch Punch 0.2.3
+ *
+ * Copyright 2011–2014, Dave Furfero
+ * Dual licensed under the MIT or GPL Version 2 licenses.
+ *
+ * Depends:
+ *  jquery.ui.widget.js
+ *  jquery.ui.mouse.js
+ */
+!function(a){function f(a,b){if(!(a.originalEvent.touches.length>1)){a.preventDefault();var c=a.originalEvent.changedTouches[0],d=document.createEvent("MouseEvents");d.initMouseEvent(b,!0,!0,window,1,c.screenX,c.screenY,c.clientX,c.clientY,!1,!1,!1,!1,0,null),a.target.dispatchEvent(d)}}if(a.support.touch="ontouchend"in document,a.support.touch){var e,b=a.ui.mouse.prototype,c=b._mouseInit,d=b._mouseDestroy;b._touchStart=function(a){var b=this;!e&&b._mouseCapture(a.originalEvent.changedTouches[0])&&(e=!0,b._touchMoved=!1,f(a,"mouseover"),f(a,"mousemove"),f(a,"mousedown"))},b._touchMove=function(a){e&&(this._touchMoved=!0,f(a,"mousemove"))},b._touchEnd=function(a){e&&(f(a,"mouseup"),f(a,"mouseout"),this._touchMoved||f(a,"click"),e=!1)},b._mouseInit=function(){var b=this;b.element.bind({touchstart:a.proxy(b,"_touchStart"),touchmove:a.proxy(b,"_touchMove"),touchend:a.proxy(b,"_touchEnd")}),c.call(b)},b._mouseDestroy=function(){var b=this;b.element.unbind({touchstart:a.proxy(b,"_touchStart"),touchmove:a.proxy(b,"_touchMove"),touchend:a.proxy(b,"_touchEnd")}),d.call(b)}}}(jQuery);
\ No newline at end of file

modules/jquery_ui_touch_punch/README.md

-# jQuery UI Touch Punch
-
-Drupal 8 includes jQuery UI in core, however it is no longer actively
-maintained and has been marked deprecated. This module provides the
-jQuery UI Touch Punch library for any themes and modules that require it.
-
-  - jQuery UI [Touch Punch documentation](http://touchpunch.furf.com/)
-  - jQuery UI [Touch Punch API
-    documentation](https://github.com/furf/jquery-ui-touch-punch)
-
-**Caution**: jQuery UI was deprecated from core because it is no longer
-actively maintained, and has been marked “End of Life” by the OpenJS
-Foundation. It is not recommended to depend on jQuery UI in your own
-code, and instead to select a replacement solution as soon as possible.
-
-## Instructions
-
-1.  Download this module and the jQuery UI module.
-2.  [Download Jquery Touch Punch](https://github.com/furf/jquery-ui-touch-punch) library and place it in the libraries folder (<drupal root>/libraries). You need the full library which is easily available from the Github repo (the full path to the required js file should be: <drupal root>/libraries/jquery-ui-touch-punch/jquery.ui.touch-punch.min.js).
-3.  Install module the [usual way](https://www.drupal.org/documentation/install/modules-themes/modules-8).
-4.  Change any references in your theme or module from
-    `core/jquery.ui.touch-punch` to `jquery_ui_touch_punch/touch-punch`
-
-### Requirements
-
-  - [jQuery UI](https://www.drupal.org/project/jquery_ui)
-
-### Related modules
-
-  - [jQuery UI Accordion](https://www.drupal.org/project/jquery_ui_accordion)
-  - [jQuery UI Button](https://www.drupal.org/project/jquery_ui_button)
-  - [jQuery UI Checkboxradio](https://www.drupal.org/project/jquery_ui_checkboxradio)
-  - [jQuery UI Controlgroup](https://www.drupal.org/project/jquery_ui_controlgroup)
-  - [jQuery UI Draggable](https://www.drupal.org/project/jquery_ui_draggable)
-  - [jQuery UI Droppable](https://www.drupal.org/project/jquery_ui_droppable)
-  - [jQuery UI Effects](https://www.drupal.org/project/jquery_ui_effects)
-  - [jQuery UI Menu](https://www.drupal.org/project/jquery_ui_menu)
-  - [jQuery UI Progressbar](https://www.drupal.org/project/jquery_ui_progressbar)
-  - [jQuery UI Selectable](https://www.drupal.org/project/jquery_ui_selectable)
-  - [jQuery UI Selectmenu](https://www.drupal.org/project/jquery_ui_selectmenu)
-  - [jQuery UI Slider](https://www.drupal.org/project/jquery_ui_slider)
-  - [jQuery UI Spinner](https://www.drupal.org/project/jquery_ui_spinner)
-  - [jQuery UI DatePicker](https://www.drupal.org/project/jquery_ui_datepicker)

modules/jquery_ui_touch_punch/composer.json

-{
-  "name": "drupal/jquery_ui_touch_punch",
-  "description": "Provides jQuery UI Touch Punch library.",
-  "type": "drupal-module",
-  "homepage": "https://www.drupal.org/project/jquery_ui_touch_punch",
-  "keywords": ["Drupal", "jquery_ui_touch_punch"],
-  "license": "GPL-2.0+",
-  "minimum-stability": "dev",
-  "prefer-stable": true,
-  "support": {
-    "issues": "https://www.drupal.org/project/issues/jquery_ui_touch_punch",
-    "irc": "irc://irc.freenode.org/drupal-contribute",
-    "source": "https://www.drupal.org/project/jquery_ui_touch_punch"
-  },
-  "authors": [
-    {
-      "name": "Naveen Valecha",
-      "homepage": "https://drupal.org/u/naveenvalecha",
-      "role": "Maintainer"
-    }
-  ],
-  "require": {
-    "drupal/jquery_ui": "^1.0"
-  },
-  "suggest": {
-    "furf/jquery-ui-touch-punch": "Required to use drupal/jquery_ui_touch_punch module."
-  }
-}

modules/jquery_ui_touch_punch/jquery_ui_touch_punch.info.yml

-name: jQuery UI Touch Punch
-type: module
-description: 'Provides jQuery UI Touch Punch library.'
-package: jQuery UI
-core_version_requirement: ^8 || ^9
-dependencies:
-  - jquery_ui:jquery_ui
-
-# Information added by Drupal.org packaging script on 2020-06-11
-version: '1.0.0'
-project: 'jquery_ui_touch_punch'
-datestamp: 1591893294

modules/jquery_ui_touch_punch/jquery_ui_touch_punch.install

-<?php
-
-/**
- * @file
- * Install, update and uninstall functions for the jquery_ui_touch_punch module.
- */
-
-/**
- * Implements hook_requirements().
- */
-function jquery_ui_touch_punch_requirements($phase) {
-
-  $requirements = [];
-
-  // @todo Remove this conditional structure in favor of using the libraries
-  // directory file finder service when Drupal 8.9 is the minimum supported
-  // version of core.
-  if (\Drupal::hasService('library.libraries_directory_file_finder')) {
-    /** @var \Drupal\Core\Asset\LibrariesDirectoryFileFinder $library_file_finder */
-    $library_file_finder = \Drupal::service('library.libraries_directory_file_finder');
-    $library_found = (bool) $library_file_finder->find('jquery-ui-touch-punch/jquery.ui.touch-punch.min.js');
-  }
-  else {
-    $path = DRUPAL_ROOT . '/libraries/jquery-ui-touch-punch/jquery.ui.touch-punch.min.js';
-    if (\Drupal::moduleHandler()->moduleExists('libraries')) {
-      $path = libraries_get_path('jquery-ui-touch-punch') . '/jquery.ui.touch-punch.min.js';
-    }
-
-    // Is the library found in the root libraries path.
-    $library_found = file_exists($path);
-
-    // If library is not found, then look in the current profile libraries path.
-    if (!$library_found) {
-      $profile_path = drupal_get_path('profile', \Drupal::installProfile());
-      $profile_path .= '/libraries/jquery-ui-touch-punch/jquery.ui.touch-punch.min.js';
-      // Is the library found in the current profile libraries path.
-      $library_found = file_exists($profile_path);
-    }
-  }
-
-  if (!$library_found) {
-    $requirements['jquery_ui_touch_punch_library'] = [
-      'title' => t('jQuery UI Touch Punch library missing'),
-      'description' => t('jQuery UI Touch Punch requires the jquery.ui.touch-punch.min.js library.
-        Download it (https://github.com/furf/jquery-ui-touch-punch) and place it in the
-        libraries folder (/libraries)'),
-      'severity' => REQUIREMENT_ERROR,
-    ];
-  }
-
-  return $requirements;
-}

modules/jquery_ui_touch_punch/jquery_ui_touch_punch.libraries.yml

-touch-punch:
-  title: 'jQuery Touch Punch'
-  website: https://github.com/furf/jquery-ui-touch-punch
-  version: 0.0
-  js:
-    /libraries/jquery-ui-touch-punch/jquery.ui.touch-punch.min.js: { minified: true }
-  dependencies:
-    - jquery_ui/core

modules/jquery_ui_touch_punch/jquery_ui_touch_punch.module

-<?php
-
-/**
- * @file
- * Contains jquery_ui_touch_punch.module.
- */
-
-use Drupal\Core\Routing\RouteMatchInterface;
-
-/**
- * Implements hook_help().
- */
-function jquery_ui_touch_punch_help($route_name, RouteMatchInterface $route_match) {
-  switch ($route_name) {
-    case 'help.page.jquery_ui_touch_punch':
-      $output = '<h3>' . t('About') . '</h3>';
-      $output .= '<p>' . t('Drupal 8 includes jQuery UI in core, however it is no longer actively maintained and has been marked deprecated. This module provides the jQuery UI Touch Punch library for any themes and modules that require it.') . '</p>';
-      $output .= '<p>' . t('For more information about the deprecation of jQuery UI, see this <a href=":change-record">change record</a>', [':change-record' => 'https://www.drupal.org/node/3067969']) . '</p>';
-      $output .= '<p>' . t('Visit the <a href=":project_link">jQuery UI Touch Punch project page</a> on Drupal.org for more information on this module.', [':project_link' => 'https://www.drupal.org/project/jquery_ui_touch_punch']) . '</p>';
-
-      return $output;
-  }
-}