Field: HextaUI y shadcn/ui
El Field de HextaUI mantiene los nombres y tokens de tema de shadcn/ui y se instala con la misma CLI. Esta página lista lo que cambia, leído del código de ambos. El lado de shadcn/ui es su registro base-vega a fecha de 2026-10-16.
De un vistazo
| Medida | HextaUI | shadcn/ui |
|---|---|---|
| Partes exportadas | 13 | 10 |
| Props que gestiona el envoltorio | 12 | 3 |
| Líneas de código | 604 | 238 |
| Dependencias de npm | @base-ui/react@^1.8.0@tabler/icons-reactclass-variance-authoritycn | cn |
| Construido con | inputmotionseparatorthemeuse-composed-refuse-merged-ref | labelseparator |
Más código no es mejor por sí solo. La mayoría de las líneas extra de HextaUI cubren estados, animaciones y casos límite que de otro modo escribirías tú.
Partes
Solo en HextaUIFieldItemFieldStatusFieldCounter
En ambosFieldSetFieldLegendFieldGroupFieldFieldContentFieldLabelFieldTitleFieldDescriptionFieldSeparatorFieldError
Props que añade HextaUI
Props que gestiona el propio envoltorio de HextaUI y el de shadcn/ui no. Se omiten las props que pasan directamente a Base UI o a la librería subyacente, porque ambas versiones las aceptan.
| Prop | Qué hace |
|---|---|
indicatorFieldSet | Se aplica a todos los campos de su interior. |
indicatorFieldGroup | Se aplica a todos los campos de su interior. |
indicatorField | Marca la etiqueta a partir del atributo required del control. Se hereda de FieldGroup o FieldSet. |
optionalTextFieldLabel | Texto que se muestra con indicator="optional". |
La versión de HextaUI
Todos los estados, el mapa de teclado y la referencia de la API están en la página del componente.
14 de sus ejemplos también tienen su propia página.
Cambia un componente
Ejecuta el comando add con --overwrite para reemplazar el archivo de shadcn/ui en @/components/ui y revisa el diff en git antes de quedártelo. Los imports no cambian y los componentes que no reemplaces siguen funcionando.
pnpm dlx shadcn@latest add https://hextaui.com/r/field.json --overwrite- Cada prop de la tabla anterior es nueva, así que el código escrito para shadcn/ui todavía no la pasa.
- Antes de cambiar, revisa cualquier parte o variante que solo aparezca en shadcn/ui y asígnala a la más parecida de HextaUI.