@lion/ui 0.16.1 → 0.17.0-menu-system.0

package/components/menu/src/LionToolbar.js

@@ -0,0 +1,94 @@
+/* eslint-disable import/no-extraneous-dependencies */
+import { LionMenu } from './LionMenu.js';
+import { setChecked, toggleChecked } from './utils/listItemInteractions.js';
+
+/**
+ * @typedef {import('../types/InteractiveListMixinTypes.js').InteractiveListItemRole} InteractiveListItemRole
+ */
+
+export class LionToolbar extends LionMenu {
+  constructor() {
+    super();
+
+    this._listRole = 'toolbar';
+    this.bar = true;
+  }
+
+  /**
+   * Allows groups ([role=radiogroup|checkboxgroup]) within one level.
+   * In case we deal with [role=checkbox], we treat it as multiple choice group
+   * @override InteractiveListMixin
+   * @param {number} index
+   */
+  setCheckedIndex(index) {
+    const item = this.listItems[index];
+    if (item) {
+      // @ts-ignore - InteractiveListItemRole type
+      const role = /** @type {InteractiveListItemRole} */ (item.getAttribute('role'));
+      let listItemsWithinGroup = this.listItems;
+      let multiple = this.multipleChoice;
+      if (role === 'radio' || role === 'checkbox') {
+        /**
+         * If index = 1 (radio 'Red'), closest group will be div[role=radiogroup]
+         * @example
+         * <lion-toolbar>
+         *   <div role="radiogroup" aria-label="Text Color">
+         *     <button role="radio" aria-checked="false">Blue</button>
+         *     <button role="radio" aria-checked="true">Red</button>
+         *     <button role="radio" aria-checked="false">Green</button>
+         *   </div>
+         *   <div role="separator"></div>
+         *   <div role="checkboxgroup" aria-label="Text Color">
+         *     <button role="checkbox" aria-checked="false">Blue</button>
+         *     <button role="checkbox" aria-checked="true">Red</button>
+         *     <button role="checkbox" aria-checked="false">Green</button>
+         *   </div>
+         * </lion-toolbar>
+         */
+        let closestGroup;
+        if (role === 'radio') {
+          closestGroup = item.closest('[role="radiogroup"]');
+        } else if (role === 'checkbox') {
+          closestGroup = item.closest('[role="checkboxgroup"]');
+        }
+
+        const group = closestGroup && this.contains(closestGroup) ? closestGroup : this;
+        listItemsWithinGroup = this.listItems.filter(listItem => group.contains(listItem));
+        multiple = role === 'checkbox';
+      }
+
+      if (!multiple) {
+        // Uncheck all
+        listItemsWithinGroup.forEach(listItem => {
+          setChecked(listItem, false);
+        });
+        setChecked(this.listItems[index]);
+      } else {
+        toggleChecked(this.listItems[index]);
+      }
+    }
+  }
+
+  /**
+   * @param {*} newItems
+   */
+  _initListItems(newItems) {
+    super._initListItems(newItems);
+
+    // @ts-ignore - forEach parameter
+    newItems.forEach(item => {
+      if (
+        item.getAttribute('role') === 'button' ||
+        (item.tagName === 'BUTTON' && !item.hasAttribute('role'))
+      ) {
+        const initialAriaPressed = item.getAttribute('aria-pressed');
+        item.setAttribute('aria-pressed', initialAriaPressed || 'false');
+
+        item.addEventListener('click', () => {
+          const ariaPressed = item.getAttribute('aria-pressed') === 'true';
+          item.setAttribute('aria-pressed', `${!ariaPressed}`);
+        });
+      }
+    });
+  }
+}

package/components/menu/src/LionTree.js

@@ -0,0 +1,52 @@
+/* eslint-disable import/no-extraneous-dependencies */
+import { LitElement } from 'lit';
+import { MultiLevelListMixin } from './MultiLevelListMixin.js';
+
+// @ts-ignore - class extension with mixin
+export class LionTree extends MultiLevelListMixin(LitElement) {
+  constructor() {
+    super();
+
+    /** @configure InteractiveListMixin */
+    this._listRole = 'tree';
+    /** @configure InteractiveListMixin */
+    this._activateOnTypedChars = true;
+    /** @configure DisclosureMixin */
+    this.invokerInteraction = 'click';
+  }
+
+  /**
+   * @param {*} changedProperties
+   */
+  updated(changedProperties) {
+    super.updated(changedProperties);
+
+    if (changedProperties.has('level')) {
+      if (this.level > 0) {
+        this._listNode.setAttribute('role', 'group');
+      }
+      this.__setAriaLevelForListItems();
+    }
+  }
+
+  /**
+   * @param {*} newItems
+   */
+  _initListItems(newItems) {
+    // @ts-ignore - parameter types
+    super._initListItems(newItems);
+
+    this.__setAriaLevelForListItems();
+    // @ts-ignore - forEach parameters
+    newItems.forEach((item, index) => {
+      item.setAttribute('aria-posinset', `${index + 1}`);
+      item.setAttribute('aria-setsize', `${this.listItems.length}`);
+    });
+  }
+
+  __setAriaLevelForListItems() {
+    this.listItems.forEach(item => {
+      item.setAttribute?.('aria-level', `${this.level + 1}`);
+    });
+  }
+}

package/components/menu/src/MultiLevelListMixin.js

@@ -0,0 +1,275 @@
+/* eslint-disable import/no-extraneous-dependencies */
+import { html } from 'lit';
+import { dedupeMixin } from '@open-wc/dedupe-mixin';
+// import { DisclosureMixin } from '@lion/ui/collapsible.js';
+import { InteractiveListMixin } from './InteractiveListMixin.js';
+
+/**
+ * @typedef {import('./InteractiveListMixin.js').LionItem} LionItem
+ * @typedef {import('../types/InteractiveListMixinTypes.js').InteractiveListHost} InteractiveList
+ */
+
+/**
+ * All logic that is needed for interactive lists that are allowed to have multiple nested, collapsible levels
+ * Applies to [role=menu] and [role=tree]
+ */
+// @ts-ignore - mixin implementation
+const MultiLevelListMixinImplementation = superclass =>
+  // @ts-ignore - mixin class extension
+  class extends InteractiveListMixin(superclass) {
+    render() {
+      return html`
+        <slot name="invoker"></slot>
+        <slot name="list"></slot>
+        <slot id="list-items-outlet"></slot>
+      `;
+    }
+
+    static get properties() {
+      return {
+        invokerNode: Object,
+        behaveAsAccordion: { type: Boolean, attribute: 'behave-as-accordion' },
+        level: { type: Number, reflect: true },
+      };
+    }
+
+    /**
+     * @configure DisclosureMixin
+     */
+    get _invokerNode() {
+      // @ts-ignore - accessing static method and super property
+      return this.constructor._getFocusableInvokerEl(this.invokerNode) || super._invokerNode;
+    }
+
+    /**
+     * @configure DisclosureMixin
+     * This will be compatible with DisclosureMixin and OverlayMixin. It contains the invoked
+     * InteractiveList widget (like menu|tree).
+     */
+    get _contentNode() {
+      return this._listNode;
+    }
+
+    constructor() {
+      super();
+
+      /**
+       * When an invokerNode is supplied (usually by a parent level menu), it will take precedence
+       * over [slot=invoker] and previousElementSibling with [data-invoker] attribute
+       * @type {HTMLElement}
+       */
+      // @ts-ignore - can be undefined initially
+      this.invokerNode = undefined;
+      /**
+       * @configure DisclosureMixin
+       */
+      this.handleFocus = true;
+      /**
+       * The parent list if level > 1
+       * @type {InteractiveList}
+       */
+      // @ts-ignore - can be undefined initially
+      this.parentList = undefined;
+      /**
+       * When true, will have a maximum of one submenu open at a time
+       */
+      this.behaveAsAccordion = false;
+      /**
+       * The level of nested menus. Will be reflected as attribute for styling purposes
+       */
+      this.level = 1;
+      /**
+       * @configure InteractiveListMixin
+       */
+      this.noPreselect = true;
+      /**
+       * @configure InteractiveListMixin
+       */
+      this._activeMode = 'roving-tabindex';
+      /**
+       * @type {Map<HTMLElement|LionItem,InteractiveList>}
+       */
+      this._subListMap = new Map();
+    }
+
+    // /**
+    //  * @param {import('lit-element').PropertyValues } changedProperties
+    //  */
+    // updated(changedProperties) {
+    //   super.updated(changedProperties);
+
+    //   if (changedProperties.has('invokerNode')) {
+    //     // TODO: update openableCtrl invokerNode once we make this a ctrl as well
+    //   }
+    // }
+
+    /**
+     * Gets the child InteractiveList, based on item
+     * @param {LionItem|HTMLElement} item can be sibling of or parent of InteractiveList
+     */
+    static _getSubInteractiveList(item) {
+      /**
+       * Note that, according to W3C spec, the sub level element with [role=menu|menubar|tree]
+       * needs to be a sibling of the invoker element with
+       * [role=menuitem|menuitemchecbox|menuitemradio|treeitem] (and not the parent)
+       *
+       * In the example below <lion-menu> is considered as item
+       * @example
+       * <lion-menuitem>
+       *   <button slot="invoker"></button>
+       *   <lion-menu> ... </lion-menu>
+       * </lion-menuitem>
+       */
+      // @ts-ignore - isInteractiveList property check
+      const siblingOfInvoker = item.nextElementSibling?.isInteractiveList;
+      if (siblingOfInvoker) {
+        return item.nextElementSibling;
+      }
+      /**
+       * In the example below div[role=listitem] | [data-item] is considered as item
+       * @example
+       * <div role="listitem" data-item>
+       *   <button slot="invoker"></button>
+       *   <lion-menu> ... </lion-menu>
+       * </div>
+       */
+      const childOfInvoker =
+        item.getAttribute?.('role') === 'listitem' || item.hasAttribute?.('data-item');
+      if (childOfInvoker) {
+        // @ts-ignore - isInteractiveList check
+        return Array.from(item.children).find(child => child.isInteractiveList);
+      }
+      return undefined;
+    }
+
+    /**
+     * @param {*} newItems
+     */
+    _initListItems(newItems) {
+      super._initListItems(newItems);
+
+      const ctor = this.constructor;
+      // @ts-ignore - forEach parameter types
+      newItems.forEach(item => {
+        // @ts-ignore - static method access
+        const subList = ctor._getSubInteractiveList(item);
+        if (subList) {
+          this._subListMap.set(item, subList);
+          subList.level = this.level + 1;
+          subList.parentList = this;
+          subList.invokerNode = item;
+          // @ts-ignore - invokerInteraction property
+          subList.invokerInteraction = this.invokerInteraction;
+          subList._activeMode = this._activeMode;
+        }
+      });
+    }
+
+    /**
+     * @enhance DisclosureMixin
+     * @param {Event} [ev]
+     */
+    toggle(ev) {
+      // @ts-ignore - target property
+      if (ev && this._listNode.contains(ev.target)) {
+        // prevent nested menus (inside invokers) from triggering invoker
+        return;
+      }
+      // @ts-ignore - super.toggle method
+      super.toggle();
+    }
+
+    /**
+     * @enhance InteractiveListMixin
+     * @param {*} ev
+     */
+    _onListKeyDown(ev) {
+      const targetFromsubList = Array.from(this._subListMap).find(
+        // @ts-ignore - contains method on InteractiveListHost
+        ([, s]) => s === ev.target || s.contains(ev.target),
+      );
+
+      if (targetFromsubList) {
+        return;
+      }
+
+      super._onListKeyDown(ev);
+
+      const subListOfActiveItem = this._subListMap.get(this.activeItem);
+      const parentListOfActiveItem = this.parentList;
+      const { key } = ev;
+
+      if (key === 'Escape' && parentListOfActiveItem) {
+        // We need to stop here, or else we affect parent menu (handled by OverlayController)
+        ev.stopPropagation();
+      }
+
+      switch (key) {
+        case 'Enter':
+        case ' ':
+          // console.debug('activeIndex', this.activeIndex);
+          // make it work like a button
+          this.activeItem?.click();
+          break;
+        case 'ArrowDown':
+          if (
+            this.orientation === 'horizontal' &&
+            subListOfActiveItem &&
+            this._activeMode !== 'disclosure'
+          ) {
+            this.activeItem.click();
+          }
+          break;
+        case 'ArrowRight':
+          if (this.orientation === 'vertical' && subListOfActiveItem) {
+            this.activeItem.click();
+          }
+          break;
+        case 'ArrowUp':
+          if (this.orientation === 'horizontal' && parentListOfActiveItem) {
+            // @ts-ignore - close method
+            this.close();
+            // @ts-ignore - _onOverlayShow method
+            parentListOfActiveItem._onOverlayShow();
+          }
+          break;
+        case 'ArrowLeft':
+          if (this.orientation === 'vertical' && parentListOfActiveItem) {
+            // @ts-ignore - close method
+            this.close();
+            // @ts-ignore - _onOverlayShow method
+            parentListOfActiveItem._onOverlayShow();
+          }
+          break;
+        /* no default */
+      }
+    }
+
+    // /**
+    //  * @enhance DisclosureMixin
+    //  */
+    // _setupDisclosure() {
+    //   if (!this._invokerNode) return;
+
+    //   super._setupDisclosure();
+    // }
+
+    // /**
+    //  * @enhance DisclosureMixin
+    //  */
+    // _teardownDisclosure() {
+    //   if (!this._invokerNode) return;
+
+    //   super._teardownDisclosure();
+    // }
+
+    // /**
+    //  * @enhance DisclosureMixin
+    //  */
+    // async _onOpenedChanged() {
+    //   if (!this._invokerNode) return;
+
+    //   await super._onOpenedChanged();
+    // }
+  };
+export const MultiLevelListMixin = dedupeMixin(MultiLevelListMixinImplementation);

package/components/menu/src/utils/isInView.js

@@ -0,0 +1,26 @@
+/**
+ * Determines whether element is visible within container
+ *
+ * @param {HTMLElement} container
+ * @param {HTMLElement} element
+ * @param {Boolean} [partial]
+ */
+export function isInView(container, element, partial = false) {
+  const cTop = container.scrollTop;
+  const cBottom = cTop + container.clientHeight;
+  const eTop = element.offsetTop;
+  const eBottom = eTop + element.clientHeight;
+  const isTotal = eTop >= cTop && eBottom <= cBottom;
+  let isPartial;
+
+  if (partial === true) {
+    isPartial = (eTop < cTop && eBottom > cTop) || (eBottom > cBottom && eTop < cBottom);
+  } else if (typeof partial === 'number') {
+    if (eTop < cTop && eBottom > cTop) {
+      isPartial = ((eBottom - cTop) * 100) / element.clientHeight > partial;
+    } else if (eBottom > cBottom && eTop < cBottom) {
+      isPartial = ((cBottom - eTop) * 100) / element.clientHeight > partial;
+    }
+  }
+  return isTotal || isPartial;
+}

package/components/menu/src/utils/listItemInteractions.js

@@ -0,0 +1,104 @@
+/**
+ * Set of universal interactive list item state methods that are both compatible with
+ * 'smart' (LionOption) and 'regular' items
+ */
+
+/**
+ * @param {HTMLElement} item
+ */
+export function isDisabled(item) {
+  return item.hasAttribute('disabled') || item.getAttribute('aria-disabled') === 'true';
+}
+
+/**
+ * @param {HTMLElement} item
+ */
+export function setDisabled(item, unset = false) {
+  if (unset) {
+    item.removeAttribute('disabled');
+    item.setAttribute('aria-disabled', 'false');
+  } else {
+    item.setAttribute('disabled', '');
+    item.setAttribute('aria-disabled', 'true');
+  }
+}
+
+/**
+ * @param {HTMLElement} item
+ */
+export function toggleDisabled(item) {
+  setDisabled(item, isDisabled(item));
+}
+
+/**
+ * @param {HTMLElement} item
+ */
+export function isChecked(item) {
+  return item.hasAttribute('checked') || item.getAttribute('aria-selected') === 'true';
+}
+
+/**
+ * @param {HTMLElement} item
+ * @param {boolean} [shouldSet=false]
+ */
+export function setChecked(item, shouldSet = true) {
+  const ariaAttr = item.getAttribute('role') === 'option' ? 'selected' : 'checked';
+  if (shouldSet) {
+    item.setAttribute('checked', '');
+    item.setAttribute(`aria-${ariaAttr}`, 'true');
+  } else {
+    item.removeAttribute('checked');
+    item.setAttribute(`aria-${ariaAttr}`, 'false');
+  }
+}
+
+/**
+ * @param {HTMLElement} item
+ */
+export function toggleChecked(item) {
+  setChecked(item, !isChecked(item));
+}
+
+/**
+ * @param {HTMLElement} item
+ */
+export function isActive(item) {
+  return item.hasAttribute('active');
+}
+
+/**
+ * @param {HTMLElement} item
+ */
+export function setActive(item, unset = false) {
+  if (unset) {
+    item.removeAttribute('active');
+  } else {
+    item.setAttribute('active', '');
+  }
+}
+
+/**
+ * @param {HTMLElement} item
+ */
+function getDirectTextContent(item) {
+  return Array.from(item.childNodes)
+    .filter(n => n.nodeName === '#text')
+    .map(n => n.textContent)
+    .join('')
+    .trim();
+}
+
+/**
+ * @param {HTMLElement} item
+ */
+export function getValue(item) {
+  return (
+    // @ts-ignore - choiceValue is a custom property
+    item.choiceValue ||
+    // @ts-ignore - value might not exist on all HTMLElements
+    item.value ||
+    item.getAttribute('value') ||
+    item.getAttribute('data-value') ||
+    getDirectTextContent(item)
+  );
+}

package/components/menu/src/utils/uuid.js

@@ -0,0 +1,3 @@
+export function uuid() {
+  return Math.random().toString(36).substr(2, 10);
+}

package/components/menu/test/lion-menu.test.js

@@ -0,0 +1,3 @@
+import { runInteractiveListMixinSuite } from '../test-suites/InteractiveListMixin.suite.js';
+
+runInteractiveListMixinSuite();