@dktunited-techoff/techoff-suite-ui 1.5.7 → 1.6.1

package/src/components/TsDropdown/TsDropdown/TsDropdown.css

@@ -0,0 +1,92 @@
+.ts-dropdown-container {
+  position: relative;
+  width: 100%;
+}
+.ts-dropdown-input {
+  display: flex;
+  align-items: center;
+  width: 100%;
+  height: 32px;
+  padding-left: 10px;
+  border: 1px solid #949494;
+  cursor: pointer;
+}
+.ts-dropdown-input--disabled {
+  background: #fafafa;
+  cursor: not-allowed;
+}
+.ts-dropdown-input--placeholder {
+  flex: 1;
+  color: #7a7a7a;
+  font-weight: 400;
+}
+.ts-dropdown-input--value {
+  flex: 1;
+  font-weight: 600;
+}
+.ts-dropdown-input--chevron {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+}
+/* ####### */
+/* LABEL   */
+.ts-dropdown-label {
+  padding-bottom: 6px;
+}
+/* ###### */
+/* MENU   */
+.ts-dropdown-menu-container {
+  position: absolute;
+  top: calc(100%+8px);
+  display: flex;
+  flex-direction: column;
+  min-width: 100%;
+  max-height: 250px;
+  padding: 12px;
+  box-shadow: 0px 8px 9px 0px #1010101a;
+  background: #ffffff;
+  overflow: hidden;
+  z-index: 10;
+}
+.ts-dropdown-search {
+  padding-bottom: 12px;
+  margin-bottom: 12px;
+  border-bottom: 1px solid #d9dde1;
+}
+.ts-dropdown-menu {
+  overflow: auto;
+}
+.ts-dropdown-menu-loader {
+  display: flex;
+  justify-content: center;
+}
+.ts-dropdown-menu-error-text {
+  display: flex;
+  justify-content: center;
+  color: #7a7a7a;
+  font-style: italic;
+}
+.ts-dropdown-menu-item {
+  display: flex;
+  align-items: center;
+  height: 36px;
+  padding: 0 12px;
+  cursor: pointer;
+}
+.ts-dropdown-menu-item:hover {
+  background: #e1e3f5;
+  color: #3643ba;
+}
+
+/* ######### */
+/* GLOBALS   */
+* {
+  font-size: 14px;
+  outline: none;
+  box-sizing: border-box;
+  font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans',
+    'Helvetica Neue', sans-serif;
+}

package/src/components/TsDropdown/TsDropdown/TsDropdown.tsx

@@ -0,0 +1,131 @@
+import * as React from 'react';
+import { useEffect, useState } from 'react';
+import { TsDropdownProps } from './TsDropdown.types';
+import { TsIcon } from '../../TsIcon/TsIcon';
+import { TsInput } from '../../TsInput/TsInput/TsInput';
+import { useClickOutside } from '../../../hooks/use-click-outside';
+import { capitalize } from '../../../utils/string.utils';
+import './TsDropdown.css';
+import { TsLoader } from '../../TsLoader/TsLoader';
+
+export const TsDropdown = <T extends unknown>({
+  label,
+  options,
+  placeholder,
+  searchPlaceholder,
+  value,
+  disabled,
+  searchable,
+  getOptionValue,
+  getOptionLabel,
+  loadOptions,
+  onChange,
+}: TsDropdownProps<T>) => {
+  const [showDropdownMenu, setShowDropdownMenu] = useState<boolean>(false);
+  const [searchValue, setSearchValue] = useState<string>('');
+  const [items, setItems] = useState<T[]>(options ?? []);
+  const [selectedItem, setSelectedItem] = useState<T | undefined>(value);
+  const [loading, setLoading] = useState<boolean>(false);
+  const [isFetchError, setIsFetchError] = useState<boolean>(false);
+  const ref = useClickOutside(() => setShowDropdownMenu(false));
+
+  // ########
+  // Fetchers
+  const fetchOptions = () => {
+    if (!options && loadOptions) {
+      setLoading(true);
+      setIsFetchError(false);
+      loadOptions(searchValue)
+        .then(setItems)
+        .catch(() => setIsFetchError(true))
+        .finally(() => setLoading(false));
+    }
+  };
+
+  // ########
+  // Handlers
+  const handleSelectItem = (item: T) => {
+    setSelectedItem(item);
+    setShowDropdownMenu(false);
+    onChange(item);
+  };
+  const handleShowDropdownMenu = () => !disabled && setShowDropdownMenu(true);
+
+  // ########
+  // Watchers
+  useEffect(fetchOptions, []);
+  useEffect(() => {
+    if (searchable && options) {
+      setItems(options.filter(option => getOptionLabel(option).toLowerCase().includes(searchValue.toLowerCase())));
+    }
+
+    if (searchable && !options && loadOptions) {
+      const timeOutId = setTimeout(fetchOptions, 500);
+      return () => clearTimeout(timeOutId);
+    }
+
+    return () => {};
+  }, [searchValue]);
+
+  // #########
+  // Rendering
+  return (
+    <div className="ts-dropdown-container" ref={ref}>
+      <div className="ts-dropdown-input-container">
+        {label && <div className="ts-dropdown-label">{label}</div>}
+        <div
+          className={`ts-dropdown-input ${disabled ? 'ts-dropdown-input--disabled' : ''}`}
+          onClick={handleShowDropdownMenu}
+        >
+          {!selectedItem && placeholder && <div className="ts-dropdown-input--placeholder">{placeholder}</div>}
+          {selectedItem && <div className="ts-dropdown-input--value">{getOptionLabel(selectedItem)}</div>}
+          <div className="ts-dropdown-input--chevron">
+            <TsIcon name="chevron-down" />
+          </div>
+        </div>
+      </div>
+
+      {!disabled && showDropdownMenu && (
+        <div className="ts-dropdown-menu-container">
+          {searchable && (
+            <div className="ts-dropdown-search">
+              <TsInput
+                icon="search"
+                placeholder={searchPlaceholder}
+                value={searchValue}
+                autoFocus
+                onChange={setSearchValue}
+              />
+            </div>
+          )}
+
+          <div className="ts-dropdown-menu">
+            {loading && (
+              <div className="ts-dropdown-menu-loader">
+                <TsLoader size="sm" />
+              </div>
+            )}
+            {!loading && isFetchError && (
+              <div className="ts-dropdown-menu-error-text">An error occured, try again later.</div>
+            )}
+            {!loading && !isFetchError && items.length === 0 && (
+              <div className="ts-dropdown-menu-error-text">No options found.</div>
+            )}
+            {!loading &&
+              !isFetchError &&
+              items.length > 0 &&
+              items.map(item => (
+                <div
+                  key={getOptionValue(item)}
+                  className="ts-dropdown-menu-item"
+                  onClick={() => handleSelectItem(item)}
+                >
+                  {capitalize(getOptionLabel(item))}
+                </div>
+              ))}
+          </div>
+        </div>
+      )}
+    </div>
+  );
+};

package/src/components/TsDropdown/TsDropdown/TsDropdown.types.ts

@@ -0,0 +1,13 @@
+export type TsDropdownProps<T> = {
+  label?: string;
+  options?: T[];
+  placeholder?: string;
+  searchPlaceholder?: string;
+  value?: T;
+  disabled?: boolean;
+  searchable?: boolean;
+  getOptionLabel: (option: T) => string;
+  getOptionValue: (option: T) => string;
+  loadOptions?: (search?: string) => Promise<T[]>;
+  onChange: (value?: T) => void;
+};

package/src/components/TsDropdown/TsDropdown/__stories__/TsDropdown.stories.mdx

@@ -0,0 +1,68 @@
+import React from 'react';
+import { ArgsTable, Canvas, Meta, Story } from '@storybook/blocks';
+import { TsDropdown } from '../TsDropdown';
+import { fruits } from './fruits';
+
+<Meta title="Components/Dropdown" />
+
+export const dropdownArgTypes = {
+  label: {
+    control: 'text',
+    description: 'Label of the dropdown.',
+  },
+  placeholder: {
+    control: 'text',
+    description: 'Placeholder of the dropdown.',
+  },
+  searchPlaceholder: {
+    control: 'text',
+    description: 'Placeholder of the option search (only for searchable dropdowns).',
+  },
+  searchable: {
+    control: 'boolean',
+    description: 'Enable search on dropdown items.',
+    table: { defaultValue: { summary: 'false' } },
+  },
+  disabled: {
+    control: 'boolean',
+    description: 'Enable state of the dropdown.',
+    table: { defaultValue: { summary: 'false' } },
+  },
+  onChange: {
+    control: 'function',
+    description: 'The handler called when clicking on the dropdown.',
+  },
+};
+
+# Dropdown
+
+Dropdowns show a list of options that can be used to select, filter or sort content.
+
+## Overview
+
+<Canvas>
+  <Story
+    name="Overview"
+    args={{
+      label: 'Label',
+      options: fruits,
+      searchPlaceholder: '',
+      placeholder: 'Select an item',
+      disabled: false,
+      searchable: false,
+      getOptionLabel: function ol(fruit) {
+        return fruit.name;
+      },
+      getOptionValue: function ov(fruit) {
+        return fruit.id;
+      },
+    }}
+    argTypes={dropdownArgTypes}
+  >
+    {args => <TsDropdown {...args}>{args.children}</TsDropdown>}
+  </Story>
+</Canvas>
+
+## Props
+
+<ArgsTable story="Overview" of={TsDropdown} />

package/src/components/TsDropdown/TsDropdown/__stories__/fruits.ts

@@ -0,0 +1,47 @@
+export const fruits = [
+  { name: 'Persimmon', id: 52 },
+  { name: 'Strawberry', id: 3 },
+  { name: 'Banana', id: 1 },
+  { name: 'Tomato', id: 5 },
+  { name: 'Pear', id: 4 },
+  { name: 'Durian', id: 60 },
+  { name: 'Blackberry', id: 64 },
+  { name: 'Lingonberry', id: 65 },
+  { name: 'Kiwi', id: 66 },
+  { name: 'Lychee', id: 67 },
+  { name: 'Pineapple', id: 10 },
+  { name: 'Fig', id: 68 },
+  { name: 'Gooseberry', id: 69 },
+  { name: 'Passionfruit', id: 70 },
+  { name: 'Plum', id: 71 },
+  { name: 'Orange', id: 2 },
+  { name: 'GreenApple', id: 72 },
+  { name: 'Raspberry', id: 23 },
+  { name: 'Watermelon', id: 25 },
+  { name: 'Lemon', id: 26 },
+  { name: 'Mango', id: 27 },
+  { name: 'Blueberry', id: 33 },
+  { name: 'Apple', id: 6 },
+  { name: 'Guava', id: 37 },
+  { name: 'Apricot', id: 35 },
+  { name: 'Papaya', id: 42 },
+  { name: 'Melon', id: 41 },
+  { name: 'Tangerine', id: 77 },
+  { name: 'Pitahaya', id: 78 },
+  { name: 'Lime', id: 44 },
+  { name: 'Pomegranate', id: 79 },
+  { name: 'Dragonfruit', id: 80 },
+  { name: 'Grape', id: 81 },
+  { name: 'Morus', id: 82 },
+  { name: 'Feijoa', id: 76 },
+  { name: 'Avocado', id: 84 },
+  { name: 'Kiwifruit', id: 85 },
+  { name: 'Cranberry', id: 87 },
+  { name: 'Cherry', id: 9 },
+  { name: 'Peach', id: 86 },
+  { name: 'Jackfruit', id: 94 },
+  { name: 'Horned Melon', id: 95 },
+  { name: 'Hazelnut', id: 96 },
+  { name: 'Pomelo', id: 98 },
+  { name: 'Mangosteen', id: 99 },
+];

package/src/components/TsInput/TsInput/TsInput.css

@@ -12,6 +12,7 @@
   font-weight: 600;
 }
 input::placeholder {
+  color: #7a7a7a;
   font-weight: 400;
 }
 input:disabled {

package/src/components/TsInput/TsInput/__stories__/TsInput.stories.mdx

@@ -19,6 +19,11 @@ export const inputArgTypes = {
     control: 'text',
     description: 'Placeholder of the input.',
   },
+  disabled: {
+    control: 'boolean',
+    description: 'Enable state of the input.',
+    table: { defaultValue: { summary: 'false' } },
+  },
 };
 
 # Input
@@ -30,7 +35,7 @@ Input allows the user to enter content and data when the expected user input is
 <Canvas>
   <Story
     name="Overview"
-    args={{ label: '', placeholder: 'Enter some text', onChange: () => {} }}
+    args={{ label: 'Label', placeholder: 'Enter some text', disabled: false, onChange: () => {} }}
     argTypes={inputArgTypes}
   >
     {args => <TsInput {...args} />}

package/src/index.ts

@@ -1,5 +1,6 @@
 export * from './components/TsButton/TsButton';
 export * from './components/TsCheckbox/TsCheckbox';
+export * from './components/TsDropdown/TsDropdown/TsDropdown';
 export * from './components/TsIcon/TsIcon';
 export * from './components/TsInput/TsInput/TsInput';
 export * from './components/TsLoader/TsLoader';