@veritree/ui 0.6.1 → 0.9.0

package/src/DropdownMenu/VTDropdownMenuTrigger.vue

@@ -0,0 +1,191 @@
+<template>
+  <div
+    :aria-haspopup="hasPopup"
+    :aria-expanded="expanded"
+    :aria-controls="controls"
+    @keydown.down.prevent="onKeyArrowDown"
+    @keydown.up.prevent="onKeyArrowUp"
+    @keydown.esc.prevent="onKeyesc"
+  >
+    <slot></slot>
+  </div>
+</template>
+
+<script>
+export default {
+  name: 'VTDropdownMenuTrigger',
+
+  inject: ['api'],
+
+  data() {
+    return {
+      expanded: false,
+      hasPopup: false,
+      controls: null,
+    };
+  },
+
+  computed: {
+    // gets slot element
+    slotElm() {
+      return this.$slots.default[0].elm;
+    },
+
+    slotLength() {
+      return this.$slots.default.length;
+    },
+
+    content() {
+      return this.api().content;
+    },
+
+    items() {
+      return this.api().items;
+    },
+
+    firstMenuItem() {
+      return this.items[0];
+    },
+
+    lastMenuItem() {
+      return this.items[this.items.length - 1];
+    },
+  },
+
+  mounted() {
+    this.api().registerTrigger(this);
+    this.addEventListenerToSlotElm();
+  },
+
+  destroyed() {
+    this.slotElm.removeEventListener('click', this.onClick());
+  },
+
+  methods: {
+    /**
+     * Add event listener to slot element
+     *
+     * The click event has to be added to the slot child element
+     * since we are not setting the onclick on the component
+     * itself.
+     *
+     * Slot must have only one child element. It avoids
+     * errors related to adding the event listener.
+     */
+    addEventListenerToSlotElm() {
+      if (!this.slotLength) return;
+
+      if (this.slotLength > 1) {
+        throw new Error('VTPopoverButton only accepts one item in its slot');
+      }
+
+      this.slotElm.addEventListener('click', (e) => {
+        e.stopImmediatePropagation();
+        this.onClick();
+      });
+    },
+
+    /**
+     * Shows content/menu if not already visible
+     */
+    showContent() {
+      if (!this.expanded) {
+        this.toggleExpanded();
+        this.content.show();
+      }
+    },
+
+    /**
+     * Focus slot element if it exists and toggle expanded
+     */
+    focus() {
+      if (!this.slotElm) return;
+
+      this.slotElm.focus();
+      this.toggleExpanded();
+    },
+
+    /**
+     * Toggles aria expanded attribute/state
+     */
+    toggleExpanded() {
+      this.expanded = !this.expanded;
+    },
+
+    /**
+     * Toggles aria popup/controls attribute/state
+     */
+    toggleHasPopup() {
+      if (!this.content) return;
+
+      this.hasPopup = !this.hasPopup;
+
+      if (!this.hasPopup) {
+        this.controls = null;
+        return;
+      }
+
+      this.controls = this.content.id;
+    },
+
+    /**
+     * On click, do the following:
+     *
+     * 1. Toggle aria expanded attribute/state
+     * 2. Open the menu if it's closed
+     * 3. Close the menu if it's open
+     */
+    onClick() {
+      if (!this.content) return;
+
+      this.toggleExpanded();
+
+      this.$nextTick(() => {
+        if (this.expanded) this.content.show();
+        else this.content.hide();
+      });
+    },
+
+    /**
+     * On key arrow down, do the following:
+     *
+     * 1. if the menu is not expanded, expand it and focus the first menu item
+     * 2. if the menu is expanded, focus the first menu item
+     */
+    onKeyArrowDown() {
+      if (!this.content) return;
+
+      this.showContent();
+
+      this.$nextTick(() => {
+        this.firstMenuItem.focus();
+      });
+    },
+
+    /**
+     * On key arrow up, do the following:
+     *
+     * 1. if the menu is not expanded, expand it and focus the last menu item
+     * 2. if the menu is expanded, focus the last menu item
+     */
+    onKeyArrowUp() {
+      if (!this.content) return;
+
+      this.showContent();
+
+      this.$nextTick(() => {
+        this.lastMenuItem.focus();
+      });
+    },
+
+    onKeyesc() {
+      if (!this.content) return;
+
+      if (this.expanded) {
+        this.toggleExpanded();
+        this.content.hide();
+      }
+    },
+  },
+};
+</script>

package/src/Form/VTFormFeedback.vue

@@ -0,0 +1,64 @@
+<template>
+  <div class="form-feedback" :class="classes">
+    <component :is="icon" v-if="showIcon" />
+    <span class="text-gray-500"><slot></slot></span>
+  </div>
+</template>
+
+<script>
+import { IconCheck, IconWarning } from '@veritree/icons';
+
+export default {
+  name: 'VTFormFeedback',
+
+  components: {
+    IconWarning,
+    IconCheck,
+  },
+
+  props: {
+    variant: {
+      type: [String, Object],
+      default: '',
+      validator(value) {
+        if (value === '' || typeof value === 'object') {
+          return true;
+        }
+
+        return ['success', 'warning', 'error'].includes(value);
+      },
+    },
+    hideIcon: {
+      type: Boolean,
+      default: false,
+    },
+  },
+
+  computed: {
+    classes() {
+      const classes = {};
+
+      if (this.variant) {
+        classes[`form-feedback--${this.variant}`] = true;
+      }
+
+      return classes;
+    },
+
+    icon() {
+      if (this.variant === 'success') return IconCheck;
+      return IconWarning;
+    },
+
+    showIcon() {
+      return !this.hideIcon;
+    },
+  },
+
+  methods: {
+    onClick() {
+      this.$emit('click');
+    },
+  },
+};
+</script>

package/src/Form/VTFormGroup.vue

@@ -0,0 +1,22 @@
+<template>
+  <component :is="as" :class="classes" class="form-group">
+    <slot></slot>
+  </component>
+</template>
+
+<script>
+export default {
+  props: {
+    as: {
+      type: String,
+      default: 'div',
+    },
+  },
+
+  data() {
+    return {
+      classes: {},
+    };
+  },
+};
+</script>

package/src/Listbox/VTListbox.vue

@@ -1,150 +1,73 @@
 <template>
-  <div class="Listbox"><slot></slot></div>
+  <div :class="{ Listbox: headless, relative: !headless, 'z-20': active }">
+    <slot></slot>
+  </div>
 </template>
 
 <script>
+import { genId } from '~/utils/ids';
+
 export default {
   name: 'VTListbox',
 
   provide() {
     return {
       api: () => {
-        // Get children components
-        const getListbox = () => this.listbox;
-        const getListboxValue = () => this.value;
-        const getListboxButton = () => this.listboxButton;
-
-        // Handle registering and unregistering
-        const registerListboxButton = (button) => {
-          if (!button) return;
-          this.listboxButton = button;
-        };
-
-        const registerListbox = (listbox) => {
-          if (!listbox) return;
-          this.listbox = listbox;
-        };
-
-        const registerOption = (option) => {
-          if (!option) return;
-          _register(this.listboxOptions, option);
-        };
+        const { dark: isDark, right: isRight } = this;
+        const { id, listbox, trigger, content, search, list, items } = this;
 
-        const unregisterOption = (id) => {
-          _unregister(this.listboxOptions, id);
+        const registerTrigger = (trigger) => {
+          if (!trigger) return;
+          this.trigger = trigger;
         };
 
-        // Register helper functions
-        const _register = (arr, item) => {
-          arr.push(item);
+        const registerContent = (content) => {
+          if (!content) return;
+          this.content = content;
         };
 
-        const _unregister = (arr, id) => {
-          const index = _getIndex(arr, id);
-          arr.splice(index, 1);
+        const registerSearch = (search) => {
+          if (!search) return;
+          this.search = search;
         };
 
-        // Handle focus and unfocus
-        const getFocusedIndex = () => {
-          let index = 0;
-
-          this.listboxOptions.forEach((option, i) => {
-            if (option.focused) index = i;
-          });
-
-          return index;
-        };
-
-        const focusOptionByFilter = (filter) => {
-          const optionIndex = this.listboxOptions.findIndex((option) => {
-            const text = option.$el.innerText;
-            return text.toLowerCase().indexOf(filter.toLowerCase()) === 0;
-          });
-
-          if (optionIndex >= 0) _focusOption(optionIndex);
-        };
-
-        const focusFirstOption = () => {
-          _focusOption(0);
-        };
-
-        const focusLastOption = () => {
-          _focusOption(this.listboxOptions.length - 1);
-        };
-
-        const focusPreviousOption = () => {
-          const focusedIndex = getFocusedIndex();
-          const previousIndex = focusedIndex - 1;
-
-          if (previousIndex >= 0) _focusOption(previousIndex);
-        };
-
-        const focusNextOption = () => {
-          const focusedIndex = getFocusedIndex();
-          const nextIndex = focusedIndex + 1;
-
-          if (nextIndex < this.listboxOptions.length) _focusOption(nextIndex);
+        const registerList = (list) => {
+          if (!list) return;
+          this.list = list;
         };
 
-        const unfocusOptions = () => {
-          this.listboxOptions.forEach((option) => {
-            if (option.focused) option.unfocus();
-          });
+        const registerItem = (item) => {
+          if (!item) return;
+          this.items.push(item);
         };
 
-        const _focusOption = (index) => {
-          unfocusOptions();
-          this.listboxOptions[index].focus();
+        const unregisterItem = (id) => {
+          const index = this.items.findIndex((item) => item.id === id);
+          this.items.splice(index, 1);
         };
 
-        const _getFocusedOption = () => {
-          return this.listboxOptions.filter((option) => option.focused)[0];
-        };
-
-        // handle selecting and unselecting
-        const selectOption = () => {
-          const focusedOption = _getFocusedOption();
-
-          // do nothing if option is already selected
-          if (focusedOption.selected) return;
-
-          // unselect all options
-          this.listboxOptions.forEach((option) => option.unselect());
-
-          // select focused option
-          if (focusedOption) {
-            focusedOption.select();
-            _onSelectedOption(focusedOption.value);
-          }
-        };
-
-        const _onSelectedOption = (value) => {
-          this.listbox.hide();
+        const emit = (value) => {
           this.$emit('input', value);
-          this.$emit('change');
-        };
-
-        // Index helper functions
-        const _getIndex = (arr, id) => {
-          return arr.findIndex((item) => item.id === id);
+          this.$emit('change', value);
         };
 
         return {
-          getListbox,
-          getListboxButton,
-          registerListboxButton,
-          registerListbox,
-          registerOption,
-          unregisterOption,
-          focusOptionByFilter,
-          focusFirstOption,
-          focusLastOption,
-          focusPreviousOption,
-          focusNextOption,
-          unfocusOptions,
-          selectOption,
-          getFocusedIndex,
-          getListboxValue,
+          id,
+          isDark,
+          isRight,
+          listbox,
+          trigger,
+          search,
+          content,
+          list,
+          items,
+          registerTrigger,
+          registerContent,
+          registerSearch,
+          registerList,
+          registerItem,
+          unregisterItem,
+          emit,
         };
       },
     };
@@ -155,14 +78,48 @@ export default {
       type: [String, Number, Object],
       default: null,
     },
+    headless: {
+      type: Boolean,
+      default: false,
+    },
+    dark: {
+      type: Boolean,
+      default: false,
+    },
+    right: {
+      type: Boolean,
+      default: false,
+    },
   },
 
   data() {
     return {
+      id: `listbox-${genId()}`,
       listbox: null,
-      listboxButton: null,
-      listboxOptions: [],
+      trigger: null,
+      content: null,
+      search: null,
+      list: null,
+      items: [],
+      active: false,
+    };
+  },
+
+  mounted() {
+    this.listbox = {
+      setActive: this.setActive,
+      clearActive: this.clearActive,
     };
   },
+
+  methods: {
+    setActive() {
+      this.active = true;
+    },
+
+    clearActive() {
+      this.active = null;
+    },
+  },
 };
 </script>

package/src/Listbox/VTListboxContent.vue

@@ -0,0 +1,151 @@
+<template>
+  <transition
+    enter-active-class="duration-200 ease-out"
+    enter-class="translate-y-[15px] opacity-0"
+    enter-to-class="translate-y-0 opacity-100"
+    leave-active-class="duration-200 ease-in"
+    leave-class="translate-y-0 opacity-100"
+    leave-to-class="translate-y-[15px] opacity-0"
+    @after-leave="hide"
+  >
+    <div
+      v-if="visible"
+      :id="id"
+      :aria-activedescendant="activeDescedant"
+      :class="{
+        MenuList: headless,
+        'absolute z-10 grid w-full min-w-[222px] overflow-hidden rounded-md py-2 px-3':
+          !headless,
+        'border-gray-100 bg-white shadow-300': !dark && !headless,
+        'bg-forest-default border border-solid border-gray-700 shadow-gray-700':
+          dark && !headless,
+        'left-0': !right && !headless,
+        'right-0': right && !headless,
+        'top-full mt-3': isTop && !headless,
+        'bottom-full mb-3': isBottom && !headless,
+      }"
+      role="listbox"
+    >
+      <slot></slot>
+    </div>
+  </transition>
+</template>
+
+<script>
+import { genId } from '~/utils/ids';
+
+export default {
+  name: 'VTListboxContent',
+
+  inject: ['api'],
+
+  props: {
+    headless: {
+      type: Boolean,
+      default: false,
+    },
+    bottom: {
+      type: Boolean,
+      default: false,
+    },
+    top: {
+      type: Boolean,
+      default: true,
+    },
+  },
+
+  data() {
+    return {
+      id: `listboxcontent-${genId()}`,
+      activeDescedant: null,
+      visible: false,
+    };
+  },
+
+  computed: {
+    dark() {
+      return this.api().isDark;
+    },
+
+    right() {
+      return this.api().isRight;
+    },
+
+    listbox() {
+      return this.api().listbox;
+    },
+
+    trigger() {
+      return this.api().trigger;
+    },
+
+    search() {
+      return this.api().search;
+    },
+
+    // directions
+    isTop() {
+      return this.top && !this.bottom;
+    },
+
+    isBottom() {
+      return this.bottom;
+    },
+  },
+
+  mounted() {
+    const content = {
+      id: this.id,
+      show: this.show,
+      hide: this.hide,
+      setActiveDescedant: this.setActiveDescedant,
+    };
+
+    this.api().registerContent(content);
+
+    // TODO: Create a directive or mixin for this
+    document.addEventListener('click', (e) => {
+      e.stopPropagation();
+      if (this.visible && !this.$el.contains(e.target)) this.trigger.onClick();
+    });
+  },
+
+  destroyed() {
+    // TODO: Create a directive or mixin for this
+    document.removeEventListener('click', this.trigger.onClick());
+  },
+
+  methods: {
+    show() {
+      if (this.visible) return;
+
+      this.visible = true;
+
+      this.$nextTick(() => {
+        this.listbox.setActive();
+
+        if (this.search) this.search.el.focus();
+      });
+    },
+
+    hide() {
+      if (!this.visible) return;
+
+      this.visible = false;
+
+      this.$nextTick(() => {
+        this.trigger.focus();
+
+        setTimeout(() => {
+          this.listbox.clearActive();
+          this.trigger.contract();
+        }, 100);
+      });
+    },
+
+    setActiveDescedant(id) {
+      this.activeDescedant = id;
+    },
+  },
+};
+</script>