diff options
Diffstat (limited to 'src/components/atoms')
| -rw-r--r-- | src/components/atoms/forms/forms.module.scss | 4 | ||||
| -rw-r--r-- | src/components/atoms/forms/select.stories.tsx | 116 | ||||
| -rw-r--r-- | src/components/atoms/forms/select.tsx | 77 | 
3 files changed, 197 insertions, 0 deletions
| diff --git a/src/components/atoms/forms/forms.module.scss b/src/components/atoms/forms/forms.module.scss index 5347bad..5a61522 100644 --- a/src/components/atoms/forms/forms.module.scss +++ b/src/components/atoms/forms/forms.module.scss @@ -8,6 +8,10 @@    box-shadow: fun.convert-px(3) fun.convert-px(3) 0 0 var(--color-shadow);    transition: all 0.25s linear 0s; +  &--select { +    cursor: pointer; +  } +    &--textarea {      min-height: fun.convert-px(200);    } diff --git a/src/components/atoms/forms/select.stories.tsx b/src/components/atoms/forms/select.stories.tsx new file mode 100644 index 0000000..683e3b5 --- /dev/null +++ b/src/components/atoms/forms/select.stories.tsx @@ -0,0 +1,116 @@ +import { ComponentMeta, ComponentStory } from '@storybook/react'; +import SelectComponent from './select'; + +const selectOptions = [ +  { id: 'option1', name: 'Option 1', value: 'option1' }, +  { id: 'option2', name: 'Option 2', value: 'option2' }, +  { id: 'option3', name: 'Option 3', value: 'option3' }, +]; + +export default { +  title: 'Atoms/Forms', +  component: SelectComponent, +  argTypes: { +    disabled: { +      control: { +        type: 'boolean', +      }, +      description: 'Field state: either enabled or disabled.', +      table: { +        category: 'Options', +        defaultValue: { summary: false }, +      }, +      type: { +        name: 'boolean', +        required: false, +      }, +    }, +    id: { +      control: { +        type: 'text', +      }, +      description: 'Field id.', +      table: { +        category: 'Options', +      }, +      type: { +        name: 'string', +        required: false, +      }, +    }, +    name: { +      control: { +        type: 'text', +      }, +      description: 'Field name.', +      table: { +        category: 'Options', +      }, +      type: { +        name: 'string', +        required: false, +      }, +    }, +    options: { +      control: { +        type: null, +      }, +      description: 'Select options.', +      type: { +        name: 'array', +        required: true, +        value: { +          name: 'string', +        }, +      }, +    }, +    required: { +      control: { +        type: 'boolean', +      }, +      description: 'Determine if the field is required.', +      table: { +        category: 'Options', +        defaultValue: { summary: false }, +      }, +      type: { +        name: 'boolean', +        required: false, +      }, +    }, +    setValue: { +      control: { +        type: null, +      }, +      description: 'Callback function to set field value.', +      table: { +        category: 'Events', +      }, +      type: { +        name: 'function', +        required: true, +      }, +    }, +    value: { +      control: { +        type: 'text', +      }, +      description: 'Field value.', +      type: { +        name: 'string', +        required: true, +      }, +    }, +  }, +} as ComponentMeta<typeof SelectComponent>; + +const Template: ComponentStory<typeof SelectComponent> = (args) => ( +  <SelectComponent {...args} /> +); + +export const Select = Template.bind({}); +Select.args = { +  options: selectOptions, +  setValue: () => null, +  value: 'option2', +}; diff --git a/src/components/atoms/forms/select.tsx b/src/components/atoms/forms/select.tsx new file mode 100644 index 0000000..6e46660 --- /dev/null +++ b/src/components/atoms/forms/select.tsx @@ -0,0 +1,77 @@ +import { ChangeEvent, FC, SetStateAction } from 'react'; +import styles from './forms.module.scss'; + +type SelectOptions = { +  id: string; +  name: string; +  value: string; +}; + +type SelectProps = { +  /** +   * Field state. Either enabled (false) or disabled (true). +   */ +  disabled?: boolean; +  /** +   * Field id attribute. +   */ +  id?: string; +  /** +   * Field name attribute. +   */ +  name?: string; +  /** +   * True if the field is required. Default: false. +   */ +  options: SelectOptions[]; +  /** +   * True if the field is required. Default: false. +   */ +  required?: boolean; +  /** +   * Callback function to set field value. +   */ +  setValue: (value: SetStateAction<string>) => void; +  /** +   * Field value. +   */ +  value: string; +}; + +/** + * Select component + * + * Render a HTML select element. + */ +const Select: FC<SelectProps> = ({ options, setValue, ...props }) => { +  /** +   * Update select value when an option is selected. +   * @param e - The option change event. +   */ +  const updateValue = (e: ChangeEvent<HTMLSelectElement>) => { +    setValue(e.target.value); +  }; + +  /** +   * Get the option elements. +   * @returns {JSX.Element[]} An array of HTML option elements. +   */ +  const getOptions = (): JSX.Element[] => +    options.map((option) => ( +      <option key={option.id} value={option.value}> +        {option.name} +      </option> +    )); + +  return ( +    <select +      className={`${styles.field} ${styles['field--select']}`} +      onChange={updateValue} +      {...props} +    > +      {getOptions()} +    </select> +  ); +}; + +export default Select; | 
