Design system.
Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.
 
 
 

296 lignes
7.6 KiB

  1. import * as React from 'react';
  2. import { TextControl, tailwind } from '@tesseract-design/web-base';
  3. import { useFallbackId } from '@modal-sh/react-utils';
  4. const { tw } = tailwind;
  5. const MenuSelectDerivedElementComponent = 'select' as const;
  6. /**
  7. * Derived HTML element of the {@link MenuSelect} component.
  8. */
  9. export type MenuSelectDerivedElement = HTMLElementTagNameMap[
  10. typeof MenuSelectDerivedElementComponent
  11. ];
  12. /**
  13. * Props of the {@link MenuSelect} component.
  14. */
  15. export interface MenuSelectProps extends Omit<React.HTMLProps<MenuSelectDerivedElement>, 'size' | 'style' | 'label' | 'multiple'> {
  16. /**
  17. * Short textual description indicating the nature of the component's value.
  18. */
  19. label?: React.ReactNode,
  20. /**
  21. * Short textual description as guidelines for valid input values.
  22. */
  23. hint?: React.ReactNode,
  24. /**
  25. * Size of the component.
  26. */
  27. size?: TextControl.Size,
  28. /**
  29. * Additional description, usually graphical, indicating the nature of the component's value.
  30. */
  31. indicator?: React.ReactNode,
  32. /**
  33. * Should the component display a border?
  34. */
  35. border?: boolean,
  36. /**
  37. * Should the component occupy the whole width of its parent?
  38. */
  39. block?: boolean,
  40. /**
  41. * Style of the component.
  42. */
  43. variant?: TextControl.Variant,
  44. /**
  45. * Is the label hidden?
  46. */
  47. hiddenLabel?: boolean,
  48. /**
  49. * Starting height of the component.
  50. */
  51. startingHeight?: number | string,
  52. /**
  53. * Should the component be resizable?
  54. */
  55. resizable?: boolean,
  56. }
  57. export const menuSelectPlugin: tailwind.PluginCreator = ({ addComponents }) => {
  58. addComponents({
  59. '.menu-select': {
  60. '&[data-variant="alternate"][data-size="small"]': {
  61. '--td-padding-top': '1.25rem',
  62. },
  63. '&[data-variant="alternate"][data-size="medium"]': {
  64. '--td-padding-top': '1.5rem',
  65. },
  66. '&[data-variant="alternate"][data-size="large"]': {
  67. '--td-padding-top': '2rem',
  68. },
  69. '&[data-variant="default"][data-size="small"]': {
  70. '--td-padding-top': '0.625rem',
  71. '--td-padding-bottom': '0.625rem',
  72. },
  73. '&[data-variant="default"][data-size="medium"]': {
  74. '--td-padding-top': '0.75rem',
  75. '--td-padding-bottom': '0.75rem',
  76. },
  77. '&[data-variant="default"][data-size="large"]': {
  78. '--td-padding-top': '1.25rem',
  79. '--td-padding-bottom': '1.25rem',
  80. },
  81. 'padding-top': 'var(--td-padding-top, 0)',
  82. 'padding-bottom': 'var(--td-padding-bottom, 0)',
  83. 'scrollbar-width': '0',
  84. '&::-webkit-scrollbar': {
  85. 'display': 'none',
  86. },
  87. '& optgroup': {
  88. 'color': 'rgb(var(--color-positive) / 50%)',
  89. 'text-transform': 'uppercase',
  90. 'font-size': '0.75em',
  91. 'margin-top': '0.5rem',
  92. 'user-select': 'none',
  93. },
  94. '& optgroup > option': {
  95. 'color': 'rgb(var(--color-positive))',
  96. 'text-transform': 'none',
  97. 'font-size': '1.333333em',
  98. },
  99. '& option': {
  100. 'user-select': 'none',
  101. },
  102. },
  103. });
  104. };
  105. /**
  106. * Component for selecting a single value from a menu.
  107. */
  108. export const MenuSelect = React.forwardRef<MenuSelectDerivedElement, MenuSelectProps>((
  109. {
  110. label,
  111. hint,
  112. indicator,
  113. size = 'medium' as const,
  114. border = false as const,
  115. block = false as const,
  116. variant = 'default' as const,
  117. hiddenLabel = false as const,
  118. className,
  119. startingHeight = '15rem' as const,
  120. id: idProp,
  121. resizable = false as const,
  122. ...etcProps
  123. }: MenuSelectProps,
  124. forwardedRef,
  125. ) => {
  126. const labelId = React.useId();
  127. const id = useFallbackId(idProp);
  128. return (
  129. <div
  130. className={tw(
  131. 'bg-negative relative rounded ring-secondary/50 group has-[:disabled]:opacity-50',
  132. 'focus-within:ring-4',
  133. {
  134. 'block': block,
  135. 'inline-block align-middle': !block,
  136. },
  137. className,
  138. )}
  139. data-testid="base"
  140. >
  141. <div
  142. className={tw(
  143. 'w-full overflow-hidden min-h-16 relative min-h-16 rounded-inherit',
  144. {
  145. 'resize': !block && resizable,
  146. 'resize-y': block && resizable,
  147. },
  148. {
  149. 'min-h-10': size === 'small',
  150. 'min-h-12': size === 'medium',
  151. 'min-h-16': size === 'large',
  152. },
  153. )}
  154. style={{
  155. height: startingHeight,
  156. }}
  157. >
  158. {label && (
  159. <>
  160. <label
  161. data-testid="label"
  162. htmlFor={id}
  163. id={labelId}
  164. className={tw(
  165. 'bg-negative absolute z-[1] w-full top-0 pt-0.5 left-0 pointer-events-none pl-1 text-xxs font-bold group-focus-within:text-secondary text-primary leading-none select-none',
  166. {
  167. 'sr-only': hiddenLabel,
  168. },
  169. {
  170. 'pr-1': !indicator,
  171. },
  172. {
  173. 'pr-10': indicator && size === 'small',
  174. 'pr-12': indicator && size === 'medium',
  175. 'pr-16': indicator && size === 'large',
  176. },
  177. )}
  178. >
  179. <span className="block w-full whitespace-nowrap h-[1.1em] overflow-hidden text-ellipsis">
  180. {label}
  181. </span>
  182. </label>
  183. {' '}
  184. </>
  185. )}
  186. <MenuSelectDerivedElementComponent
  187. {...etcProps}
  188. ref={forwardedRef}
  189. id={id}
  190. aria-labelledby={labelId}
  191. data-testid="input"
  192. size={2}
  193. data-variant={variant}
  194. data-size={size}
  195. className={tw(
  196. 'menu-select bg-negative rounded-inherit w-full h-full peer block overflow-auto cursor-pointer font-inherit',
  197. 'focus:outline-0',
  198. 'disabled:opacity-50 disabled:cursor-not-allowed',
  199. {
  200. 'text-xxs': size === 'small',
  201. 'text-xs': size === 'medium',
  202. },
  203. {
  204. 'pl-4': variant === 'default',
  205. 'pl-1.5': variant === 'alternate',
  206. },
  207. {
  208. 'pr-4': variant === 'default' && !indicator,
  209. 'pr-1.5': variant === 'alternate' && !indicator,
  210. },
  211. {
  212. 'pr-10': indicator && size === 'small',
  213. 'pr-12': indicator && size === 'medium',
  214. 'pr-16': indicator && size === 'large',
  215. },
  216. )}
  217. />
  218. {hint && (
  219. <div
  220. data-testid="hint"
  221. className={tw(
  222. 'bg-negative absolute left-0 px-1 pointer-events-none text-xxs leading-none w-full select-none',
  223. {
  224. 'bottom-0 pl-4 pb-1': variant === 'default',
  225. 'top-0.5': variant === 'alternate',
  226. },
  227. {
  228. 'pt-2': variant === 'alternate' && size === 'small',
  229. 'pt-3': variant === 'alternate' && size !== 'small',
  230. },
  231. {
  232. 'pr-4': !indicator && variant === 'default',
  233. 'pr-1': !indicator && variant === 'alternate',
  234. },
  235. {
  236. 'pr-10': indicator && size === 'small',
  237. 'pr-12': indicator && size === 'medium',
  238. 'pr-16': indicator && size === 'large',
  239. },
  240. )}
  241. >
  242. <div
  243. className="opacity-50 whitespace-nowrap w-full h-[1.1em] overflow-hidden text-ellipsis"
  244. >
  245. {hint}
  246. </div>
  247. </div>
  248. )}
  249. {indicator && (
  250. <div
  251. data-testid="indicator"
  252. className={tw(
  253. 'text-center flex items-center justify-center aspect-square absolute bottom-0 right-0 pointer-events-none select-none',
  254. {
  255. 'w-10': size === 'small',
  256. 'w-12': size === 'medium',
  257. 'w-16': size === 'large',
  258. },
  259. )}
  260. >
  261. {indicator}
  262. </div>
  263. )}
  264. {border && (
  265. <span
  266. data-testid="border"
  267. className="absolute z-[1] inset-0 rounded-inherit border-2 border-primary pointer-events-none peer-focus:border-secondary"
  268. />
  269. )}
  270. </div>
  271. </div>
  272. );
  273. });
  274. MenuSelect.displayName = 'MenuSelect' as const;
  275. MenuSelect.defaultProps = {
  276. label: undefined,
  277. hint: undefined,
  278. indicator: undefined,
  279. size: 'medium' as const,
  280. border: false as const,
  281. block: false as const,
  282. variant: 'default' as const,
  283. hiddenLabel: false as const,
  284. startingHeight: '15rem' as const,
  285. resizable: false as const,
  286. };