apex4x/Templates/Comboboxes/Native Inputs, Multiselect Editable with Substring Match/js/setup.js

The Comprehensive ARIA Development Suite

$A.import(["CurrentDevice", "Combobox"], { defer: true }, function () {
  // Create a new ARIA Combobox instance
  var myAuthorCombobox = new $A.Combobox({
    select: $A.get("authors"),
    input: $A.get("authrEdit"),
    delay: 200,
    style: { display: "none" },
    animate: {
      onRender: function (dc, wrapper, next) {
        $A.Velocity(wrapper, "transition.fadeIn", {
          complete: function () {
            // Running next() is required to continue executing built-in lifecycle methods such as afterRender() when the animation completes.
            next();
          },
        });
      },
      onRemove: function (dc, wrapper, next) {
        $A.Velocity(wrapper, "transition.fadeOut", {
          complete: function () {
            // Running next() is required to continue executing built-in lifecycle methods such as afterRender() when the animation completes.
            next();
          },
        });
      },
    },
  });

  // Disable auto population of default value
  myAuthorCombobox.setDefault(false);

  // Use substring match instead of default left-string match
  myAuthorCombobox.setSubstringMatch(true);
  myAuthorCombobox.setCharMin(2);

  // Enable full listbox content browsing from the keyboard when the down arrow key is pressed. (Applicable only when the value is empty.)
  myAuthorCombobox.setShowAllIfEmpty(true);

  // Enable auto saving of checked options, even when typing to narrow the filtered list of options at the same time.
  myAuthorCombobox.setAutoSaveIfChecked(true);

  // Set CSS autopositioning relative to the triggering element.
  // Accepted 4X API values between 0-disabled-default and 12
  myAuthorCombobox.setAutoPosition(5);

  // Set a positive or negative top/left offset to be applied to the autoPosition property calculation
  myAuthorCombobox.setOffset({
    top: 7,
    left: 30,
  });

  // Process every time a new value is saved
  myAuthorCombobox.onSelect(
    function (optionText, selectedOptionNodes, comboboxElement, selectElement) {
      var values = [],
        insertionPoint = $A.get("insertionPoint");
      $A.query(selectedOptionNodes, function (i, o) {
        values.push(o.value);
      });

      if (values.length) {
        insertionPoint.innerHTML =
          "<ul><li>" + values.join("</li><li>") + "</li></ul>";
        $A.announce(insertionPoint, true, true);
      } else insertionPoint.innerHTML = "";

      comboboxElement.value = "";
      // Return the modified value so that the combobox doesn't open again instantly.
      return "";
    },
  );

  // Logic to distinguish between touch screen devices
  if (!$A.isTouch) {
    // For non-touch devices, add screen reader accessible keyboard instructions
    myAuthorCombobox.setPromptText(
      "Type and press the down arrow to browse available matches",
    );
  }

  // Dynamically toggle help text for desktops that support dual touch and keyboard interaction.
  if ($A.device.type === "desktop") {
    $A.on("toggletouch", function (ev) {
      myAuthorCombobox.setPromptText(
        $A.isTouch
          ? ""
          : "First type then press the down arrow to browse available matches",
      );
    });
  }

  // Set a default list option display size for standard screens
  myAuthorCombobox.setSize(
    $A.device.type === "mobile" ? 3 : $A.device.type === "tablet" ? 5 : 7,
  );

  // Get the Close icon triggering element for sighted mouse and touch device users
  var mobileCloseIcon = $A.get("mobileCloseIcon");

  // Process after the suggestion window is opened
  myAuthorCombobox.onOpen(function (dc) {
    $A.remClass(mobileCloseIcon, "hidden");
  });

  // Process after the suggestion window is closed
  myAuthorCombobox.onClose(function (dc) {
    $A.addClass(mobileCloseIcon, "hidden");
  });

  // Add a click handler to the Close icon
  $A.on(mobileCloseIcon, "click", function (ev) {
    myAuthorCombobox.close();
  });

  // Now fire up the newly instantiated ARIA Combobox
  myAuthorCombobox.start();

  $A.on("#clearAll", {
    click: function (ev) {
      // Clear all of the selected options.
      myAuthorCombobox.clearAll();
      $A.get("insertionPoint").innerHTML = "";
      myAuthorCombobox.combobox.focus();
      ev.preventDefault();
    },
  });

  $A.on("#authrBtn", "click", function (ev) {
    var values = [],
      selectedMatches = myAuthorCombobox.getValue();
    $A.query(selectedMatches, function (i, o) {
      values.push(o.value);
    });
    alert(
      "Option nodes selected " +
        selectedMatches.length +
        "\n" +
        "Selected values " +
        values.toString(),
    );
    ev.preventDefault();
  });
});