@esri/calcite-components 1.0.0-beta.79 → 1.0.0-beta.82

package/dist/collection/components/input/input.js

@@ -1,16 +1,17 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
+ * v1.0.0-beta.82
  */
 import { Component, Element, Event, h, Host, Method, Prop, State, Watch } from "@stencil/core";
 import { getElementDir, getElementProp, getSlotted, setRequestedIcon } from "../../utils/dom";
-import { CSS, INPUT_TYPE_ICONS, SLOTS } from "./resources";
+import { CSS, INPUT_TYPE_ICONS, SLOTS, TEXT } from "./resources";
 import { connectLabel, disconnectLabel, getLabelText } from "../../utils/label";
-import { connectForm, disconnectForm, HiddenFormInputSlot } from "../../utils/form";
+import { connectForm, disconnectForm, HiddenFormInputSlot, submitForm } from "../../utils/form";
 import { getDecimalSeparator, delocalizeNumberString, localizeNumberString } from "../../utils/locale";
 import { numberKeys } from "../../utils/key";
 import { isValidNumber, parseNumberString, sanitizeNumberString } from "../../utils/number";
-import { CSS_UTILITY, TEXT } from "../../utils/resources";
+import { CSS_UTILITY, TEXT as COMMON_TEXT } from "../../utils/resources";
 import { decimalPlaces } from "../../utils/math";
 import { createObserver } from "../../utils/observers";
 import { updateHostInteraction } from "../../utils/interactive";
@@ -42,7 +43,7 @@ export class Input {
      * string to override English loading text
      * @default "Loading"
      */
-    this.intlLoading = TEXT.loading;
+    this.intlLoading = COMMON_TEXT.loading;
     /** flip the icon in rtl */
     this.iconFlipRtl = false;
     /** specify if the input is in loading state */
@@ -76,19 +77,15 @@ export class Input {
     this.value = "";
     /** keep track of the rendered child type */
     this.childElType = "input";
-    /** whether the value of the input was changed as a result of user typing or not */
-    this.internalValueChange = false;
+    this.previousValueOrigin = "initial";
     this.mutationObserver = createObserver("mutation", () => this.setDisabledAction());
+    this.userChangedValue = false;
     //--------------------------------------------------------------------------
     //
     //  Private Methods
     //
     //--------------------------------------------------------------------------
     this.keyDownHandler = (event) => {
-      /* prevent default behavior for input to move the cursor to the beginning of the input with every ArrowUp press */
-      if (event.key === "ArrowUp") {
-        event.preventDefault();
-      }
       if (this.readOnly || this.disabled) {
         return;
       }
@@ -96,25 +93,30 @@ export class Input {
         this.clearInputValue(event);
         event.preventDefault();
       }
+      if (event.key === "Enter" && !event.defaultPrevented) {
+        submitForm(this);
+      }
     };
     this.clearInputValue = (nativeEvent) => {
       this.setValue({
         committing: true,
         nativeEvent,
+        origin: "user",
         value: ""
       });
     };
-    this.inputBlurHandler = () => {
-      if (this.type === "number") {
-        this.setValue({ value: this.value });
+    this.emitChangeIfUserModified = () => {
+      if (this.previousValueOrigin === "user" && this.value !== this.previousEmittedValue) {
+        this.calciteInputChange.emit();
       }
+      this.previousEmittedValue = this.value;
+    };
+    this.inputBlurHandler = () => {
       this.calciteInputBlur.emit({
         element: this.childEl,
         value: this.value
       });
-      if (this.preFocusValue !== this.value) {
-        this.calciteInputChange.emit();
-      }
+      this.emitChangeIfUserModified();
     };
     this.inputFocusHandler = (event) => {
       const slottedActionEl = getSlotted(this.el, "action");
@@ -125,7 +127,6 @@ export class Input {
         element: this.childEl,
         value: this.value
       });
-      this.preFocusValue = this.value;
     };
     this.inputInputHandler = (nativeEvent) => {
       if (this.disabled || this.readOnly) {
@@ -133,6 +134,7 @@ export class Input {
       }
       this.setValue({
         nativeEvent,
+        origin: "user",
         value: nativeEvent.target.value
       });
     };
@@ -141,7 +143,7 @@ export class Input {
         return;
       }
       if (event.key === "Enter") {
-        this.calciteInputChange.emit();
+        this.emitChangeIfUserModified();
       }
     };
     this.inputNumberInputHandler = (nativeEvent) => {
@@ -156,6 +158,7 @@ export class Input {
         }
         this.setValue({
           nativeEvent,
+          origin: "user",
           value: parseNumberString(delocalizedValue)
         });
         this.childNumberEl.value = this.localizedValue;
@@ -163,7 +166,8 @@ export class Input {
       else {
         this.setValue({
           nativeEvent,
-          value: delocalizeNumberString(value, this.locale)
+          origin: "user",
+          value: delocalizedValue
         });
       }
     };
@@ -172,6 +176,8 @@ export class Input {
         return;
       }
       if (event.key === "ArrowUp") {
+        /* prevent default behavior of moving cursor to the beginning of the input when holding down ArrowUp */
+        event.preventDefault();
         this.nudgeNumberValue("up", event);
         return;
       }
@@ -195,7 +201,7 @@ export class Input {
       const isShiftTabEvent = event.shiftKey && event.key === "Tab";
       if (supportedKeys.includes(event.key) && (!event.shiftKey || isShiftTabEvent)) {
         if (event.key === "Enter") {
-          this.calciteInputChange.emit();
+          this.emitChangeIfUserModified();
         }
         return;
       }
@@ -269,6 +275,14 @@ export class Input {
       }
       this[`child${this.type === "number" ? "Number" : ""}El`].value = newInputValue;
     };
+    this.setPreviousEmittedValue = (newPreviousEmittedValue) => {
+      this.previousEmittedValue =
+        this.type === "number"
+          ? isValidNumber(newPreviousEmittedValue)
+            ? newPreviousEmittedValue
+            : ""
+          : newPreviousEmittedValue;
+    };
     this.setPreviousValue = (newPreviousValue) => {
       this.previousValue =
         this.type === "number"
@@ -277,7 +291,7 @@ export class Input {
             : ""
           : newPreviousValue;
     };
-    this.setValue = ({ committing = false, nativeEvent, origin = "internal", value }) => {
+    this.setValue = ({ committing = false, nativeEvent, origin, previousValue, value }) => {
       const previousLocalizedValue = this.type === "number"
         ? localizeNumberString(this.previousValue, this.locale, this.groupSeparator)
         : "";
@@ -290,13 +304,14 @@ export class Input {
       const newLocalizedValue = this.type === "number"
         ? localizeNumberString(newValue, this.locale, this.groupSeparator)
         : "";
-      this.internalValueChange = origin === "internal" && this.value !== newValue;
-      this.setPreviousValue(this.value);
+      this.setPreviousValue(previousValue || this.value);
+      this.previousValueOrigin = origin;
+      this.userChangedValue = origin === "user" && this.value !== newValue;
       this.value = newValue;
       if (this.type === "number") {
         this.localizedValue = newLocalizedValue;
       }
-      if (origin === "external") {
+      if (origin === "direct") {
         this.setInputValue(this.type === "number" ? newLocalizedValue : newValue);
       }
       if (nativeEvent) {
@@ -310,7 +325,7 @@ export class Input {
           this.localizedValue = previousLocalizedValue;
         }
         else if (committing) {
-          this.calciteInputChange.emit();
+          this.emitChangeIfUserModified();
         }
       }
     };
@@ -331,10 +346,11 @@ export class Input {
     var _a;
     this.minString = ((_a = this.min) === null || _a === void 0 ? void 0 : _a.toString()) || null;
   }
-  valueWatcher(newValue) {
-    if (!this.internalValueChange) {
+  valueWatcher(newValue, previousValue) {
+    if (!this.userChangedValue) {
       this.setValue({
-        origin: "external",
+        origin: "direct",
+        previousValue,
         value: newValue == null || newValue == ""
           ? ""
           : this.type === "number"
@@ -345,7 +361,7 @@ export class Input {
       });
       this.warnAboutInvalidNumberValue(newValue);
     }
-    this.internalValueChange = false;
+    this.userChangedValue = false;
   }
   updateRequestedIcon() {
     this.requestedIcon = setRequestedIcon(INPUT_TYPE_ICONS, this.icon, this.type);
@@ -369,11 +385,12 @@ export class Input {
     if (this.inlineEditableEl) {
       this.editingEnabled = this.inlineEditableEl.editingEnabled || false;
     }
+    this.setPreviousEmittedValue(this.value);
     this.setPreviousValue(this.value);
     if (this.type === "number") {
       this.warnAboutInvalidNumberValue(this.value);
       this.setValue({
-        origin: "loading",
+        origin: "connected",
         value: isValidNumber(this.value) ? this.value : ""
       });
     }
@@ -398,6 +415,7 @@ export class Input {
   componentShouldUpdate(newValue, oldValue, property) {
     if (this.type === "number" && property === "value" && newValue && !isValidNumber(newValue)) {
       this.setValue({
+        origin: "reset",
         value: oldValue
       });
       return false;
@@ -440,11 +458,13 @@ export class Input {
     this.setValue({
       committing: true,
       nativeEvent,
+      origin: "user",
       value: finalValue.toFixed(Math.max(inputValPlaces, inputStepPlaces))
     });
   }
   onFormReset() {
     this.setValue({
+      origin: "reset",
       value: this.defaultValue
     });
   }
@@ -491,7 +511,7 @@ export class Input {
     const dir = getElementDir(this.el);
     const loader = (h("div", { class: CSS.loader },
       h("calcite-progress", { label: this.intlLoading, type: "indeterminate" })));
-    const inputClearButton = (h("button", { class: CSS.clearButton, disabled: this.disabled || this.readOnly, onClick: this.clearInputValue, tabIndex: this.disabled ? -1 : 0, type: "button" },
+    const inputClearButton = (h("button", { "aria-label": this.intlClear || TEXT.clear, class: CSS.clearButton, disabled: this.disabled || this.readOnly, onClick: this.clearInputValue, tabIndex: this.disabled ? -1 : 0, type: "button" },
       h("calcite-icon", { icon: "x", scale: "s" })));
     const iconEl = (h("calcite-icon", { class: CSS.inputIcon, flipRtl: this.iconFlipRtl, icon: this.requestedIcon, scale: "s" }));
     const isHorizontalNumberButton = this.numberButtonType === "horizontal";
@@ -683,6 +703,23 @@ export class Input {
       "attribute": "icon",
       "reflect": true
     },
+    "intlClear": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": true,
+      "docs": {
+        "tags": [],
+        "text": "A text label that will appear on the clear button for screen readers."
+      },
+      "attribute": "intl-clear",
+      "reflect": false
+    },
     "intlLoading": {
       "type": "string",
       "mutable": false,
@@ -702,7 +739,7 @@ export class Input {
       },
       "attribute": "intl-loading",
       "reflect": false,
-      "defaultValue": "TEXT.loading"
+      "defaultValue": "COMMON_TEXT.loading"
     },
     "iconFlipRtl": {
       "type": "boolean",

package/dist/collection/components/input/interfaces.js

@@ -1,5 +1,6 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
+ * v1.0.0-beta.82
  */
 export {};

package/dist/collection/components/input/resources.js

@@ -1,6 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
+ * v1.0.0-beta.82
  */
 export const CSS = {
   loader: "loader",
@@ -29,3 +30,6 @@ export const INPUT_TYPE_ICONS = {
 export const SLOTS = {
   action: "action"
 };
+export const TEXT = {
+  clear: "Clear value"
+};

package/dist/collection/components/input-date-picker/input-date-picker.css

@@ -223,6 +223,11 @@
   transform: translate(0);
 }
 
+:host([active]) .menu-container {
+  pointer-events: initial;
+  visibility: visible;
+}
+
 .menu-container--active .menu-container .calcite-popper-anim {
   position: relative;
   z-index: 1;

package/dist/collection/components/input-date-picker/input-date-picker.js

@@ -1,15 +1,17 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
+ * v1.0.0-beta.82
  */
 import { Component, h, Prop, Element, Host, State, Listen, Watch, Method, Event, Build } from "@stencil/core";
 import { getLocaleData } from "../date-picker/utils";
 import { dateFromRange, inRange, dateFromISO, dateToISO, parseDateString, sameDate } from "../../utils/date";
 import { TEXT } from "../date-picker/resources";
 import { connectLabel, disconnectLabel, getLabelText } from "../../utils/label";
-import { connectForm, disconnectForm, HiddenFormInputSlot } from "../../utils/form";
-import { createPopper, updatePopper, CSS as PopperCSS, popperMenuFlipPlacements, defaultMenuPlacement } from "../../utils/popper";
+import { connectForm, disconnectForm, HiddenFormInputSlot, submitForm } from "../../utils/form";
+import { createPopper, updatePopper, CSS as PopperCSS, popperMenuComputedPlacements, defaultMenuPlacement, filterComputedPlacements } from "../../utils/popper";
 import { updateHostInteraction } from "../../utils/interactive";
+import { toAriaBoolean } from "../../utils/dom";
 export class InputDatePicker {
   constructor() {
     //--------------------------------------------------------------------------
@@ -39,6 +41,11 @@ export class InputDatePicker {
     this.locale = document.documentElement.lang || "en";
     /** specify the scale of the date picker */
     this.scale = "m";
+    /**
+     * Determines where the date-picker component will be positioned relative to the input.
+     * @default "bottom-leading"
+     */
+    this.placement = defaultMenuPlacement;
     /** Range mode activation */
     this.range = false;
     /**
@@ -55,6 +62,17 @@ export class InputDatePicker {
     this.layout = "horizontal";
     this.focusedInput = "start";
     this.activeTransitionProp = "opacity";
+    //--------------------------------------------------------------------------
+    //
+    //  Private Methods
+    //
+    //--------------------------------------------------------------------------
+    this.setFilteredPlacements = () => {
+      const { el, flipPlacements } = this;
+      this.filteredFlipPlacements = flipPlacements
+        ? filterComputedPlacements(flipPlacements, el)
+        : null;
+    };
     this.transitionEnd = (event) => {
       if (event.propertyName === this.activeTransitionProp) {
         this.active
@@ -71,6 +89,11 @@ export class InputDatePicker {
     this.deactivate = () => {
       this.active = false;
     };
+    this.keyDownHandler = (event) => {
+      if (event.key === "Enter" && !event.defaultPrevented) {
+        submitForm(this);
+      }
+    };
     this.keyUpHandler = (e) => {
       if (e.key === "Escape") {
         this.active = false;
@@ -152,11 +175,18 @@ export class InputDatePicker {
       this.end = undefined;
     }
   }
+  flipPlacementsHandler() {
+    this.setFilteredPlacements();
+  }
   onMinChanged(min) {
-    this.minAsDate = dateFromISO(min);
+    if (min) {
+      this.minAsDate = dateFromISO(min);
+    }
   }
   onMaxChanged(max) {
-    this.maxAsDate = dateFromISO(max);
+    if (max) {
+      this.maxAsDate = dateFromISO(max);
+    }
   }
   activeHandler() {
     if (!this.disabled) {
@@ -191,13 +221,13 @@ export class InputDatePicker {
   }
   /** Updates the position of the component. */
   async reposition() {
-    const { popper, menuEl } = this;
+    const { placement, popper, menuEl } = this;
     const modifiers = this.getModifiers();
     popper
       ? await updatePopper({
         el: menuEl,
         modifiers,
-        placement: defaultMenuPlacement,
+        placement,
         popper
       })
       : this.createPopper();
@@ -233,6 +263,7 @@ export class InputDatePicker {
     this.createPopper();
     connectLabel(this);
     connectForm(this);
+    this.setFilteredPlacements();
   }
   async componentWillLoad() {
     await this.loadLocaleData();
@@ -256,11 +287,11 @@ export class InputDatePicker {
       : null;
     const formattedEndDate = endDate ? endDate.toLocaleDateString(this.locale) : "";
     const formattedDate = date ? date.toLocaleDateString(this.locale) : "";
-    return (h(Host, { onBlur: this.deactivate, onKeyUp: this.keyUpHandler, role: "application" },
-      this.localeData && (h("div", { "aria-expanded": this.active.toString(), class: "input-container", role: "application" },
+    return (h(Host, { onBlur: this.deactivate, onKeyDown: this.keyDownHandler, onKeyUp: this.keyUpHandler, role: "application" },
+      this.localeData && (h("div", { "aria-expanded": toAriaBoolean(this.active), class: "input-container", role: "application" },
         h("div", { class: "input-wrapper", ref: this.setStartWrapper },
           h("calcite-input", { class: `input ${this.layout === "vertical" && this.range ? `no-bottom-border` : ``}`, disabled: disabled, icon: "calendar", label: getLabelText(this), "number-button-type": "none", onCalciteInputBlur: this.inputBlur, onCalciteInputFocus: this.startInputFocus, onCalciteInputInput: this.inputInput, placeholder: (_a = this.localeData) === null || _a === void 0 ? void 0 : _a.placeholder, ref: this.setStartInput, scale: this.scale, type: "text", value: formattedDate })),
-        h("div", { "aria-hidden": (!this.active).toString(), class: {
+        h("div", { "aria-hidden": toAriaBoolean(!this.active), class: {
             "menu-container": true,
             "menu-container--active": this.active
           }, ref: this.setMenuEl },
@@ -290,11 +321,6 @@ export class InputDatePicker {
         : startWrapper || endWrapper;
     this.createPopper();
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Private Methods
-  //
-  //--------------------------------------------------------------------------
   onLabelClick() {
     this.setFocus();
   }
@@ -304,7 +330,7 @@ export class InputDatePicker {
       enabled: true
     };
     flipModifier.options = {
-      fallbackPlacements: this.flipPlacements || popperMenuFlipPlacements
+      fallbackPlacements: this.filteredFlipPlacements || popperMenuComputedPlacements
     };
     const eventListenerModifier = {
       name: "eventListeners",
@@ -314,7 +340,7 @@ export class InputDatePicker {
   }
   createPopper() {
     this.destroyPopper();
-    const { menuEl, referenceEl, overlayPositioning } = this;
+    const { menuEl, placement, referenceEl, overlayPositioning } = this;
     if (!menuEl || !referenceEl) {
       return;
     }
@@ -323,7 +349,7 @@ export class InputDatePicker {
       el: menuEl,
       modifiers,
       overlayPositioning,
-      placement: defaultMenuPlacement,
+      placement,
       referenceEl
     });
   }
@@ -349,15 +375,24 @@ export class InputDatePicker {
   }
   clearCurrentValue() {
     if (!this.range) {
+      if (typeof this.value === "string" && this.value) {
+        this.calciteDatePickerChange.emit();
+      }
       this.value = "";
       return;
     }
     const { focusedInput } = this;
     if (focusedInput === "start") {
+      if (this.start) {
+        this.calciteDatePickerRangeChange.emit();
+      }
       this.value = Array.isArray(this.value) ? ["", this.value[1] || ""] : [""];
       this.start = undefined;
     }
     else if (focusedInput === "end") {
+      if (this.end) {
+        this.calciteDatePickerRangeChange.emit();
+      }
       this.value = Array.isArray(this.value) ? [this.value[0] || "", ""] : ["", ""];
       this.end = undefined;
     }
@@ -818,6 +853,32 @@ export class InputDatePicker {
       "reflect": true,
       "defaultValue": "\"m\""
     },
+    "placement": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "MenuPlacement",
+        "resolved": "\"bottom\" | \"bottom-end\" | \"bottom-leading\" | \"bottom-start\" | \"bottom-trailing\" | \"top\" | \"top-end\" | \"top-leading\" | \"top-start\" | \"top-trailing\"",
+        "references": {
+          "MenuPlacement": {
+            "location": "import",
+            "path": "../../utils/popper"
+          }
+        }
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "default",
+            "text": "\"bottom-leading\""
+          }],
+        "text": "Determines where the date-picker component will be positioned relative to the input."
+      },
+      "attribute": "placement",
+      "reflect": true,
+      "defaultValue": "defaultMenuPlacement"
+    },
     "range": {
       "type": "boolean",
       "mutable": false,
@@ -1102,6 +1163,9 @@ export class InputDatePicker {
     }, {
       "propName": "value",
       "methodName": "valueHandler"
+    }, {
+      "propName": "flipPlacements",
+      "methodName": "flipPlacementsHandler"
     }, {
       "propName": "min",
       "methodName": "onMinChanged"

package/dist/collection/components/input-message/input-message.js

@@ -1,6 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
+ * v1.0.0-beta.82
  */
 import { Component, Element, Host, h, Prop, Watch } from "@stencil/core";
 import { getElementProp, setRequestedIcon } from "../../utils/dom";

package/dist/collection/components/input-message/interfaces.js

@@ -1,6 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
+ * v1.0.0-beta.82
  */
 export var StatusIconDefaults;
 (function (StatusIconDefaults) {