@watermarkinsights/ripple 3.15.0-2 → 3.16.0-0

package/dist/collection/components/wm-tag-input/wm-tag-input.js

@@ -1,5 +1,5 @@
-import { h, Component, Host, Element, Prop, Listen, State, Event, Watch } from "@stencil/core";
-import { generateId, shouldOpenUp, intl, debounce } from "../../global/functions";
+import { h, Component, Host, Element, Prop, Listen, State, Event, Watch, forceUpdate, } from "@stencil/core";
+import { csvToArray, generateId, shouldOpenUp, intl, debounce, showTooltip, hideTooltip } from "../../global/functions";
 export class TagInput {
   constructor() {
     this.labelPosition = "top";
@@ -7,11 +7,14 @@ export class TagInput {
     this.selectedTags = ""; // csv
     this.addNew = true;
     this.characterLimit = 50;
+    this.tagInputType = "dropdown";
     this.uid = this.el.id ? this.el.id : generateId();
     this.openUp = false;
+    this.tooltipVisible = false;
+    this.tablePosition = { row: 0, column: 1 };
     this.isExpanded = false;
-    this.tagsList = this.csvToArray(this.selectedTags);
-    this.optionsList = this.csvToArray(this.options);
+    this.tagsList = csvToArray(this.selectedTags);
+    this.optionsList = csvToArray(this.options);
     this.charCount = 0;
     this.liveRegionMessage = "";
     this.tagAreaInstructions = intl.formatMessage({
@@ -38,6 +41,25 @@ export class TagInput {
   get optionEls() {
     return Array.from(this.dropdownEl.querySelectorAll(".option"));
   }
+  get wmRowEls() {
+    return Array.from(this.el.querySelectorAll("wm-tag-input-row"));
+  }
+  get localRowEls() {
+    return Array.from(this.el.shadowRoot.querySelectorAll("tr"));
+  }
+  get filteredRows() {
+    return this.wmRowEls.filter((row) => {
+      const colValues = [row.col1, row.col2, row.col3, row.col4].join("").toLowerCase();
+      return this.inputEl && this.inputEl.value.toLowerCase() ? colValues.includes(this.inputEl.value) : true;
+    });
+  }
+  get noResultsMessage() {
+    return intl.formatMessage({
+      id: "tagInput.noResults",
+      defaultMessage: "No results match your search.",
+      description: "Message displayed when a user's search returns empty.",
+    });
+  }
   generateTagAddedMessage(tag) {
     return intl.formatMessage({
       id: "tagInput.tagAdded",
@@ -100,7 +122,7 @@ export class TagInput {
         this.options += `${this.options.length > 0 ? "," : ""}${tag}`;
       }
     });
-    this.optionsList = this.csvToArray(this.options);
+    this.optionsList = csvToArray(this.options);
   }
   createPlaceholderDefault(addNew, hasOptions) {
     const addAndSearchPlaceholder = intl.formatMessage({
@@ -134,12 +156,25 @@ export class TagInput {
     this.selectedTags = this.listToCSV(this.tagsList);
     this.wmTagInputChanged.emit({ value: this.tagsList });
   }
+  handleRowUpdate() {
+    forceUpdate(this.el);
+  }
   closeIfNotElOrChild(ev) {
     const isntElOrChild = ev.target !== this.el && !this.el.shadowRoot.contains(ev.target);
-    if (isntElOrChild && this.isExpanded) {
+    if (this.tagInputType === "dropdown" && isntElOrChild && this.isExpanded) {
       this.closeDropdown();
     }
   }
+  // From wm-button
+  // we need to listen for scroll events during the capture phase because they do not bubble up
+  // there can be layouts where the main content has 100vh and overflows
+  // in these cases window will register no scroll events unless we catch on they way down
+  dismissTooltip() {
+    if (this.tooltipVisible) {
+      hideTooltip();
+      this.tooltipVisible = false;
+    }
+  }
   handleResize() {
     this.debouncedResize();
   }
@@ -153,7 +188,7 @@ export class TagInput {
       case "Enter":
       case ",":
         ev.preventDefault();
-        this.submitInput(this.addNew, this.inputEl.value.trim());
+        this.handleInputEnter();
         break;
       case "ArrowDown":
         ev.preventDefault();
@@ -163,8 +198,20 @@ export class TagInput {
         ev.preventDefault();
         this.handleInputArrowUp();
         break;
+      case "ArrowLeft":
+        ev.preventDefault();
+        if (this.tagInputType === "table" && this.tablePosition.row) {
+          this.moveLeftCell();
+        }
+        break;
+      case "ArrowRight":
+        ev.preventDefault();
+        if (this.tagInputType === "table" && this.tablePosition.row) {
+          this.moveRightCell();
+        }
+        break;
       case "Escape":
-        if (this.isExpanded) {
+        if (this.tagInputType === "dropdown" && this.isExpanded) {
           this.closeDropdown();
         }
         break;
@@ -174,41 +221,71 @@ export class TagInput {
         break;
     }
   }
+  handleInputFocus() {
+    if (this.tagInputType === "dropdown") {
+      this.openDropdown();
+      this.clearListItemFocus();
+    }
+    // force update needed to apply styled state of field-wrapper el
+    forceUpdate(this.el);
+  }
   handleInputChanged(value) {
     this.charCount = value.length;
-    if (this.charCount >= this.characterLimit - 5) {
-      this.announceCharacterLimitWarning(this.charCount, this.characterLimit);
+    if (this.tagInputType === "dropdown") {
+      this.clearListItemFocus();
+      if (this.charCount >= this.characterLimit - 5) {
+        this.announceCharacterLimitWarning(this.charCount, this.characterLimit);
+      }
+      if (!this.isExpanded) {
+        this.openDropdown();
+      }
+    }
+    else if (this.tagInputType === "table") {
+      this.clearCellFocus();
+      this.tablePosition = { row: 0, column: 1 };
     }
     this.announceExistingOptions();
-    if (!this.isExpanded) {
-      this.openDropdown();
+  }
+  handleInputEnter() {
+    if (this.tagInputType === "dropdown") {
+      if (this.focusedListItem) {
+        this.handleListItemClick(this.focusedListItem);
+      }
+      else {
+        this.submitInput(this.addNew, this.inputEl.value.trim());
+      }
+    }
+    else if (this.tagInputType === "table" && this.tablePosition.row > 0) {
+      this.handleTableRowClick(this.localRowEls[this.tablePosition.row].id);
     }
   }
   submitInput(canAddNew, value) {
     const hasNonWhiteSpaceCharacters = value.match(/\S/);
     if (canAddNew && hasNonWhiteSpaceCharacters) {
-      this.tagsList = this.addTag(value);
+      this.addTag(value);
       this.optionsList = this.addOption(value);
       this.resetInput();
-      // if maxTags has been reached, focus should go to the tagArea instead of the input
-      if (this.maxTags && this.tagsList.length >= this.maxTags) {
-        this.tagAreaEl.focus();
-      }
     }
   }
   handleInputArrowDown() {
-    if (this.isExpanded) {
+    if (this.tagInputType === "table") {
+      this.moveDownRow();
+    }
+    else if (this.tagInputType === "dropdown" && this.isExpanded) {
       this.moveDownListItem();
     }
-    else {
+    else if (this.tagInputType === "dropdown") {
       this.openDropdown();
     }
   }
   handleInputArrowUp() {
-    if (this.isExpanded) {
+    if (this.tagInputType === "table") {
+      this.moveUpRow();
+    }
+    else if (this.tagInputType === "dropdown" && this.isExpanded) {
       this.moveUpListItem();
     }
-    else {
+    else if (this.tagInputType === "dropdown") {
       this.openDropdown();
     }
   }
@@ -242,27 +319,37 @@ export class TagInput {
         if (this.focusedElement !== this.inputEl) {
           this.inputEl.focus();
         }
-        else {
+        else if (this.tagInputType === "dropdown") {
           this.closeDropdown();
         }
         break;
     }
   }
-  handleListItemClick(ev) {
-    const typedEvTarget = ev.target;
-    const tag = typedEvTarget.dataset.option.trim() || "";
+  handleListItemClick(item) {
+    const tag = item.dataset.option.trim() || "";
     if (this.includesCaseInsensitive(this.tagsList, tag)) {
       this.announce(this.generateTagAlreadyAddedMessage(tag));
     }
     else {
       this.announce(this.generateTagAddedMessage(tag));
       this.resetInput();
-      this.tagsList = this.addTag(tag);
+      this.addTag(tag);
       this.optionsList = this.addOption(tag);
       this.focusedListItem = null;
-      // if maxTags has been reached, focus should go to the tagArea instead of the input
-      const elementToFocus = this.maxTags && this.tagsList.length >= this.maxTags ? this.tagAreaEl : this.inputEl;
-      elementToFocus.focus();
+    }
+  }
+  handleTableRowClick(rowId) {
+    const referencedRow = this.el.querySelector(`#${rowId}`);
+    const tagText = referencedRow.col1;
+    const isLocked = referencedRow.locked;
+    if (!isLocked) {
+      if (this.includesCaseInsensitive(this.tagsList, rowId)) {
+        this.removeTag(rowId);
+      }
+      else {
+        this.announce(this.generateTagAddedMessage(tagText));
+        this.addTag(rowId);
+      }
     }
   }
   handleTagAreaKeyDown(ev) {
@@ -284,7 +371,8 @@ export class TagInput {
     }
   }
   handleTagAreaDelete() {
-    if (this.focusedTag && this.focusedTag.dataset.tag) {
+    const isLocked = this.focusedTag && this.focusedTag.classList.contains("locked");
+    if (this.focusedTag && this.focusedTag.dataset.tag && !isLocked) {
       this.removeTag(this.focusedTag.dataset.tag);
       if (this.tagsList.length === 0) {
         // focus input if no tags are left
@@ -299,13 +387,29 @@ export class TagInput {
   }
   handleBlur(ev, component) {
     const isntElOrChild = ev.relatedTarget !== component && !this.el.shadowRoot.contains(ev.relatedTarget);
+    this.dismissTooltip();
+    this.tablePosition = { row: 0, column: 1 };
+    this.clearCellFocus();
     if (isntElOrChild) {
-      this.closeDropdown();
       this.fieldWrapperEl.classList.remove("focused");
+      if (this.tagInputType === "dropdown") {
+        this.closeDropdown();
+      }
+    }
+  }
+  handleCellMouseEnter(ev) {
+    const cell = ev.target;
+    const isTruncated = cell.scrollWidth > cell.clientWidth;
+    if (isTruncated) {
+      // innerText is necessary vs textContent, as innerText ignores sr-only / display: none text
+      showTooltip("bottom", cell, cell.innerText);
+      this.tooltipVisible = true;
     }
   }
   handleTagAreaFocus() {
-    this.closeDropdown();
+    if (this.tagInputType === "dropdown") {
+      this.closeDropdown();
+    }
     if (!this.focusedTag) {
       this.focusedTag = this.tagEls[0];
     }
@@ -339,11 +443,72 @@ export class TagInput {
         this.focusListItem(this.focusedListItem.previousElementSibling);
       }
       else {
-        this.focusedListItem = null;
-        this.inputEl.focus();
+        this.clearListItemFocus();
       }
     }
   }
+  moveDownRow() {
+    if (this.filteredRows.length > 0) {
+      if (this.tablePosition.row === 0) {
+        this.tablePosition.row = 1;
+      }
+      else if (this.tablePosition.row === this.filteredRows.length) {
+        this.tablePosition.row = 1;
+      }
+      else {
+        this.tablePosition.row++;
+      }
+      this.focusCell(this.tablePosition);
+    }
+  }
+  moveUpRow() {
+    if (this.filteredRows.length > 0) {
+      if (this.tablePosition.row === 0) {
+        this.tablePosition.row = this.filteredRows.length;
+      }
+      else if (this.tablePosition.row === 1) {
+        this.tablePosition.row = 0;
+      }
+      else {
+        this.tablePosition.row--;
+      }
+      this.focusCell(this.tablePosition);
+    }
+  }
+  moveLeftCell() {
+    const numCols = csvToArray(this.colHeaders).length;
+    if (this.tablePosition.column === 1 && this.tablePosition.row === 1) {
+      // if in first cell in first row, focus the input
+      this.tablePosition.row = 0;
+    }
+    else if (this.tablePosition.column === 1) {
+      // if in first cell, focus last cell of previous row
+      this.tablePosition.row--;
+      this.tablePosition.column = numCols;
+    }
+    else {
+      this.tablePosition.column--;
+    }
+    this.focusCell(this.tablePosition);
+  }
+  moveRightCell() {
+    const numRows = this.filteredRows.length;
+    const numCols = csvToArray(this.colHeaders).length;
+    if (this.tablePosition.column === numCols && this.tablePosition.row === numRows) {
+      // if in last cell in last row, focus the first cell
+      this.tablePosition.row = 1;
+      this.tablePosition.column = 1;
+    }
+    else if (this.tablePosition.column === numCols) {
+      // if in last cell, focus first cell of next row
+      this.tablePosition.row++;
+      this.tablePosition.column = 1;
+    }
+    else {
+      this.tablePosition.column++;
+    }
+    this.focusCell(this.tablePosition);
+  }
   moveLeftTag() {
     const lastTag = this.tagEls[this.tagEls.length - 1];
     if (this.focusedTag && this.tagEls.includes(this.focusedTag.previousElementSibling)) {
@@ -381,44 +546,79 @@ export class TagInput {
     const tagExistsAsOption = this.optionsList.filter((x) => x.toLowerCase() === tag.toLowerCase())[0];
     if (!tagAlreadyAdded) {
       this.announce(this.generateTagAddedMessage(tag));
-      newTagsList = newTagsList.concat(tagExistsAsOption || tag);
+      this.tagsList = newTagsList.concat(tagExistsAsOption || tag);
+      // if maxTags has been reached, focus should go to the tagArea
+      if (this.maxTags && this.tagsList.length >= this.maxTags) {
+        this.tagAreaEl.focus();
+      }
     }
-    return newTagsList;
   }
   removeTag(tag) {
     const tagRemovedMessage = intl.formatMessage({ id: "tagInput.tagRemoved", defaultMessage: "{tag} removed" }, { tag: tag });
     this.announce(tagRemovedMessage);
     this.tagsList = this.filterCaseInsensitive(this.tagsList, tag);
-    const devOptionsList = this.csvToArray(this.options);
-    if (this.includesCaseInsensitive(this.optionsList, tag) && !this.includesCaseInsensitive(devOptionsList, tag)) {
-      this.removeOption(tag);
+    if (this.tagInputType === "dropdown") {
+      // if a tag was introduced by the user, also remove it from the dropdown options
+      const devOptionsList = csvToArray(this.options);
+      if (this.includesCaseInsensitive(this.optionsList, tag) && !this.includesCaseInsensitive(devOptionsList, tag)) {
+        this.removeOption(tag);
+      }
     }
   }
   focusListItem(item) {
     this.focusedListItem = item;
-    item.focus();
+    this.inputEl.setAttribute("aria-activedescendant", this.focusedListItem.id);
+    item.scrollIntoView({ block: "nearest" });
   }
   focusTag(element) {
     this.focusedTag = element;
     this.tagAreaEl.setAttribute("aria-activedescendant", this.focusedTag.id);
   }
+  focusCell(position) {
+    this.clearCellFocus();
+    if (position.row) {
+      const rowToFocus = this.localRowEls[position.row];
+      const rowCells = rowToFocus.querySelectorAll("td");
+      const cellToFocus = rowCells[position.column - 1];
+      const isTruncated = cellToFocus.scrollWidth > cellToFocus.clientWidth;
+      rowToFocus.classList.add("focused");
+      cellToFocus.classList.add("focused");
+      cellToFocus.scrollIntoView({ block: "nearest" });
+      this.inputEl.setAttribute("aria-activedescendant", cellToFocus.id);
+      this.dismissTooltip();
+      if (isTruncated) {
+        // innerText is necessary vs textContent, as innerText ignores sr-only / display: none text
+        showTooltip("bottom", cellToFocus, cellToFocus.innerText);
+        this.tooltipVisible = true;
+      }
+    }
+  }
   clearTagFocus() {
-    this.tagAreaEl.removeAttribute("aria-activedescendant");
+    this.tagAreaEl.setAttribute("aria-activedescendant", "");
     this.focusedTag = null;
   }
+  clearCellFocus() {
+    this.inputEl.setAttribute("aria-activedescendant", "");
+    this.localRowEls.forEach((row) => {
+      row.classList.remove("focused");
+      row.querySelectorAll("td").forEach((cell) => {
+        cell.classList.remove("focused");
+      });
+    });
+  }
   openDropdown() {
     // given an offset of -2px because the dropdown is transformed downwards to avoid overlapping the focus border
     this.openUp = shouldOpenUp(this.el, this.dropdownEl, this.el.clientHeight, -2);
     this.isExpanded = true;
   }
   closeDropdown() {
-    this.focusedListItem = null;
+    this.clearListItemFocus();
     this.isExpanded = false;
   }
   clearListItemFocus() {
     this.focusedListItem = null;
+    this.inputEl.setAttribute("aria-activedescendant", "");
     this.listItemEls.forEach((el) => {
-      el.tabIndex = -1;
       el.classList.remove("focused");
     });
   }
@@ -436,11 +636,18 @@ export class TagInput {
   announceExistingOptions() {
     // request animation frame to wait for re-rendering of filtered options
     window.requestAnimationFrame(() => {
+      let numResults = 0;
+      if (this.tagInputType === "dropdown") {
+        numResults = this.optionEls.length;
+      }
+      else if (this.tagInputType === "table") {
+        numResults = this.filteredRows.length;
+      }
       const existingOptionsMessage = intl.formatMessage({
         id: "tagInput.existingOptions",
         defaultMessage: "{num, plural, one {1 existing option.} other {# existing options.}}",
-      }, { num: this.optionEls.length });
-      if (this.optionEls.length > 0) {
+      }, { num: numResults });
+      if (numResults > 0) {
         this.announce(existingOptionsMessage);
       }
     });
@@ -480,9 +687,6 @@ export class TagInput {
   listToCSV(list) {
     return list.join(",");
   }
-  csvToArray(csv) {
-    return csv ? csv.split(/, ?/) : [];
-  }
   includesCaseInsensitive(list, element) {
     const lowercaseList = list.map((str) => str.toLowerCase());
     return lowercaseList.includes(element.toLowerCase());
@@ -503,11 +707,30 @@ export class TagInput {
   renderTags() {
     return this.tagsList.map((tag, idx) => {
       const id = `tag${idx + 1}`;
-      return (h("li", { id: id, class: `tag highlight ${this.focusedTag && this.focusedTag.id === id ? "focused" : ""}`, "data-tag": tag, role: "option" },
-        tag,
-        h("button", { class: "remove-btn", tabIndex: -1, onClick: () => this.handleRemoveButtonClick(tag) })));
+      let tagText = "";
+      let isLocked = false;
+      if (this.tagInputType === "dropdown") {
+        tagText = tag;
+      }
+      else if (this.tagInputType === "table") {
+        // display table tags using col1 of the row with the same id
+        // if one can't be found, display as empty
+        const referencedRow = this.el.querySelector(`#${tag}`);
+        tagText = referencedRow ? referencedRow.col1 : "";
+        isLocked = referencedRow.locked;
+      }
+      return (h("li", { id: id, class: `tag highlight ${this.focusedTag && this.focusedTag.id === id ? "focused" : ""} ${isLocked ? "locked" : ""}`, "data-tag": tag, role: "option" },
+        tagText,
+        isLocked ? (h("div", { class: "icon lock" })) : (h("button", { class: "icon remove-btn", tabIndex: -1, onClick: () => this.handleRemoveButtonClick(tag) }))));
     });
   }
+  renderDropdown() {
+    return (h("div", { class: `dropdown-wrapper ${this.isExpanded ? "open" : ""} ${this.openUp ? "upwards" : ""}`, ref: (el) => (this.dropdownEl = el) },
+      h("div", { id: "help-text", class: "help-text" }, this.renderHelpText()),
+      h("ul", { class: "dropdown", id: "dropdown", role: "listbox", "aria-multiselectable": "true", "aria-expanded": this.isExpanded ? "true" : false, "aria-label": this.label, tabindex: -1 },
+        this.inputEl && this.renderAddNewButton(),
+        this.renderListItems(this.optionsList))));
+  }
   renderListItems(optionsList) {
     optionsList = this.sortCaseInsensitive(optionsList);
     // filter by input
@@ -518,7 +741,7 @@ export class TagInput {
       const id = `option${idx + 1}`;
       const isFocused = this.focusedListItem && this.focusedListItem.id === id;
       const isSelected = this.includesCaseInsensitive(this.tagsList, option);
-      return (h("li", { class: `option ${isFocused ? "focused" : ""}`, role: "option", id: id, "data-option": option, tabIndex: isFocused ? 0 : -1, "aria-selected": isSelected ? "true" : "false", "aria-disabled": isSelected ? "true" : "false", onKeyDown: (ev) => this.handleListItemKeyDown(ev), onBlur: (ev) => this.handleBlur(ev, this.el), onClick: (ev) => this.handleListItemClick(ev) }, option));
+      return (h("li", { class: `option ${isFocused ? "focused" : ""}`, role: "option", id: id, "data-option": option, "aria-selected": isSelected ? "true" : "false", "aria-disabled": isSelected ? "true" : "false", onKeyDown: (ev) => this.handleListItemKeyDown(ev), onBlur: (ev) => this.handleBlur(ev, this.el), onClick: (ev) => this.handleListItemClick(ev.target) }, option));
     });
   }
   renderAddNewButton() {
@@ -527,7 +750,7 @@ export class TagInput {
     if (this.addNew && hasNonWhiteSpaceCharacters && !optionAlreadyExists) {
       const id = `add-new-btn`;
       const isFocused = this.focusedListItem && this.focusedListItem.id === id;
-      return (h("li", { role: "option", class: `add-new-btn ${isFocused ? "focused" : ""}`, id: id, "data-option": this.inputEl.value, onKeyDown: (ev) => this.handleListItemKeyDown(ev), onBlur: (ev) => this.handleBlur(ev, this.el), onClick: (ev) => this.handleListItemClick(ev), tabIndex: isFocused ? 0 : -1 }, `Add "${this.inputEl.value.trim()}"`));
+      return (h("li", { role: "option", class: `add-new-btn ${isFocused ? "focused" : ""}`, id: id, "data-option": this.inputEl.value, onKeyDown: (ev) => this.handleListItemKeyDown(ev), onBlur: (ev) => this.handleBlur(ev, this.el), onClick: (ev) => this.handleListItemClick(ev.target), tabIndex: isFocused ? 0 : -1 }, `Add "${this.inputEl.value.trim()}"`));
     }
     else
       return "";
@@ -560,41 +783,67 @@ export class TagInput {
           this.tagsList.length >= this.maxTags && h("span", { class: "sr-only" }, this.maxTagsReachedMessage))));
     }
   }
+  renderTable() {
+    return (h("div", { class: "table-wrapper", onScroll: () => this.dismissTooltip() },
+      h("table", { id: "table", role: "grid", class: `${this.colWidths ? "fixed-widths" : ""}`, "aria-label": this.label, "aria-multiselectable": "true" },
+        this.renderTableHeaders(),
+        this.filteredRows.length ? this.renderTableRows() : h("div", { class: "no-results" }, this.noResultsMessage))));
+  }
+  renderTableHeaders() {
+    return (h("tr", { class: "headers", role: "row" }, csvToArray(this.colHeaders).map((header, idx) => {
+      let overflowRule = "wrap";
+      if (this.colWrap && csvToArray(this.colWrap)[idx]) {
+        overflowRule = csvToArray(this.colWrap)[idx];
+      }
+      return (h("th", { class: `header-cell ${overflowRule}`, role: "columnheader", 
+        // @ts-ignore
+        width: this.colWidths ? csvToArray(this.colWidths)[idx] : "" }, header));
+    })));
+  }
+  renderTableRows() {
+    return this.filteredRows.map((row) => {
+      const isSelected = this.includesCaseInsensitive(this.tagsList, row.id);
+      return (h("tr", { id: row.id, class: `${row.locked ? "locked" : ""} ${isSelected ? "selected" : ""}`, role: "row", onClick: () => this.handleTableRowClick(row.id) }, this.renderTableCells(row)));
+    });
+  }
+  renderTableCells(row) {
+    const colValues = [row.col1, row.col2, row.col3, row.col4].filter((val) => !!val);
+    const isSelected = this.includesCaseInsensitive(this.tagsList, row.id);
+    return colValues.map((val, idx) => {
+      const localId = `${row.id}-col${idx + 1}`;
+      let overflowRule = "wrap";
+      if (this.colWrap && csvToArray(this.colWrap)[idx]) {
+        overflowRule = csvToArray(this.colWrap)[idx];
+      }
+      return (h("td", { id: localId, role: "gridcell", class: overflowRule, "aria-describedby": `${localId}-description`, "aria-selected": isSelected.toString(), onMouseEnter: (ev) => this.handleCellMouseEnter(ev), onMouseLeave: () => this.dismissTooltip() },
+        val,
+        h("div", { class: "description", id: `${localId}-description` }, row.locked ? "locked" : "")));
+    });
+  }
   render() {
-    const isFocused = this.focusedElement &&
-      (this.focusedElement === this.inputEl ||
-        this.focusedElement === this.tagAreaEl ||
-        this.focusedElement.classList.contains("add-new-btn") ||
-        (this.optionsList.length > 0 && this.listItemEls.includes(this.focusedElement)));
     return (h(Host, { id: this.uid },
       h("div", { class: `wrapper label-${this.labelPosition}` },
         h("div", { class: "label-wrapper" },
           h("label", { class: "label", htmlFor: `input${this.uid}` }, this.label)),
-        h("div", { class: `field-wrapper ${isFocused ? "focused" : ""}`, ref: (el) => (this.fieldWrapperEl = el) },
+        h("div", { class: `field-wrapper ${this.focusedElement ? "focused" : ""}`, ref: (el) => (this.fieldWrapperEl = el) },
           h("div", { class: "upper-row" },
             h("div", { class: "tags-and-input-wrapper" },
               h("ul", { ref: (el) => (this.tagAreaEl = el), class: "tag-area", role: "listbox", "aria-orientation": "horizontal", "aria-label": `${this.label} ${this.tagsList.length > 0 ? this.tagAreaInstructions : ""}`, tabindex: this.tagsList.length > 0 ? 0 : -1, "aria-describedby": `info max-tags`, onFocus: () => this.handleTagAreaFocus(), onBlur: (ev) => {
                   this.clearTagFocus();
                   this.handleBlur(ev, this.el);
                 }, onKeyDown: (ev) => this.handleTagAreaKeyDown(ev) }, this.renderTags()),
-              h("input", { id: `input${this.uid}`, class: this.maxTags && this.tagsList.length >= this.maxTags ? "hidden" : "", role: "combobox", ref: (el) => (this.inputEl = el), autocomplete: "off", "aria-controls": "dropdown", "aria-describedby": "help-text", "aria-label": `${this.label} ${this.generateCharacterLimitLabel(this.characterLimit)}`, "aria-expanded": this.isExpanded ? "true" : "false", placeholder: this.placeholder, maxLength: this.characterLimit, onInput: () => this.handleInputChanged(this.inputEl.value), onBlur: (ev) => {
+              h("input", { id: `input${this.uid}`, class: this.maxTags && this.tagsList.length >= this.maxTags ? "hidden" : "", role: "combobox", ref: (el) => (this.inputEl = el), autocomplete: "off", "aria-controls": this.tagInputType, "aria-describedby": "help-text", "aria-label": `${this.label} ${this.generateCharacterLimitLabel(this.characterLimit)}`, "aria-expanded": this.tagInputType === "dropdown" ? this.isExpanded.toString() : null, placeholder: this.placeholder, maxLength: this.tagInputType === "dropdown" ? this.characterLimit : undefined, onInput: () => this.handleInputChanged(this.inputEl.value), onBlur: (ev) => {
                   this.handleBlur(ev, this.el);
-                }, onFocus: () => {
-                  this.openDropdown();
-                  this.clearListItemFocus();
-                }, onKeyDown: (ev) => this.handleInputKeyDown(ev) })),
-            h("div", { class: "character-count" },
+                }, onFocus: () => this.handleInputFocus(), onKeyDown: (ev) => this.handleInputKeyDown(ev) })),
+            this.tagInputType === "dropdown" && (h("div", { class: "character-count" },
               this.charCount,
               "/",
-              this.characterLimit)),
+              this.characterLimit))),
           this.renderTagCounter(),
-          h("div", { class: `dropdown-wrapper ${this.isExpanded ? "open" : ""} ${this.openUp ? "upwards" : ""}`, ref: (el) => (this.dropdownEl = el) },
-            h("div", { id: "help-text", class: "help-text" }, this.renderHelpText()),
-            h("ul", { class: "dropdown", id: "dropdown", role: "listbox", "aria-multiselectable": "true", "aria-expanded": this.isExpanded ? "true" : false, "aria-label": this.label, tabindex: -1 },
-              this.inputEl && this.renderAddNewButton(),
-              this.renderListItems(this.optionsList)))),
+          this.tagInputType === "dropdown" && this.renderDropdown()),
         this.info ? (h("div", { id: "info", class: "info-text" }, this.info)) : (""),
-        h("div", { class: "sr-only", "aria-live": "assertive", ref: (el) => (this.liveRegionEl = el), "aria-atomic": "true" }, this.liveRegionMessage))));
+        h("div", { class: "sr-only", "aria-live": "assertive", ref: (el) => (this.liveRegionEl = el), "aria-atomic": "true" }, this.liveRegionMessage),
+        this.tagInputType === "table" && this.renderTable())));
   }
   static get is() { return "wm-tag-input"; }
   static get encapsulation() { return "shadow"; }
@@ -762,11 +1011,81 @@ export class TagInput {
       },
       "attribute": "max-tags",
       "reflect": false
+    },
+    "tagInputType": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "\"dropdown\" | \"table\"",
+        "resolved": "\"dropdown\" | \"table\"",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": ""
+      },
+      "attribute": "tag-input-type",
+      "reflect": false,
+      "defaultValue": "\"dropdown\""
+    },
+    "colHeaders": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": true,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": ""
+      },
+      "attribute": "col-headers",
+      "reflect": false
+    },
+    "colWidths": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string | undefined",
+        "references": {}
+      },
+      "required": false,
+      "optional": true,
+      "docs": {
+        "tags": [],
+        "text": ""
+      },
+      "attribute": "col-widths",
+      "reflect": false
+    },
+    "colWrap": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string | undefined",
+        "references": {}
+      },
+      "required": false,
+      "optional": true,
+      "docs": {
+        "tags": [],
+        "text": ""
+      },
+      "attribute": "col-wrap",
+      "reflect": false
     }
   }; }
   static get states() { return {
     "focusedListItem": {},
     "focusedTag": {},
+    "tablePosition": {},
     "isExpanded": {},
     "tagsList": {},
     "optionsList": {},
@@ -795,11 +1114,23 @@ export class TagInput {
       "methodName": "reflectSelectedTags"
     }]; }
   static get listeners() { return [{
+      "name": "wmTagInputRowUpdated",
+      "method": "handleRowUpdate",
+      "target": undefined,
+      "capture": false,
+      "passive": false
+    }, {
       "name": "click",
       "method": "closeIfNotElOrChild",
       "target": "document",
       "capture": false,
       "passive": false
+    }, {
+      "name": "scroll",
+      "method": "dismissTooltip",
+      "target": "window",
+      "capture": true,
+      "passive": true
     }, {
       "name": "resize",
       "method": "handleResize",