@sme.up/ketchup 8.0.2 → 8.2.0

package/dist/collection/components/kup-dropdown-button/kup-dropdown-button.js

@@ -1,800 +1,800 @@
-import { forceUpdate, h, Host, } from '@stencil/core';
-import { kupManagerInstance, } from '../../managers/kup-manager/kup-manager';
-import { ItemsDisplayMode } from '../kup-list/kup-list-declarations';
-import { consistencyCheck } from '../kup-list/kup-list-helper';
-import { KupDropdownButtonProps, } from './kup-dropdown-button-declarations';
-import { FButtonStyling, } from '../../f-components/f-button/f-button-declarations';
-import { FButton } from '../../f-components/f-button/f-button';
-import { getProps, setProps } from '../../utils/utils';
-import { componentWrapperId } from '../../variables/GenericVariables';
-import { KupDynamicPositionPlacement } from '../../managers/kup-dynamic-position/kup-dynamic-position-declarations';
-export class KupDropdownButton {
-  constructor() {
-    /*-------------------------------------------------*/
-    /*       I n t e r n a l   V a r i a b l e s       */
-    /*-------------------------------------------------*/
-    /**
-     * Instance of the KupManager class.
-     */
-    this.kupManager = kupManagerInstance();
-    /**
-     * Primary button element.
-     */
-    this.buttonEl = null;
-    /**
-     * Dropdown button element.
-     */
-    this.dropdownEl = null;
-    /**
-     * List element (dropdown menu).
-     */
-    this.listEl = null;
-    this.clickCb = null;
-    this.id = '';
-    this.customStyle = '';
-    this.data = null;
-    this.disabled = false;
-    this.displayMode = ItemsDisplayMode.DESCRIPTION;
-    this.dropdownOnly = false;
-    this.icon = null;
-    this.initialValue = '';
-    this.label = null;
-    this.selectMode = ItemsDisplayMode.CODE;
-    this.styling = FButtonStyling.RAISED;
-    this.trailingIcon = false;
-  }
-  /**
-   * Handles the navigation of the dropdown menu with the keyboard.
-   */
-  listenKeydown(e) {
-    if (this.isListOpened()) {
-      switch (e.key) {
-        case 'ArrowDown':
-          e.preventDefault();
-          e.stopPropagation();
-          this.listEl.focusNext();
-          break;
-        case 'ArrowUp':
-          e.preventDefault();
-          e.stopPropagation();
-          this.listEl.focusPrevious();
-          break;
-        case 'Enter':
-          e.preventDefault();
-          e.stopPropagation();
-          this.listEl.select().then(() => {
-            this.closeList();
-          });
-          this.dropdownEl.focus();
-          break;
-        case 'Escape':
-          e.preventDefault();
-          e.stopPropagation();
-          this.closeList();
-          break;
-      }
-    }
-    else {
-      switch (e.key) {
-        case 'ArrowDown':
-          e.preventDefault();
-          e.stopPropagation();
-          this.openList();
-          this.listEl.focusNext();
-          break;
-        case 'ArrowUp':
-          e.preventDefault();
-          e.stopPropagation();
-          this.openList();
-          this.listEl.focusPrevious();
-          break;
-      }
-    }
-  }
-  onKupBlur() {
-    this.closeList();
-    this.kupBlur.emit({
-      comp: this,
-      id: this.rootElement.id,
-      value: this.id,
-    });
-  }
-  onKupClick() {
-    this.closeList();
-    this.kupClick.emit({
-      comp: this,
-      id: this.rootElement.id,
-      value: this.id,
-    });
-  }
-  onKupFocus() {
-    this.kupFocus.emit({
-      comp: this,
-      id: this.rootElement.id,
-      value: this.id,
-    });
-  }
-  onDropDownClick() {
-    if (this.isListOpened()) {
-      this.closeList();
-    }
-    else {
-      this.openList();
-    }
-  }
-  onKupItemClick(e) {
-    this.consistencyCheck(e);
-    this.closeList();
-    this.kupChange.emit({
-      comp: this,
-      id: this.rootElement.id,
-      value: this.id,
-    });
-    this.kupItemClick.emit({
-      comp: this,
-      id: this.rootElement.id,
-      value: this.id,
-    });
-  }
-  /*-------------------------------------------------*/
-  /*           P u b l i c   M e t h o d s           */
-  /*-------------------------------------------------*/
-  /**
-   * Used to retrieve component's props values.
-   * @param {boolean} descriptions - When provided and true, the result will be the list of props with their description.
-   * @returns {Promise<GenericObject>} List of props as object, each key will be a prop.
-   */
-  async getProps(descriptions) {
-    return getProps(this, KupDropdownButtonProps, descriptions);
-  }
-  /**
-   * Returns the component's internal value.
-   */
-  async getValue() {
-    return this.id;
-  }
-  /**
-   * This method is used to trigger a new render of the component.
-   */
-  async refresh() {
-    forceUpdate(this);
-  }
-  /**
-   * Sets the props to the component.
-   * @param {GenericObject} props - Object containing props that will be set to the component.
-   */
-  async setProps(props) {
-    setProps(this, KupDropdownButtonProps, props);
-  }
-  /**
-   * Sets the internal value of the component.
-   */
-  async setValue(value) {
-    this.id = value;
-  }
-  /*-------------------------------------------------*/
-  /*           P r i v a t e   M e t h o d s         */
-  /*-------------------------------------------------*/
-  /**
-   * Checks whether the dropdown menu is opened or not.
-   * @returns {boolean} True when the list is opened.
-   */
-  isListOpened() {
-    if (this.listEl == null) {
-      return false;
-    }
-    return this.listEl.menuVisible == true;
-  }
-  /**
-   * Opens the dropdown menu.
-   */
-  openList() {
-    var _a;
-    const buttonWidth = (this.buttonEl ? this.buttonEl.clientWidth : 0) +
-      this.dropdownEl.clientWidth;
-    (_a = this.buttonEl) === null || _a === void 0 ? void 0 : _a.classList.add('toggled');
-    this.dropdownEl.classList.add('toggled');
-    this.listEl.menuVisible = true;
-    const elStyle = this.listEl.style;
-    elStyle.height = 'auto';
-    elStyle.minWidth = buttonWidth + 'px';
-    if (this.kupManager.dynamicPosition.isRegistered(this.listEl)) {
-      this.kupManager.dynamicPosition.changeAnchor(this.listEl, this.buttonEl ? this.buttonEl : this.dropdownEl);
-    }
-    else {
-      this.kupManager.dynamicPosition.register(this.listEl, this.buttonEl ? this.buttonEl : this.dropdownEl, 0, KupDynamicPositionPlacement.AUTO, true);
-    }
-    this.kupManager.dynamicPosition.start(this.listEl);
-    if (!this.clickCb) {
-      this.clickCb = {
-        cb: () => {
-          this.closeList();
-        },
-        el: this.listEl,
-      };
-    }
-    this.kupManager.addClickCallback(this.clickCb, true);
-  }
-  /**
-   * Closes the dropdown menu.
-   */
-  closeList() {
-    var _a;
-    (_a = this.buttonEl) === null || _a === void 0 ? void 0 : _a.classList.remove('toggled');
-    this.dropdownEl.classList.remove('toggled');
-    this.listEl.menuVisible = false;
-    this.kupManager.dynamicPosition.stop(this.listEl);
-    this.kupManager.removeClickCallback(this.clickCb);
-  }
-  /**
-   * Checks the consistency of the list.
-   */
-  consistencyCheck(e, idIn) {
-    const ret = consistencyCheck(idIn, this.data['kup-list'], this.listEl, this.selectMode, this.displayMode, e);
-    this.id = ret.value;
-  }
-  /*-------------------------------------------------*/
-  /*          L i f e c y c l e   H o o k s          */
-  /*-------------------------------------------------*/
-  componentWillLoad() {
-    this.kupManager.debug.logLoad(this, false);
-    this.kupManager.theme.register(this);
-    this.id = this.initialValue;
-    if (!this.data) {
-      this.data = {
-        'kup-list': {},
-      };
-    }
-  }
-  componentDidLoad() {
-    this.consistencyCheck(undefined, this.id);
-    this.kupManager.debug.logLoad(this, true);
-  }
-  componentWillRender() {
-    this.kupManager.debug.logRender(this, false);
-  }
-  componentDidRender() {
-    const root = this.rootElement.shadowRoot;
-    if (root && (!this.buttonEl || !this.dropdownEl)) {
-      this.buttonEl = root.querySelector('.dropdown-button__primary-action');
-      this.dropdownEl = root.querySelector('.dropdown-button__dropdown-action');
-    }
-    this.kupManager.debug.logRender(this, true);
-  }
-  renderButtons() {
-    const buttons = [];
-    const props = {
-      disabled: this.disabled ? true : false,
-      large: this.rootElement.classList.contains('kup-large')
-        ? true
-        : false,
-      pulsating: this.rootElement.classList.contains('kup-pulsating')
-        ? true
-        : false,
-      slim: this.rootElement.classList.contains('kup-slim')
-        ? true
-        : false,
-      styling: this.styling ? this.styling : FButtonStyling.RAISED,
-      title: this.rootElement.title,
-    };
-    if (!this.dropdownOnly) {
-      buttons.push(h(FButton, Object.assign({}, props, { icon: this.icon ? this.icon : null, label: this.label ? this.label : null, trailingIcon: this.trailingIcon ? true : false, wrapperClass: "dropdown-button__primary-action", onClick: () => this.onKupClick(), onBlur: () => this.onKupBlur(), onFocus: () => this.onKupFocus() })));
-    }
-    buttons.push(h(FButton, Object.assign({}, props, { disabled: this.disabled ? true : false, icon: this.dropdownOnly && this.icon && this.icon !== ''
-        ? this.icon
-        : 'arrow_drop_down', label: " ", wrapperClass: 'dropdown-button__dropdown-action' +
-        (this.dropdownOnly ? ' dropdown-only' : ''), onClick: () => this.onDropDownClick() })));
-    return buttons;
-  }
-  render() {
-    return (h(Host, null, h("style", null, this.kupManager.theme.setKupStyle(this.rootElement)), h("div", { id: componentWrapperId }, h("div", { class: "dropdown-button--wrapper" }, this.renderButtons()), h("kup-list", Object.assign({}, this.data['kup-list'], { displayMode: this.displayMode, isMenu: true, "onkup-list-click": (e) => this.onKupItemClick(e), id: this.rootElement.id + '_list', ref: (el) => (this.listEl = el) })))));
-  }
-  disconnectedCallback() {
-    if (this.listEl) {
-      this.kupManager.dynamicPosition.unregister([this.listEl]);
-      this.listEl.remove();
-    }
-    this.kupManager.theme.unregister(this);
-  }
-  static get is() { return "kup-dropdown-button"; }
-  static get encapsulation() { return "shadow"; }
-  static get originalStyleUrls() {
-    return {
-      "$": ["kup-dropdown-button.scss"]
-    };
-  }
-  static get styleUrls() {
-    return {
-      "$": ["kup-dropdown-button.css"]
-    };
-  }
-  static get properties() {
-    return {
-      "customStyle": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "string",
-          "resolved": "string",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "\"\""
-            }, {
-              "name": "see",
-              "text": "https://ketchup.smeup.com/ketchup-showcase/#/customization"
-            }],
-          "text": "Custom style of the component."
-        },
-        "attribute": "custom-style",
-        "reflect": false,
-        "defaultValue": "''"
-      },
-      "data": {
-        "type": "unknown",
-        "mutable": false,
-        "complexType": {
-          "original": "Object",
-          "resolved": "Object",
-          "references": {
-            "Object": {
-              "location": "global"
-            }
-          }
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "null"
-            }],
-          "text": "Props of the sub-components."
-        },
-        "defaultValue": "null"
-      },
-      "disabled": {
-        "type": "boolean",
-        "mutable": false,
-        "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "false"
-            }],
-          "text": "Defaults at false. When set to true, the component is disabled."
-        },
-        "attribute": "disabled",
-        "reflect": false,
-        "defaultValue": "false"
-      },
-      "displayMode": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "ItemsDisplayMode",
-          "resolved": "ItemsDisplayMode.CODE | ItemsDisplayMode.DESCRIPTION | ItemsDisplayMode.DESCRIPTION_AND_CODE",
-          "references": {
-            "ItemsDisplayMode": {
-              "location": "import",
-              "path": "../kup-list/kup-list-declarations"
-            }
-          }
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "ItemsDisplayMode.DESCRIPTION"
-            }],
-          "text": "Sets how to show the selected item value. Suported values: \"code\", \"description\", \"both\"."
-        },
-        "attribute": "display-mode",
-        "reflect": false,
-        "defaultValue": "ItemsDisplayMode.DESCRIPTION"
-      },
-      "dropdownOnly": {
-        "type": "boolean",
-        "mutable": false,
-        "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "false"
-            }],
-          "text": "Default value is false. When set to true, the arrow dropdown button is the only button displayed."
-        },
-        "attribute": "dropdown-only",
-        "reflect": false,
-        "defaultValue": "false"
-      },
-      "icon": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "string",
-          "resolved": "string",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "icon"
-            }],
-          "text": "Defaults at null. When set, the button will show this icon."
-        },
-        "attribute": "icon",
-        "reflect": false,
-        "defaultValue": "null"
-      },
-      "initialValue": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "string",
-          "resolved": "string",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "\"\""
-            }],
-          "text": "Sets the initial value of the component."
-        },
-        "attribute": "initial-value",
-        "reflect": false,
-        "defaultValue": "''"
-      },
-      "label": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "string",
-          "resolved": "string",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "\"\""
-            }],
-          "text": "Defaults at null. When set, the button will show this text."
-        },
-        "attribute": "label",
-        "reflect": false,
-        "defaultValue": "null"
-      },
-      "selectMode": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "ItemsDisplayMode",
-          "resolved": "ItemsDisplayMode.CODE | ItemsDisplayMode.DESCRIPTION | ItemsDisplayMode.DESCRIPTION_AND_CODE",
-          "references": {
-            "ItemsDisplayMode": {
-              "location": "import",
-              "path": "../kup-list/kup-list-declarations"
-            }
-          }
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "ItemsDisplayMode.CODE"
-            }],
-          "text": "Sets how to return the selected item value. Suported values: \"code\", \"description\", \"both\"."
-        },
-        "attribute": "select-mode",
-        "reflect": false,
-        "defaultValue": "ItemsDisplayMode.CODE"
-      },
-      "styling": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "FButtonStyling",
-          "resolved": "FButtonStyling.FLAT | FButtonStyling.FLOATING | FButtonStyling.ICON | FButtonStyling.OUTLINED | FButtonStyling.RAISED",
-          "references": {
-            "FButtonStyling": {
-              "location": "import",
-              "path": "../../f-components/f-button/f-button-declarations"
-            }
-          }
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "FButtonStyling.RAISED"
-            }],
-          "text": "Defines the style of the button. Styles available: \"flat\", \"outlined\" and \"raised\" which is also the default."
-        },
-        "attribute": "styling",
-        "reflect": false,
-        "defaultValue": "FButtonStyling.RAISED"
-      },
-      "trailingIcon": {
-        "type": "boolean",
-        "mutable": false,
-        "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [{
-              "name": "default",
-              "text": "false"
-            }],
-          "text": "Defaults at null. When set, the icon will be shown after the text."
-        },
-        "attribute": "trailing-icon",
-        "reflect": false,
-        "defaultValue": "false"
-      }
-    };
-  }
-  static get states() {
-    return {
-      "id": {}
-    };
-  }
-  static get events() {
-    return [{
-        "method": "kupBlur",
-        "name": "kup-dropdownbutton-blur",
-        "bubbles": true,
-        "cancelable": false,
-        "composed": true,
-        "docs": {
-          "tags": [],
-          "text": "Triggered when the primary button loses focus."
-        },
-        "complexType": {
-          "original": "KupDropdownButtonEventPayload",
-          "resolved": "KupDropdownButtonEventPayload",
-          "references": {
-            "KupDropdownButtonEventPayload": {
-              "location": "import",
-              "path": "./kup-dropdown-button-declarations"
-            }
-          }
-        }
-      }, {
-        "method": "kupClick",
-        "name": "kup-dropdownbutton-click",
-        "bubbles": true,
-        "cancelable": false,
-        "composed": true,
-        "docs": {
-          "tags": [],
-          "text": "Triggered when the primary button is clicked."
-        },
-        "complexType": {
-          "original": "KupDropdownButtonEventPayload",
-          "resolved": "KupDropdownButtonEventPayload",
-          "references": {
-            "KupDropdownButtonEventPayload": {
-              "location": "import",
-              "path": "./kup-dropdown-button-declarations"
-            }
-          }
-        }
-      }, {
-        "method": "kupFocus",
-        "name": "kup-dropdownbutton-focus",
-        "bubbles": true,
-        "cancelable": false,
-        "composed": true,
-        "docs": {
-          "tags": [],
-          "text": "Triggered when the primary button is focused."
-        },
-        "complexType": {
-          "original": "KupDropdownButtonEventPayload",
-          "resolved": "KupDropdownButtonEventPayload",
-          "references": {
-            "KupDropdownButtonEventPayload": {
-              "location": "import",
-              "path": "./kup-dropdown-button-declarations"
-            }
-          }
-        }
-      }, {
-        "method": "kupChange",
-        "name": "kup-dropdownbutton-change",
-        "bubbles": true,
-        "cancelable": false,
-        "composed": true,
-        "docs": {
-          "tags": [],
-          "text": "Triggered when a list item changes."
-        },
-        "complexType": {
-          "original": "KupDropdownButtonEventPayload",
-          "resolved": "KupDropdownButtonEventPayload",
-          "references": {
-            "KupDropdownButtonEventPayload": {
-              "location": "import",
-              "path": "./kup-dropdown-button-declarations"
-            }
-          }
-        }
-      }, {
-        "method": "kupItemClick",
-        "name": "kup-dropdownbutton-itemclick",
-        "bubbles": true,
-        "cancelable": false,
-        "composed": true,
-        "docs": {
-          "tags": [],
-          "text": "Triggered when a list item is clicked."
-        },
-        "complexType": {
-          "original": "KupDropdownButtonEventPayload",
-          "resolved": "KupDropdownButtonEventPayload",
-          "references": {
-            "KupDropdownButtonEventPayload": {
-              "location": "import",
-              "path": "./kup-dropdown-button-declarations"
-            }
-          }
-        }
-      }];
-  }
-  static get methods() {
-    return {
-      "getProps": {
-        "complexType": {
-          "signature": "(descriptions?: boolean) => Promise<GenericObject>",
-          "parameters": [{
-              "tags": [{
-                  "name": "param",
-                  "text": "descriptions - When provided and true, the result will be the list of props with their description."
-                }],
-              "text": "- When provided and true, the result will be the list of props with their description."
-            }],
-          "references": {
-            "Promise": {
-              "location": "global"
-            },
-            "GenericObject": {
-              "location": "import",
-              "path": "../../types/GenericTypes"
-            }
-          },
-          "return": "Promise<GenericObject>"
-        },
-        "docs": {
-          "text": "Used to retrieve component's props values.",
-          "tags": [{
-              "name": "param",
-              "text": "descriptions - When provided and true, the result will be the list of props with their description."
-            }, {
-              "name": "returns",
-              "text": "List of props as object, each key will be a prop."
-            }]
-        }
-      },
-      "getValue": {
-        "complexType": {
-          "signature": "() => Promise<string>",
-          "parameters": [],
-          "references": {
-            "Promise": {
-              "location": "global"
-            }
-          },
-          "return": "Promise<string>"
-        },
-        "docs": {
-          "text": "Returns the component's internal value.",
-          "tags": []
-        }
-      },
-      "refresh": {
-        "complexType": {
-          "signature": "() => Promise<void>",
-          "parameters": [],
-          "references": {
-            "Promise": {
-              "location": "global"
-            }
-          },
-          "return": "Promise<void>"
-        },
-        "docs": {
-          "text": "This method is used to trigger a new render of the component.",
-          "tags": []
-        }
-      },
-      "setProps": {
-        "complexType": {
-          "signature": "(props: GenericObject) => Promise<void>",
-          "parameters": [{
-              "tags": [{
-                  "name": "param",
-                  "text": "props - Object containing props that will be set to the component."
-                }],
-              "text": "- Object containing props that will be set to the component."
-            }],
-          "references": {
-            "Promise": {
-              "location": "global"
-            },
-            "GenericObject": {
-              "location": "import",
-              "path": "../../types/GenericTypes"
-            }
-          },
-          "return": "Promise<void>"
-        },
-        "docs": {
-          "text": "Sets the props to the component.",
-          "tags": [{
-              "name": "param",
-              "text": "props - Object containing props that will be set to the component."
-            }]
-        }
-      },
-      "setValue": {
-        "complexType": {
-          "signature": "(value: string) => Promise<void>",
-          "parameters": [{
-              "tags": [],
-              "text": ""
-            }],
-          "references": {
-            "Promise": {
-              "location": "global"
-            }
-          },
-          "return": "Promise<void>"
-        },
-        "docs": {
-          "text": "Sets the internal value of the component.",
-          "tags": []
-        }
-      }
-    };
-  }
-  static get elementRef() { return "rootElement"; }
-  static get listeners() {
-    return [{
-        "name": "keydown",
-        "method": "listenKeydown",
-        "target": undefined,
-        "capture": false,
-        "passive": false
-      }];
-  }
-}
+import { forceUpdate, h, Host, } from '@stencil/core';
+import { kupManagerInstance, } from '../../managers/kup-manager/kup-manager';
+import { ItemsDisplayMode } from '../kup-list/kup-list-declarations';
+import { consistencyCheck } from '../kup-list/kup-list-helper';
+import { KupDropdownButtonProps, } from './kup-dropdown-button-declarations';
+import { FButtonStyling, } from '../../f-components/f-button/f-button-declarations';
+import { FButton } from '../../f-components/f-button/f-button';
+import { getProps, setProps } from '../../utils/utils';
+import { componentWrapperId } from '../../variables/GenericVariables';
+import { KupDynamicPositionPlacement } from '../../managers/kup-dynamic-position/kup-dynamic-position-declarations';
+export class KupDropdownButton {
+  constructor() {
+    /*-------------------------------------------------*/
+    /*       I n t e r n a l   V a r i a b l e s       */
+    /*-------------------------------------------------*/
+    /**
+     * Instance of the KupManager class.
+     */
+    this.kupManager = kupManagerInstance();
+    /**
+     * Primary button element.
+     */
+    this.buttonEl = null;
+    /**
+     * Dropdown button element.
+     */
+    this.dropdownEl = null;
+    /**
+     * List element (dropdown menu).
+     */
+    this.listEl = null;
+    this.clickCb = null;
+    this.id = '';
+    this.customStyle = '';
+    this.data = null;
+    this.disabled = false;
+    this.displayMode = ItemsDisplayMode.DESCRIPTION;
+    this.dropdownOnly = false;
+    this.icon = null;
+    this.initialValue = '';
+    this.label = null;
+    this.selectMode = ItemsDisplayMode.CODE;
+    this.styling = FButtonStyling.RAISED;
+    this.trailingIcon = false;
+  }
+  /**
+   * Handles the navigation of the dropdown menu with the keyboard.
+   */
+  listenKeydown(e) {
+    if (this.isListOpened()) {
+      switch (e.key) {
+        case 'ArrowDown':
+          e.preventDefault();
+          e.stopPropagation();
+          this.listEl.focusNext();
+          break;
+        case 'ArrowUp':
+          e.preventDefault();
+          e.stopPropagation();
+          this.listEl.focusPrevious();
+          break;
+        case 'Enter':
+          e.preventDefault();
+          e.stopPropagation();
+          this.listEl.select().then(() => {
+            this.closeList();
+          });
+          this.dropdownEl.focus();
+          break;
+        case 'Escape':
+          e.preventDefault();
+          e.stopPropagation();
+          this.closeList();
+          break;
+      }
+    }
+    else {
+      switch (e.key) {
+        case 'ArrowDown':
+          e.preventDefault();
+          e.stopPropagation();
+          this.openList();
+          this.listEl.focusNext();
+          break;
+        case 'ArrowUp':
+          e.preventDefault();
+          e.stopPropagation();
+          this.openList();
+          this.listEl.focusPrevious();
+          break;
+      }
+    }
+  }
+  onKupBlur() {
+    this.closeList();
+    this.kupBlur.emit({
+      comp: this,
+      id: this.rootElement.id,
+      value: this.id,
+    });
+  }
+  onKupClick() {
+    this.closeList();
+    this.kupClick.emit({
+      comp: this,
+      id: this.rootElement.id,
+      value: this.id,
+    });
+  }
+  onKupFocus() {
+    this.kupFocus.emit({
+      comp: this,
+      id: this.rootElement.id,
+      value: this.id,
+    });
+  }
+  onDropDownClick() {
+    if (this.isListOpened()) {
+      this.closeList();
+    }
+    else {
+      this.openList();
+    }
+  }
+  onKupItemClick(e) {
+    this.consistencyCheck(e);
+    this.closeList();
+    this.kupChange.emit({
+      comp: this,
+      id: this.rootElement.id,
+      value: this.id,
+    });
+    this.kupItemClick.emit({
+      comp: this,
+      id: this.rootElement.id,
+      value: this.id,
+    });
+  }
+  /*-------------------------------------------------*/
+  /*           P u b l i c   M e t h o d s           */
+  /*-------------------------------------------------*/
+  /**
+   * Used to retrieve component's props values.
+   * @param {boolean} descriptions - When provided and true, the result will be the list of props with their description.
+   * @returns {Promise<GenericObject>} List of props as object, each key will be a prop.
+   */
+  async getProps(descriptions) {
+    return getProps(this, KupDropdownButtonProps, descriptions);
+  }
+  /**
+   * Returns the component's internal value.
+   */
+  async getValue() {
+    return this.id;
+  }
+  /**
+   * This method is used to trigger a new render of the component.
+   */
+  async refresh() {
+    forceUpdate(this);
+  }
+  /**
+   * Sets the props to the component.
+   * @param {GenericObject} props - Object containing props that will be set to the component.
+   */
+  async setProps(props) {
+    setProps(this, KupDropdownButtonProps, props);
+  }
+  /**
+   * Sets the internal value of the component.
+   */
+  async setValue(value) {
+    this.id = value;
+  }
+  /*-------------------------------------------------*/
+  /*           P r i v a t e   M e t h o d s         */
+  /*-------------------------------------------------*/
+  /**
+   * Checks whether the dropdown menu is opened or not.
+   * @returns {boolean} True when the list is opened.
+   */
+  isListOpened() {
+    if (this.listEl == null) {
+      return false;
+    }
+    return this.listEl.menuVisible == true;
+  }
+  /**
+   * Opens the dropdown menu.
+   */
+  openList() {
+    var _a;
+    const buttonWidth = (this.buttonEl ? this.buttonEl.clientWidth : 0) +
+      this.dropdownEl.clientWidth;
+    (_a = this.buttonEl) === null || _a === void 0 ? void 0 : _a.classList.add('toggled');
+    this.dropdownEl.classList.add('toggled');
+    this.listEl.menuVisible = true;
+    const elStyle = this.listEl.style;
+    elStyle.height = 'auto';
+    elStyle.minWidth = buttonWidth + 'px';
+    if (this.kupManager.dynamicPosition.isRegistered(this.listEl)) {
+      this.kupManager.dynamicPosition.changeAnchor(this.listEl, this.buttonEl ? this.buttonEl : this.dropdownEl);
+    }
+    else {
+      this.kupManager.dynamicPosition.register(this.listEl, this.buttonEl ? this.buttonEl : this.dropdownEl, 0, KupDynamicPositionPlacement.AUTO, true);
+    }
+    this.kupManager.dynamicPosition.start(this.listEl);
+    if (!this.clickCb) {
+      this.clickCb = {
+        cb: () => {
+          this.closeList();
+        },
+        el: this.listEl,
+      };
+    }
+    this.kupManager.addClickCallback(this.clickCb, true);
+  }
+  /**
+   * Closes the dropdown menu.
+   */
+  closeList() {
+    var _a;
+    (_a = this.buttonEl) === null || _a === void 0 ? void 0 : _a.classList.remove('toggled');
+    this.dropdownEl.classList.remove('toggled');
+    this.listEl.menuVisible = false;
+    this.kupManager.dynamicPosition.stop(this.listEl);
+    this.kupManager.removeClickCallback(this.clickCb);
+  }
+  /**
+   * Checks the consistency of the list.
+   */
+  consistencyCheck(e, idIn) {
+    const ret = consistencyCheck(idIn, this.data['kup-list'], this.listEl, this.selectMode, this.displayMode, e);
+    this.id = ret.value;
+  }
+  /*-------------------------------------------------*/
+  /*          L i f e c y c l e   H o o k s          */
+  /*-------------------------------------------------*/
+  componentWillLoad() {
+    this.kupManager.debug.logLoad(this, false);
+    this.kupManager.theme.register(this);
+    this.id = this.initialValue;
+    if (!this.data) {
+      this.data = {
+        'kup-list': {},
+      };
+    }
+  }
+  componentDidLoad() {
+    this.consistencyCheck(undefined, this.id);
+    this.kupManager.debug.logLoad(this, true);
+  }
+  componentWillRender() {
+    this.kupManager.debug.logRender(this, false);
+  }
+  componentDidRender() {
+    const root = this.rootElement.shadowRoot;
+    if (root && (!this.buttonEl || !this.dropdownEl)) {
+      this.buttonEl = root.querySelector('.dropdown-button__primary-action');
+      this.dropdownEl = root.querySelector('.dropdown-button__dropdown-action');
+    }
+    this.kupManager.debug.logRender(this, true);
+  }
+  renderButtons() {
+    const buttons = [];
+    const props = {
+      disabled: this.disabled ? true : false,
+      large: this.rootElement.classList.contains('kup-large')
+        ? true
+        : false,
+      pulsating: this.rootElement.classList.contains('kup-pulsating')
+        ? true
+        : false,
+      slim: this.rootElement.classList.contains('kup-slim')
+        ? true
+        : false,
+      styling: this.styling ? this.styling : FButtonStyling.RAISED,
+      title: this.rootElement.title,
+    };
+    if (!this.dropdownOnly) {
+      buttons.push(h(FButton, Object.assign({}, props, { icon: this.icon ? this.icon : null, label: this.label ? this.label : null, trailingIcon: this.trailingIcon ? true : false, wrapperClass: "dropdown-button__primary-action", onClick: () => this.onKupClick(), onBlur: () => this.onKupBlur(), onFocus: () => this.onKupFocus() })));
+    }
+    buttons.push(h(FButton, Object.assign({}, props, { disabled: this.disabled ? true : false, icon: this.dropdownOnly && this.icon && this.icon !== ''
+        ? this.icon
+        : 'arrow_drop_down', label: " ", wrapperClass: 'dropdown-button__dropdown-action' +
+        (this.dropdownOnly ? ' dropdown-only' : ''), onClick: () => this.onDropDownClick() })));
+    return buttons;
+  }
+  render() {
+    return (h(Host, null, h("style", null, this.kupManager.theme.setKupStyle(this.rootElement)), h("div", { id: componentWrapperId }, h("div", { class: "dropdown-button--wrapper" }, this.renderButtons()), h("kup-list", Object.assign({}, this.data['kup-list'], { displayMode: this.displayMode, isMenu: true, "onkup-list-click": (e) => this.onKupItemClick(e), id: this.rootElement.id + '_list', ref: (el) => (this.listEl = el) })))));
+  }
+  disconnectedCallback() {
+    if (this.listEl) {
+      this.kupManager.dynamicPosition.unregister([this.listEl]);
+      this.listEl.remove();
+    }
+    this.kupManager.theme.unregister(this);
+  }
+  static get is() { return "kup-dropdown-button"; }
+  static get encapsulation() { return "shadow"; }
+  static get originalStyleUrls() {
+    return {
+      "$": ["kup-dropdown-button.scss"]
+    };
+  }
+  static get styleUrls() {
+    return {
+      "$": ["kup-dropdown-button.css"]
+    };
+  }
+  static get properties() {
+    return {
+      "customStyle": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "\"\""
+            }, {
+              "name": "see",
+              "text": "https://ketchup.smeup.com/ketchup-showcase/#/customization"
+            }],
+          "text": "Custom style of the component."
+        },
+        "attribute": "custom-style",
+        "reflect": false,
+        "defaultValue": "''"
+      },
+      "data": {
+        "type": "unknown",
+        "mutable": false,
+        "complexType": {
+          "original": "Object",
+          "resolved": "Object",
+          "references": {
+            "Object": {
+              "location": "global"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "null"
+            }],
+          "text": "Props of the sub-components."
+        },
+        "defaultValue": "null"
+      },
+      "disabled": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "false"
+            }],
+          "text": "Defaults at false. When set to true, the component is disabled."
+        },
+        "attribute": "disabled",
+        "reflect": false,
+        "defaultValue": "false"
+      },
+      "displayMode": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "ItemsDisplayMode",
+          "resolved": "ItemsDisplayMode.CODE | ItemsDisplayMode.DESCRIPTION | ItemsDisplayMode.DESCRIPTION_AND_CODE",
+          "references": {
+            "ItemsDisplayMode": {
+              "location": "import",
+              "path": "../kup-list/kup-list-declarations"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "ItemsDisplayMode.DESCRIPTION"
+            }],
+          "text": "Sets how to show the selected item value. Suported values: \"code\", \"description\", \"both\"."
+        },
+        "attribute": "display-mode",
+        "reflect": false,
+        "defaultValue": "ItemsDisplayMode.DESCRIPTION"
+      },
+      "dropdownOnly": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "false"
+            }],
+          "text": "Default value is false. When set to true, the arrow dropdown button is the only button displayed."
+        },
+        "attribute": "dropdown-only",
+        "reflect": false,
+        "defaultValue": "false"
+      },
+      "icon": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "icon"
+            }],
+          "text": "Defaults at null. When set, the button will show this icon."
+        },
+        "attribute": "icon",
+        "reflect": false,
+        "defaultValue": "null"
+      },
+      "initialValue": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "\"\""
+            }],
+          "text": "Sets the initial value of the component."
+        },
+        "attribute": "initial-value",
+        "reflect": false,
+        "defaultValue": "''"
+      },
+      "label": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "\"\""
+            }],
+          "text": "Defaults at null. When set, the button will show this text."
+        },
+        "attribute": "label",
+        "reflect": false,
+        "defaultValue": "null"
+      },
+      "selectMode": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "ItemsDisplayMode",
+          "resolved": "ItemsDisplayMode.CODE | ItemsDisplayMode.DESCRIPTION | ItemsDisplayMode.DESCRIPTION_AND_CODE",
+          "references": {
+            "ItemsDisplayMode": {
+              "location": "import",
+              "path": "../kup-list/kup-list-declarations"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "ItemsDisplayMode.CODE"
+            }],
+          "text": "Sets how to return the selected item value. Suported values: \"code\", \"description\", \"both\"."
+        },
+        "attribute": "select-mode",
+        "reflect": false,
+        "defaultValue": "ItemsDisplayMode.CODE"
+      },
+      "styling": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "FButtonStyling",
+          "resolved": "FButtonStyling.FLAT | FButtonStyling.FLOATING | FButtonStyling.ICON | FButtonStyling.OUTLINED | FButtonStyling.RAISED",
+          "references": {
+            "FButtonStyling": {
+              "location": "import",
+              "path": "../../f-components/f-button/f-button-declarations"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "FButtonStyling.RAISED"
+            }],
+          "text": "Defines the style of the button. Styles available: \"flat\", \"outlined\" and \"raised\" which is also the default."
+        },
+        "attribute": "styling",
+        "reflect": false,
+        "defaultValue": "FButtonStyling.RAISED"
+      },
+      "trailingIcon": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "false"
+            }],
+          "text": "Defaults at null. When set, the icon will be shown after the text."
+        },
+        "attribute": "trailing-icon",
+        "reflect": false,
+        "defaultValue": "false"
+      }
+    };
+  }
+  static get states() {
+    return {
+      "id": {}
+    };
+  }
+  static get events() {
+    return [{
+        "method": "kupBlur",
+        "name": "kup-dropdownbutton-blur",
+        "bubbles": true,
+        "cancelable": false,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Triggered when the primary button loses focus."
+        },
+        "complexType": {
+          "original": "KupDropdownButtonEventPayload",
+          "resolved": "KupDropdownButtonEventPayload",
+          "references": {
+            "KupDropdownButtonEventPayload": {
+              "location": "import",
+              "path": "./kup-dropdown-button-declarations"
+            }
+          }
+        }
+      }, {
+        "method": "kupClick",
+        "name": "kup-dropdownbutton-click",
+        "bubbles": true,
+        "cancelable": false,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Triggered when the primary button is clicked."
+        },
+        "complexType": {
+          "original": "KupDropdownButtonEventPayload",
+          "resolved": "KupDropdownButtonEventPayload",
+          "references": {
+            "KupDropdownButtonEventPayload": {
+              "location": "import",
+              "path": "./kup-dropdown-button-declarations"
+            }
+          }
+        }
+      }, {
+        "method": "kupFocus",
+        "name": "kup-dropdownbutton-focus",
+        "bubbles": true,
+        "cancelable": false,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Triggered when the primary button is focused."
+        },
+        "complexType": {
+          "original": "KupDropdownButtonEventPayload",
+          "resolved": "KupDropdownButtonEventPayload",
+          "references": {
+            "KupDropdownButtonEventPayload": {
+              "location": "import",
+              "path": "./kup-dropdown-button-declarations"
+            }
+          }
+        }
+      }, {
+        "method": "kupChange",
+        "name": "kup-dropdownbutton-change",
+        "bubbles": true,
+        "cancelable": false,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Triggered when a list item changes."
+        },
+        "complexType": {
+          "original": "KupDropdownButtonEventPayload",
+          "resolved": "KupDropdownButtonEventPayload",
+          "references": {
+            "KupDropdownButtonEventPayload": {
+              "location": "import",
+              "path": "./kup-dropdown-button-declarations"
+            }
+          }
+        }
+      }, {
+        "method": "kupItemClick",
+        "name": "kup-dropdownbutton-itemclick",
+        "bubbles": true,
+        "cancelable": false,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Triggered when a list item is clicked."
+        },
+        "complexType": {
+          "original": "KupDropdownButtonEventPayload",
+          "resolved": "KupDropdownButtonEventPayload",
+          "references": {
+            "KupDropdownButtonEventPayload": {
+              "location": "import",
+              "path": "./kup-dropdown-button-declarations"
+            }
+          }
+        }
+      }];
+  }
+  static get methods() {
+    return {
+      "getProps": {
+        "complexType": {
+          "signature": "(descriptions?: boolean) => Promise<GenericObject>",
+          "parameters": [{
+              "tags": [{
+                  "name": "param",
+                  "text": "descriptions - When provided and true, the result will be the list of props with their description."
+                }],
+              "text": "- When provided and true, the result will be the list of props with their description."
+            }],
+          "references": {
+            "Promise": {
+              "location": "global"
+            },
+            "GenericObject": {
+              "location": "import",
+              "path": "../../types/GenericTypes"
+            }
+          },
+          "return": "Promise<GenericObject>"
+        },
+        "docs": {
+          "text": "Used to retrieve component's props values.",
+          "tags": [{
+              "name": "param",
+              "text": "descriptions - When provided and true, the result will be the list of props with their description."
+            }, {
+              "name": "returns",
+              "text": "List of props as object, each key will be a prop."
+            }]
+        }
+      },
+      "getValue": {
+        "complexType": {
+          "signature": "() => Promise<string>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<string>"
+        },
+        "docs": {
+          "text": "Returns the component's internal value.",
+          "tags": []
+        }
+      },
+      "refresh": {
+        "complexType": {
+          "signature": "() => Promise<void>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "This method is used to trigger a new render of the component.",
+          "tags": []
+        }
+      },
+      "setProps": {
+        "complexType": {
+          "signature": "(props: GenericObject) => Promise<void>",
+          "parameters": [{
+              "tags": [{
+                  "name": "param",
+                  "text": "props - Object containing props that will be set to the component."
+                }],
+              "text": "- Object containing props that will be set to the component."
+            }],
+          "references": {
+            "Promise": {
+              "location": "global"
+            },
+            "GenericObject": {
+              "location": "import",
+              "path": "../../types/GenericTypes"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Sets the props to the component.",
+          "tags": [{
+              "name": "param",
+              "text": "props - Object containing props that will be set to the component."
+            }]
+        }
+      },
+      "setValue": {
+        "complexType": {
+          "signature": "(value: string) => Promise<void>",
+          "parameters": [{
+              "tags": [],
+              "text": ""
+            }],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Sets the internal value of the component.",
+          "tags": []
+        }
+      }
+    };
+  }
+  static get elementRef() { return "rootElement"; }
+  static get listeners() {
+    return [{
+        "name": "keydown",
+        "method": "listenKeydown",
+        "target": undefined,
+        "capture": false,
+        "passive": false
+      }];
+  }
+}