@weni/unnnic-system 3.12.8 → 3.13.0

package/src/components/Select/index.vue

@@ -0,0 +1,308 @@
+<template>
+  <div
+    class="unnnic-select"
+    @keydown="handleKeyDown"
+  >
+    <Popover
+      :open="openPopover"
+      @update:open="openPopover = $event"
+    >
+      <PopoverTrigger class="w-full">
+        <UnnnicInput
+          ref="inputRef"
+          :modelValue="inputValue"
+          class="unnnic-select__input"
+          readonly
+          useFocusProp
+          :focus="openPopover"
+          :size="props.size"
+          :placeholder="props.placeholder"
+          :label="props.label"
+          :errors="props.errors"
+          :message="props.message"
+          :iconRight="openPopover ? 'keyboard_arrow_up' : 'keyboard_arrow_down'"
+          :disabled="props.disabled"
+          :showClear="!!selectedItem"
+          @clear="emit('update:modelValue', '')"
+        />
+      </PopoverTrigger>
+      <PopoverContent
+        align="start"
+        :class="'h-full'"
+        :style="popoverContentCustomStyles"
+        :width="inputWidthString"
+      >
+        <div class="unnnic-select__content">
+          <UnnnicInput
+            v-if="props.enableSearch"
+            class="unnnic-select__input-search"
+            :modelValue="props.search"
+            :placeholder="$t('search')"
+            iconLeft="search"
+            @update:model-value="handleSearch"
+          />
+          <p
+            v-if="filteredOptions.length === 0"
+            class="unnnic-select__content-no-results"
+          >
+            {{ $t('without_results') }}
+          </p>
+          <PopoverOption
+            v-for="(option, index) in filteredOptions"
+            v-else
+            :key="option[props.itemValue]"
+            :data-option-index="index"
+            data-testid="select-option"
+            :label="option[props.itemLabel]"
+            :active="
+              option[props.itemValue] === selectedItem?.[props.itemValue]
+            "
+            :focused="focusedOptionIndex === index"
+            :disabled="option.disabled"
+            @click="handleSelectOption(option)"
+          />
+        </div>
+      </PopoverContent>
+    </Popover>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, watch, nextTick } from 'vue';
+import { useElementSize } from '@vueuse/core';
+
+import UnnnicInput from '../Input/Input.vue';
+
+import {
+  Popover,
+  PopoverTrigger,
+  PopoverContent,
+  PopoverOption,
+} from '../ui/popover/index';
+
+import UnnnicI18n from '../../mixins/i18n';
+
+defineOptions({
+  name: 'UnnnicSelect',
+  mixins: [UnnnicI18n],
+});
+
+interface SelectProps {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  options: Array<{ [key: string]: any }>;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  modelValue: any;
+  returnObject?: boolean;
+  itemLabel?: string;
+  itemValue?: string;
+  placeholder?: string;
+  label?: string;
+  type?: 'normal' | 'error';
+  errors?: string | Array<string>;
+  message?: string;
+  size?: 'sm' | 'md';
+  optionsLines?: number;
+  enableSearch?: boolean;
+  search?: string;
+  locale?: string;
+  disabled?: boolean;
+}
+
+const props = withDefaults(defineProps<SelectProps>(), {
+  size: 'md',
+  type: 'normal',
+  placeholder: '',
+  optionsLines: 5,
+  returnObject: false,
+  itemLabel: 'label',
+  itemValue: 'value',
+  locale: 'en',
+  enableSearch: false,
+  disabled: false,
+  label: '',
+  errors: '',
+  message: '',
+  search: '',
+});
+
+const emit = defineEmits<{
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  'update:modelValue': [value: any];
+  'update:search': [value: string];
+}>();
+
+const openPopover = ref(false);
+const inputRef = ref<HTMLInputElement | null>(null);
+const { width: inputWidth } = useElementSize(inputRef);
+
+const inputWidthString = computed(() => {
+  return `${inputWidth.value}px`;
+});
+
+watch(openPopover, () => {
+  if (!openPopover.value) {
+    handleSearch('');
+  } else {
+    focusedOptionIndex.value = -1;
+  }
+
+  if (openPopover.value && props.modelValue) {
+    const selectedOptionIndex = props.options.findIndex(
+      (option) =>
+        option[props.itemValue] === selectedItem.value?.[props.itemValue],
+    );
+    scrollToOption(selectedOptionIndex, 'instant', 'center');
+  }
+});
+
+const handleKeyDown = (event) => {
+  const { key } = event;
+  const validKeys = ['ArrowUp', 'ArrowDown', 'Enter'];
+
+  if (validKeys.includes(key)) {
+    event.preventDefault();
+    if (key === 'ArrowUp') {
+      if (focusedOptionIndex.value === 0) return;
+      focusedOptionIndex.value--;
+      scrollToOption(focusedOptionIndex.value);
+    }
+    if (key === 'ArrowDown') {
+      if (focusedOptionIndex.value === filteredOptions.value.length - 1) return;
+      focusedOptionIndex.value++;
+      scrollToOption(focusedOptionIndex.value);
+    }
+    if (key === 'Enter' && focusedOptionIndex.value !== -1) {
+      handleSelectOption(filteredOptions.value[focusedOptionIndex.value]);
+    }
+  }
+};
+
+const focusedOptionIndex = ref<number>(-1);
+
+const scrollToOption = (
+  index: number,
+  behavior: 'smooth' | 'instant' = 'smooth',
+  block: 'center' | 'start' | 'end' | 'nearest' = 'center',
+) => {
+  nextTick(() => {
+    const option = document.querySelector(`[data-option-index="${index}"]`);
+    if (option) {
+      option.scrollIntoView?.({ behavior, block });
+    }
+  });
+};
+
+const calculatedPopoverHeight = computed(() => {
+  if (!props.options || props.options.length === 0) return 'unset';
+  const popoverPadding = 32;
+  const popoverGap = 4;
+  // 37 = 21px (height) + 16px (padding)
+  const fieldsHeight = 37 * props.optionsLines;
+  const gapsCompensation = props.enableSearch ? 1 : 2;
+
+  const size =
+    fieldsHeight +
+    popoverPadding +
+    (popoverGap * props.optionsLines - gapsCompensation);
+
+  return `${props.enableSearch ? size + 45 + 1 : size}px`;
+});
+
+const popoverContentCustomStyles = computed(() => {
+  const emptyFilteredOptions = filteredOptions.value?.length === 0;
+  return {
+    overflow: 'auto',
+    display: 'flex',
+    flexDirection: 'column',
+    minHeight: calculatedPopoverHeight.value,
+    maxHeight: emptyFilteredOptions ? 'unset' : calculatedPopoverHeight.value,
+    height: emptyFilteredOptions ? calculatedPopoverHeight.value : 'unset',
+  };
+});
+
+const selectedItem = computed(() => {
+  if (props.returnObject) return props.modelValue;
+
+  return props.options.find(
+    (option) => option[props.itemValue] === props.modelValue,
+  );
+});
+
+const inputValue = computed(() => {
+  return selectedItem.value?.[props.itemLabel];
+});
+
+const handleSelectOption = (option) => {
+  if (
+    option[props.itemValue] === selectedItem.value?.[props.itemValue] ||
+    option.disabled
+  )
+    return;
+
+  emit(
+    'update:modelValue',
+    props.returnObject ? option : option[props.itemValue],
+  );
+  openPopover.value = false;
+};
+
+const handleSearch = (value: string) => {
+  emit('update:search', value);
+};
+
+const filteredOptions = computed(() => {
+  if (!props.enableSearch || !props.search) return props.options;
+
+  return props.options.filter(
+    (option) =>
+      option[props.itemLabel]
+        .toLowerCase()
+        .includes(props.search?.toLowerCase()) ||
+      option[props.itemValue]
+        .toLowerCase()
+        .includes(props.search?.toLowerCase()),
+  );
+});
+</script>
+
+<style lang="scss" scoped>
+@use '@/assets/scss/unnnic' as *;
+
+:deep(.unnnic-select__input) {
+  cursor: pointer;
+}
+
+:deep(.unnnic-select__input-search) {
+  > .icon-left {
+    color: $unnnic-color-fg-base;
+  }
+}
+
+:deep(.unnnic-select__input) {
+  > .icon-right {
+    color: $unnnic-color-fg-base;
+  }
+}
+
+.unnnic-select {
+  &__content {
+    display: flex;
+    flex-direction: column;
+    padding: 0;
+    margin: 0;
+    gap: $unnnic-space-1;
+
+    height: -webkit-fill-available;
+
+    &-no-results {
+      margin: 0;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      height: 100%;
+      font: $unnnic-font-emphasis;
+      color: $unnnic-color-fg-muted;
+    }
+  }
+}
+</style>

package/src/components/index.ts

@@ -34,7 +34,7 @@ import modal from './Modal/Modal.vue';
 import modalUpload from './ModalUpload/ModalUpload.vue';
 import { callAlert, callModal } from '../utils/call';
 import selectSmart from './SelectSmart/SelectSmart.vue';
-// import select from './Select/Select.vue';
+import select from './Select/index.vue';
 import selectItem from './Select/SelectItem.vue';
 // import selectListItem from './SelectListItem/SelectListItem.vue';
 import multiSelect from './MultiSelect/MultiSelect.vue';
@@ -156,7 +156,7 @@ export const components: ComponentsMap = {
   unnnicModalDialog: ModalDialog,
   unnnicModalUpload: modalUpload,
   unnnicSelectSmart: selectSmart,
-  // unnnicSelect: select,
+  unnnicSelect: select,
   unnnicSelectItem: selectItem,
   // unnnicSelectListItem: selectListItem,
   unnnicMultiSelect: multiSelect,
@@ -271,7 +271,7 @@ export const unnnicModalDialog = ModalDialog;
 export const unnnicModalNext = ModalNext;
 export const unnnicModalUpload = modalUpload;
 export const unnnicSelectSmart = selectSmart as VueComponent;
-// export const unnnicSelect = select;
+export const unnnicSelect = select as VueComponent;
 export const unnnicSelectItem = selectItem;
 // export const unnnicSelectListItem = selectListItem;
 export const unnnicMultiSelect = multiSelect as VueComponent;
@@ -385,7 +385,7 @@ export const UnnnicModalDialog = ModalDialog;
 export const UnnnicModalNext = ModalNext;
 export const UnnnicModalUpload = modalUpload;
 export const UnnnicSelectSmart = selectSmart as VueComponent;
-// export const UnnnicSelect = select;
+export const UnnnicSelect = select as VueComponent;
 export const UnnnicSelectItem = selectItem;
 // export const UnnnicSelectListItem = selectListItem;
 export const UnnnicMultiSelect = multiSelect as VueComponent;

package/src/components/ui/popover/PopoverOption.vue

@@ -98,6 +98,10 @@ const schemeColor = computed(() => {
   }
 
   &__label {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+
     @each $name, $color in $unnnic-scheme-colors {
       &.unnnic-popover-option__label--#{$name} {
         color: $color;

package/src/locales/en.json

@@ -44,5 +44,7 @@
       "flags": "Flags",
       "custom": "Custom"
     }
-  }
+  },
+  "search": "Search",
+  "without_results": "No results found"
 }

package/src/locales/es.json

@@ -44,5 +44,7 @@
       "flags": "Banderas",
       "custom": "Personalizados"
     }
-  }
+  },
+  "search": "Buscar",
+  "without_results": "No se encontró ningún resultado"
 }

package/src/locales/pt_br.json

@@ -44,5 +44,7 @@
       "flags": "Bandeiras",
       "custom": "Personalizados"
     }
-  }
+  },
+  "search": "Buscar",
+  "without_results": "Nenhum resultado encontrado"
 }

package/src/stories/Input.mdx

@@ -42,6 +42,9 @@ The `Input` component is designed to provide an input field for users to enter t
 | placeholder | `String` of the native input placeholder | `String`                 | `''`        |
 | iconLeft    | `String` of the left icon                | `String`                 | `undefined` |
 | iconRight   | `String` of the right icon               | `String`                 | `false`     |
+| useFocusProp | `Boolean` to enable use focus by prop (ignore native css) | `true` \| `false` | `false` |
+| focus | `Boolean` to enable focus component status | `true` \| `false` | `false` |
+
 
 ## Example
 Some examples of uses of the `UnnnicInput`

package/src/stories/Select.stories.js

@@ -0,0 +1,161 @@
+import UnnnicSelect from '../components/Select/index.vue';
+
+const options = [
+  { label: 'Option 1', value: 'option1', altValue: 'alt_value_option1' },
+  { label: 'Option 2', value: 'option2', altValue: 'alt_value_option2' },
+  { label: 'Option 3', value: 'option3', altValue: 'alt_value_option3' },
+  { label: 'Option 4', value: 'option4', altValue: 'alt_value_option4' },
+  { label: 'Option 5', value: 'option5', altValue: 'alt_value_option5' },
+  { label: 'Option 6', value: 'option6', altValue: 'alt_value_option6' },
+  { label: 'Option 7', value: 'option7', altValue: 'alt_value_option7' },
+  { label: 'Option 8', value: 'option8', altValue: 'alt_value_option8' },
+  { label: 'Option 9', value: 'option9', altValue: 'alt_value_option9' },
+  { label: 'Option 10', value: 'option10', disabled: true },
+];
+
+export default {
+  title: 'Form/Select',
+  component: UnnnicSelect,
+  tags: ['autodocs'],
+  parameters: {
+    docs: {
+      description: {
+        component:
+          'Select is designed to solve common problems related to option selection.',
+      },
+    },
+  },
+  argTypes: {
+    options: {
+      description:
+        'List of items to be displayed in the options. If an item has a `disabled` key set to `true`, that item will be disabled. By default, the component looks for the `label` and `value` keys to display and update the model, but these are not required if you wish to customize them using the `itemLabel` and `itemValue` props, respectively.',
+    },
+    placeholder: {
+      description: 'Text to be displayed in the placeholder.',
+    },
+    label: {
+      description: 'Text to be displayed in the label.',
+    },
+    modelValue: {
+      description:
+        'Model variable. Its type will always match the return type of the key specified by `itemValue`, or the entire options object when `returnObject` prop is set to `true`.',
+    },
+    returnObject: {
+      description:
+        'Prop to indicate that the full option object should be returned in the v-model.',
+    },
+    itemLabel: {
+      description:
+        'Field of the option item that should be used to render the option label.',
+    },
+    itemValue: {
+      description:
+        'Field of the option item that should be used to return value to v-model.',
+    },
+    type: {
+      description: 'Select state type',
+    },
+    errors: {
+      description:
+        "Error message or messages. When it's an array, the messages will be separated by commas.",
+    },
+    message: {
+      description: 'Help or hint message.',
+    },
+    size: {
+      description: 'Select size',
+    },
+    optionsLines: {
+      description:
+        'Number of options to display at most; if exceeded, scrolling will be enabled.',
+    },
+    enableSearch: {
+      description:
+        'If true, enables a search field displayed inside the options popover. The `update:search` event is emitted on each input.',
+    },
+    search: {
+      description: 'Search value.',
+    },
+    locale: {
+      description: 'Locale for i18n translations.',
+    },
+    disabled: {
+      description: 'Disable the select.',
+    },
+  },
+  render: (args) => ({
+    components: { UnnnicSelect },
+    setup() {
+      const handleSearch = (value) => {
+        args.search = value;
+      };
+      return { args, handleSearch };
+    },
+    data() {
+      return {
+        exampleValue: null,
+      };
+    },
+    template: `
+      <div style="width: 300px;">
+        <p>modelValue: {{ exampleValue }}</p>
+        <unnnic-select v-model="exampleValue" v-bind="args" @update:search="handleSearch" />
+      </div>
+      
+    `,
+  }),
+};
+
+export const Default = {
+  args: {
+    placeholder: 'Placeholder',
+    label: 'Label',
+    options,
+  },
+};
+
+export const ReturnObject = {
+  args: {
+    returnObject: true,
+    placeholder: 'Placeholder',
+    label: 'Label',
+    options,
+  },
+};
+
+export const AlternativeValueKey = {
+  args: {
+    itemValue: 'altValue',
+    placeholder: 'Placeholder',
+    label: 'Label',
+    options,
+  },
+};
+
+export const AlternativeValueLabel = {
+  args: {
+    itemLabel: 'altValue',
+    placeholder: 'Placeholder',
+    label: 'Label',
+    options,
+  },
+};
+
+export const Disabled = {
+  args: {
+    placeholder: 'Placeholder',
+    label: 'Label',
+    options,
+    disabled: true,
+  },
+};
+
+export const WithSearch = {
+  args: {
+    placeholder: 'Placeholder',
+    label: 'Label',
+    options,
+    enableSearch: true,
+    search: '',
+  },
+};