@mgdis/mg-components 3.1.0

package/dist/collection/components/molecules/inputs/mg-input-checkbox/mg-input-checkbox.css

@@ -0,0 +1,156 @@
+/**
+ * Common style for MGDIS inputs
+ */
+:host {
+  display: block;
+}
+
+.mg-input {
+  display: flex;
+  align-items: flex-start;
+  min-height: var(--default-size);
+  max-width: 100%;
+  /* Style when input is not valid */
+  /* Label */
+  /* Label-on-top */
+}
+.mg-input.is-not-valid {
+  color: hsl(var(--color-danger));
+}
+.mg-input.is-not-valid .mg-input__box {
+  border-color: hsl(var(--color-danger));
+}
+.mg-input mg-input-title {
+  flex-shrink: var(--mg-inputs-shrink, 1);
+  width: var(--mg-inputs-title-width, auto);
+  margin-top: calc((var(--default-size) - var(--font-size) * var(--line-height)) / 2);
+  margin-right: var(--mg-inputs-title-horizontal-space, var(--mg-inputs-spacer));
+  text-align: right;
+}
+.mg-input.mg-input--label-on-top {
+  flex-direction: column;
+}
+.mg-input.mg-input--label-on-top .mg-input__input-container {
+  width: 100%;
+}
+
+/* Label-on-top */
+.mg-input__title {
+  display: flex;
+  align-items: baseline;
+  margin-bottom: 0.3rem;
+}
+.mg-input__title mg-input-title {
+  flex-shrink: 1;
+  width: auto;
+  margin-top: 0;
+  margin-right: var(--mg-inputs-spacer);
+  text-align: left;
+}
+.mg-input__title mg-tooltip {
+  margin-top: 0;
+}
+.mg-input__title mg-icon {
+  display: inline-flex;
+  vertical-align: text-bottom;
+}
+
+.mg-input__input-container {
+  min-height: var(--default-size);
+  /* Readonly */
+}
+.mg-input__input-container > strong {
+  display: inline-block;
+  margin-top: calc((var(--default-size) - var(--font-size) * var(--line-height)) / 2);
+  min-height: var(--font-size);
+}
+.mg-input__input-container mg-tooltip {
+  display: inline-flex;
+  width: var(--mg-icon-regular-size);
+  height: var(--mg-icon-regular-size);
+  margin-left: var(--mg-inputs-spacer);
+}
+.mg-input__input-container mg-icon {
+  display: flex;
+}
+
+.mg-input__input {
+  display: flex;
+  /* Manage space between input and first message */
+}
+.mg-input__input mg-tooltip {
+  margin-top: calc((var(--default-size) - var(--mg-icon-regular-size)) / 2);
+}
+.mg-input__input + * {
+  text-align: start;
+  margin-top: 0.5rem;
+}
+
+/**
+ * Manage style when input needs to be a fieldset, like checkbox and radio.
+ */
+fieldset.mg-input {
+  border: 0;
+  margin: 0;
+  padding: 0;
+}
+fieldset.mg-input input[type=radio],
+fieldset.mg-input input[type=checkbox] {
+  flex-shrink: 0;
+  /* Ensure checkbox won't resize in flex element */
+  width: var(--mg-input-check-size);
+  height: var(--mg-input-check-size);
+  margin-top: calc((var(--font-size) * var(--line-height) - var(--mg-input-check-size)) / 2);
+  margin-right: 0.6rem;
+  margin-bottom: 0;
+  margin-left: 0;
+}
+fieldset.mg-input.mg-input--label-on-top .mg-input__input-group-container {
+  margin-top: 0.7rem;
+}
+
+.mg-input__input-container mg-tooltip {
+  margin-left: 2rem;
+}
+
+/* input group container */
+.mg-input__input-group-container {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+  flex-wrap: wrap;
+  column-gap: 2.3rem;
+  row-gap: 1rem;
+  margin-top: calc((var(--default-size) - var(--font-size) * var(--line-height)) / 2);
+}
+.mg-input__input-group-container--vertical {
+  flex-direction: column;
+}
+
+/* input group */
+.mg-input__input-group {
+  display: flex;
+  align-items: top;
+}
+
+/**
+ * A11Y
+ */
+.sr-only {
+  border: 0 !important;
+  clip: rect(1px, 1px, 1px, 1px) !important;
+  -webkit-clip-path: inset(50%) !important;
+  clip-path: inset(50%) !important;
+  height: 1px !important;
+  margin: -1px !important;
+  overflow: hidden !important;
+  padding: 0 !important;
+  position: absolute !important;
+  width: 1px !important;
+  white-space: nowrap !important;
+}
+
+*:focus:not(:focus-visible) {
+  outline: none;
+}

package/dist/collection/components/molecules/inputs/mg-input-checkbox/mg-input-checkbox.js

@@ -0,0 +1,444 @@
+import { Component, Event, h, Prop, State, Watch } from '@stencil/core';
+import { MgInput } from '../MgInput';
+import { createID, ClassList } from '../../../../utils/components.utils';
+import { messages } from '../../../../locales';
+import { InputClass } from '../MgInput.conf';
+/**
+ * type CheckboxItem validation function
+ * @param CheckboxItem
+ * @returns {boolean}
+ */
+const isCheckboxItem = (item) => typeof item === 'object' && typeof item.title === 'string' && (item.value === null || typeof item.value === 'boolean') && item.value !== undefined;
+export class MgInputCheckbox {
+  constructor() {
+    /************
+     * Internal *
+     ************/
+    // classes
+    this.classError = InputClass.ERROR;
+    // HTML selector
+    this.inputs = [];
+    /**
+     * Identifier is used for the element ID (id is a reserved prop in Stencil.js)
+     * If not set, it will be created.
+     */
+    this.identifier = createID('mg-input-checkbox');
+    /**
+     * Input name
+     * If not set the value equals the identifier
+     */
+    this.name = this.identifier;
+    /**
+     * Define if label is visible
+     */
+    this.labelHide = false;
+    /**
+     * Define if inputs are display verticaly
+     */
+    this.inputVerticalList = false;
+    /**
+     * Define if input is required
+     */
+    this.required = false;
+    /**
+     * Define if input is readonly
+     */
+    this.readonly = false;
+    /**
+     * Define if input is disabled
+     */
+    this.disabled = false;
+    /**
+     * Component classes
+     */
+    this.classList = new ClassList(['mg-input--checkbox']);
+    /**
+     * Formated value for display
+     */
+    this.checkboxItems = [];
+    /**
+     * Handle input event
+     * @param event
+     */
+    this.handleInput = (event) => {
+      this.checkboxItems = this.checkboxItems.map(item => {
+        if (item.id === event.target.id) {
+          item.value = Boolean(event.target.checked);
+        }
+        return item;
+      });
+      this.value = this.checkboxItems.map(o => ({ value: o.value, title: o.title, disabled: o.disabled }));
+      this.checkValidity();
+      this.valueChange.emit(this.value);
+    };
+    /**
+     * Handle blur event
+     */
+    this.handleBlur = () => {
+      // Check validity
+      this.checkValidity();
+      this.checkError();
+    };
+    /**
+     * get invalid element
+     * @returns element: HTMLInputElement
+     */
+    this.getInvalidElement = () => this.inputs.find((element) => !element.disabled && !element.checkValidity());
+  }
+  validateValue(newValue) {
+    if (newValue && newValue.every(item => isCheckboxItem(item))) {
+      this.checkboxItems = newValue.map((item, index) => ({
+        id: `${this.identifier}_${index.toString()}`,
+        title: item.title,
+        value: item.value,
+        disabled: item.disabled,
+      }));
+    }
+    else {
+      throw new Error('<mg-input-checkbox> prop "value" is required and all values must be the same type, CheckboxItem.');
+    }
+  }
+  handleReadOnly() {
+    this.classList.delete(this.classError);
+  }
+  /**
+   * Check if input is valid
+   */
+  checkValidity() {
+    if (!this.readonly) {
+      const validity = this.getInvalidElement() === undefined;
+      // Set validity
+      this.valid = validity;
+      this.invalid = !validity;
+    }
+  }
+  /**
+   * Check input errors
+   */
+  checkError() {
+    const invalidElement = this.getInvalidElement();
+    // Set error message
+    this.errorMessage = undefined;
+    if (!this.valid && invalidElement.validity.valueMissing) {
+      this.errorMessage = messages.errors.required;
+    }
+    // Update class
+    if (this.valid) {
+      this.classList.delete(this.classError);
+    }
+    else {
+      this.classList.add(this.classError);
+    }
+  }
+  /*************
+   * Lifecycle *
+   *************/
+  componentWillLoad() {
+    // Check values format
+    this.validateValue(this.value);
+    // return a promise to process action only in the FIRST render().
+    // https://stenciljs.com/docs/component-lifecycle#componentwillload
+    return setTimeout(() => this.checkValidity(), 0);
+  }
+  render() {
+    return (h(MgInput, { identifier: this.identifier, classList: this.classList, label: this.label, labelOnTop: this.labelOnTop, labelHide: this.labelHide, required: this.required, readonly: undefined, width: undefined, disabled: this.disabled, value: this.value && this.value.toString(), readonlyValue: undefined, tooltip: !this.readonly && this.tooltip, displayCharacterLeft: undefined, characterLeftTemplate: undefined, maxlength: undefined, helpText: this.helpText, errorMessage: this.errorMessage, isFieldset: true },
+      h("ul", { class: `mg-input__input-group-container${this.inputVerticalList ? ' mg-input__input-group-container--vertical' : ''}` }, this.checkboxItems
+        .filter(item => {
+        return !this.readonly || item.value;
+      })
+        .map(input => (h("li", { class: "mg-input__input-group" },
+        h("input", { type: "checkbox", id: input.id, name: this.identifier, value: input.value && input.value.toString(), checked: Boolean(input.value), disabled: this.readonly || this.disabled || input.disabled, required: this.required, indeterminate: input.value === null, onInput: this.handleInput, onBlur: this.handleBlur, ref: el => this.inputs.push(el) }),
+        h("label", { htmlFor: input.id }, input.title)))))));
+  }
+  static get is() { return "mg-input-checkbox"; }
+  static get encapsulation() { return "shadow"; }
+  static get originalStyleUrls() { return {
+    "$": ["mg-input-checkbox.scss"]
+  }; }
+  static get styleUrls() { return {
+    "$": ["mg-input-checkbox.css"]
+  }; }
+  static get properties() { return {
+    "value": {
+      "type": "unknown",
+      "mutable": true,
+      "complexType": {
+        "original": "CheckboxValue[]",
+        "resolved": "CheckboxValue[]",
+        "references": {
+          "CheckboxValue": {
+            "location": "import",
+            "path": "./mg-input-checkbox.conf"
+          }
+        }
+      },
+      "required": true,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Component value\nIf item.value is `null`, checkbox will be indeterminate by default\nRequired"
+      }
+    },
+    "identifier": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": true,
+      "docs": {
+        "tags": [],
+        "text": "Identifier is used for the element ID (id is a reserved prop in Stencil.js)\nIf not set, it will be created."
+      },
+      "attribute": "identifier",
+      "reflect": false,
+      "defaultValue": "createID('mg-input-checkbox')"
+    },
+    "name": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": true,
+      "docs": {
+        "tags": [],
+        "text": "Input name\nIf not set the value equals the identifier"
+      },
+      "attribute": "name",
+      "reflect": false,
+      "defaultValue": "this.identifier"
+    },
+    "label": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": true,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Input label\nRequired"
+      },
+      "attribute": "label",
+      "reflect": false
+    },
+    "labelOnTop": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Define if label is displayed on top"
+      },
+      "attribute": "label-on-top",
+      "reflect": false
+    },
+    "labelHide": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Define if label is visible"
+      },
+      "attribute": "label-hide",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "inputVerticalList": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Define if inputs are display verticaly"
+      },
+      "attribute": "input-vertical-list",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "required": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Define if input is required"
+      },
+      "attribute": "required",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "readonly": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Define if input is readonly"
+      },
+      "attribute": "readonly",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "disabled": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Define if input is disabled"
+      },
+      "attribute": "disabled",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "tooltip": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Add a tooltip message next to the input"
+      },
+      "attribute": "tooltip",
+      "reflect": false
+    },
+    "helpText": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Add a help text under the input, usually expected data format and example"
+      },
+      "attribute": "help-text",
+      "reflect": false
+    },
+    "valid": {
+      "type": "boolean",
+      "mutable": true,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Force valid component"
+      },
+      "attribute": "valid",
+      "reflect": false
+    },
+    "invalid": {
+      "type": "boolean",
+      "mutable": true,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Force invalid component"
+      },
+      "attribute": "invalid",
+      "reflect": false
+    }
+  }; }
+  static get states() { return {
+    "classList": {},
+    "errorMessage": {},
+    "checkboxItems": {}
+  }; }
+  static get events() { return [{
+      "method": "valueChange",
+      "name": "value-change",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": "Emitted event when value change"
+      },
+      "complexType": {
+        "original": "CheckboxValue[]",
+        "resolved": "CheckboxValue[]",
+        "references": {
+          "CheckboxValue": {
+            "location": "import",
+            "path": "./mg-input-checkbox.conf"
+          }
+        }
+      }
+    }]; }
+  static get watchers() { return [{
+      "propName": "value",
+      "methodName": "validateValue"
+    }, {
+      "propName": "readonly",
+      "methodName": "handleReadOnly"
+    }]; }
+}

package/dist/collection/components/molecules/inputs/mg-input-checkbox/mg-input-checkbox.stories.js

@@ -0,0 +1,57 @@
+import { h } from '@stencil/core';
+export default {
+  component: 'mg-input-checkbox',
+  title: 'Molecules/Inputs/mg-input-checkbox',
+};
+/**
+ * 1. camelCase arguments must be written in the template, for exemple labelOnTop must be placed in the template as label-on-top={args.labelOnTop}
+ * 2. boolean arguments with a default true value must be added like display-character-left={args.displayCharacterLeft ? 'true' : 'false'}
+ */
+const Template = args => {
+  // Extract slot so it won't be render as an attribute
+  const labelOnTop = args.labelOnTop;
+  delete args.labelOnTop;
+  const helpText = args.helpText;
+  delete args.helpText;
+  const inputVerticalList = args.inputVerticalList;
+  delete args.inputVerticalList;
+  const labelHide = args.labelHide;
+  delete args.labelHide;
+  // return element
+  return h("mg-input-checkbox", Object.assign({}, args, { "label-on-top": labelOnTop, "label-hide": labelHide, "help-text": helpText, "input-vertical-list": inputVerticalList }));
+};
+export const MgInputCheckbox = Template.bind({});
+MgInputCheckbox.args = {
+  // Global
+  value: [
+    {
+      title: 'HT',
+      value: true,
+    },
+    {
+      title: 'TTC',
+      value: false,
+      disabled: true,
+    },
+    {
+      title: 'Mixte (HT/TTC)',
+      value: null,
+    },
+  ],
+  identifier: 'identifier',
+  name: 'input-name',
+  // Label
+  label: 'Option',
+  labelOnTop: false,
+  labelHide: false,
+  // placement
+  inputVerticalList: false,
+  // Input
+  required: false,
+  disabled: false,
+  readonly: false,
+  // Tooltip
+  tooltip: 'This is a tooltip',
+  // Help Text
+  helpText: 'Help text with html <strong>bold</strong>, <em>italic</em>.',
+};

package/dist/collection/components/molecules/inputs/mg-input-date/mg-input-date.conf.js

@@ -0,0 +1,7 @@
+export var InputError;
+(function (InputError) {
+  InputError["MIN"] = "min";
+  InputError["MAX"] = "max";
+  InputError["MINMAX"] = "minMax";
+  InputError["REQUIRED"] = "required";
+})(InputError || (InputError = {}));