aboutsummaryrefslogtreecommitdiffstats
path: root/src/components/atoms/forms/label/label.tsx
blob: 6692205c5e16e59ed20a41348613796df79bff2c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
import type { FC, LabelHTMLAttributes, ReactNode } from 'react';
import styles from './label.module.scss';

export type LabelSize = 'md' | 'sm';

export type LabelProps = Omit<
  LabelHTMLAttributes<HTMLLabelElement>,
  'hidden' | 'size'
> & {
  /**
   * The label body.
   */
  children: ReactNode;
  /**
   * Should the label be hidden?
   *
   * @default false
   */
  isHidden?: boolean;
  /**
   * Is the field required?
   *
   * @default false
   */
  isRequired?: boolean;
  /**
   * The label size.
   *
   * @default 'sm'
   */
  size?: LabelSize;
};

/**
 * Label Component
 *
 * Render a HTML label element.
 */
export const Label: FC<LabelProps> = ({
  children,
  className = '',
  isHidden = false,
  isRequired = false,
  size = 'sm',
  ...props
}) => {
  const visibilityClass = isHidden ? 'screen-reader-text' : '';
  const sizeClass = styles[`label--${size}`];
  const labelClass = `${styles.label} ${sizeClass} ${visibilityClass} ${className}`;
  const requiredSymbol = ' *';

  return (
    <label {...props} className={labelClass}>
      {children}
      {isRequired ? (
        <span aria-hidden className={styles.required}>
          {requiredSymbol}
        </span>
      ) : null}
    </label>
  );
};