Version 1

[yaffs-website] / web / modules / contrib / entity_browser / js / entity_browser.common.js

diff --git a/web/modules/contrib/entity_browser/js/entity_browser.common.js b/web/modules/contrib/entity_browser/js/entity_browser.common.js
new file mode 100644 (file)
index 0000000..d28e176
--- /dev/null
+++ b/web/modules/contrib/entity_browser/js/entity_browser.common.js
@@ -0,0 +1,146 @@
+/**
+ * @file entity_browser.common.js
+ *
+ * Common helper functions used by various parts of entity browser.
+ */
+
+(function ($, Drupal, drupalSettings) {
+
+  'use strict';
+
+  Drupal.entityBrowser = {};
+
+  /**
+   * Command to refresh an entity_browser_entity_reference field widget.
+   *
+   * @param {Drupal.Ajax} [ajax]
+   *   The ajax object.
+   * @param {object} response
+   *   Object holding the server response.
+   * @param {string} response.details_id
+   *   The ID for the details element.
+   * @param {number} [status]
+   *   The HTTP status code.
+   */
+  Drupal.AjaxCommands.prototype.entity_browser_value_updated = function (ajax, response, status) {
+    $('#' + response.details_id)
+      .find('input[type="hidden"][name$="[target_id]"]')
+      .trigger('entity_browser_value_updated');
+  };
+
+  /**
+   * Reacts on "entities selected" event.
+   *
+   * @param {object} event
+   *   Event object.
+   * @param {string} uuid
+   *   Entity browser UUID.
+   * @param {array} entities
+   *   Array of selected entities.
+   */
+  Drupal.entityBrowser.selectionCompleted = function (event, uuid, entities) {
+    var selected_entities = $.map(entities, function (item) {
+      return item[2] + ':' + item[0];
+    });
+    // @todo Use uuid here. But for this to work we need to move eb uuid
+    // generation from display to eb directly. When we do this, we can change
+    // \Drupal\entity_browser\Plugin\Field\FieldWidget\EntityReferenceBrowserWidget::formElement
+    // also.
+    // Checking if cardinality is set - assume unlimited.
+    var cardinality = isNaN(parseInt(drupalSettings['entity_browser'][uuid]['cardinality'])) ? -1 : parseInt(drupalSettings['entity_browser'][uuid]['cardinality']);
+
+    // Get field widget selection mode.
+    var selection_mode = drupalSettings['entity_browser'][uuid]['selection_mode'];
+
+    // Update value form element with new entity IDs.
+    var selector = drupalSettings['entity_browser'][uuid]['selector'] ? $(drupalSettings['entity_browser'][uuid]['selector']) : $(this).parent().parent().find('input[type*=hidden]');
+    var entity_ids = selector.val();
+    var existing_entities = (entity_ids.length !== 0) ? entity_ids.split(' ') : [];
+
+    entity_ids = Drupal.entityBrowser.updateEntityIds(
+      existing_entities,
+      selected_entities,
+      selection_mode,
+      cardinality
+    );
+
+    selector.val(entity_ids);
+    selector.trigger('entity_browser_value_updated');
+  };
+
+  /**
+   * Updates the list of selected entities.
+   *
+   * It uses existing selection and selected entities in entity browser. Also
+   * considers cardinality and used selection mode.
+   *
+   * Note: Selection modes are defined in EntityBrowserElement class and same
+   * options should be used here to determine what action will be performed.
+   * Default action is append ('selection_append').
+   *
+   * @param {Array} existing_entities
+   *   List of existing entity IDs.
+   * @param {Array} selected_entities
+   *   The entities that are selected and entity browser.
+   * @param {string} selection_mode
+   *   Selection mode defined by entity browser field widget.
+   * @param {int} cardinality
+   *   The maximal amount of items the field can store.
+   *
+   * @return {string}
+   *   List of entities as a string, separated by space.
+   */
+  Drupal.entityBrowser.updateEntityIds = function (existing_entities, selected_entities, selection_mode, cardinality) {
+    var combined_entities;
+
+    if (selection_mode === 'selection_edit') {
+      // Propagate new selected entities.
+      combined_entities = selected_entities;
+    }
+    else if (selection_mode === 'selection_prepend') {
+      // Prepend selected entities to existing list of entities.
+      combined_entities = selected_entities.concat(existing_entities);
+    }
+    else {
+      // Append selected entities to existing list of entities.
+      combined_entities = existing_entities.concat(selected_entities);
+    }
+
+    // Having more elements than cardinality should never happen, because
+    // server side authentication should prevent it, but we handle it here
+    // anyway.
+    if (cardinality > 0 && combined_entities.length > cardinality) {
+      combined_entities = combined_entities.slice(0, cardinality);
+    }
+
+    return combined_entities.join(' ');
+  };
+
+  /**
+   * Reacts on "entities selected" event.
+   *
+   * @param {object} element
+   *   Element to bind on.
+   * @param {array} callbacks
+   *   List of callbacks.
+   * @param {string} event_name
+   *   Name of event to bind to.
+   */
+  Drupal.entityBrowser.registerJsCallbacks = function (element, callbacks, event_name) {
+    // JS callbacks are registred as strings. We need to split their names and
+    // find actual functions.
+    for (var i = 0; i < callbacks.length; i++) {
+      var callback = callbacks[i].split('.');
+      var fn = window;
+
+      for (var j = 0; j < callback.length; j++) {
+        fn = fn[callback[j]];
+      }
+
+      if (typeof fn === 'function') {
+        $(element).bind(event_name, fn);
+      }
+    }
+  };
+
+}(jQuery, Drupal, drupalSettings));