Ir al contenido

Number field

Campo numérico con controles de incremento y decremento.

Navegadores
Chrome 123+Firefox 121+Safari 17.5+
Nivel
1
Tamaño comprimido
2.45 kB
Presupuesto de diseño forzado
0 ms
Presupuesto de axe
0
Compatible con SSR
Sí
Contrato publicado
Entorno de pruebas

Zona de pruebas

Number Field

Predeterminado

API

NumberField.Root

PropTipoPredeterminadoDescripción
valuenumber—Número actual; hace que el campo sea controlado.
defaultValuenumber—Número inicial del campo no controlado.
onValueChange(value: number | undefined) => void—Se llama con el número interpretado, o undefined cuando el input está vacío.
minnumber—Valor mínimo aceptado.
maxnumber—Valor máximo aceptado.
stepnumber1Cantidad que añaden o restan los botones de incremento y decremento.
formatOptionsIntl.NumberFormatOptions—Opciones del Intl.NumberFormat que se usa para mostrar el valor.
clampValueOnBlurbooleantrueDevuelve un valor fuera de rango al intervalo entre min y max cuando el input pierde el foco.
disabledbooleanfalseDesactiva el input y ambos botones de incremento y decremento.
readOnlybooleanfalseHace que el valor sea de solo lectura y mantiene el input enfocable.
requiredbooleanfalseMarca el input como obligatorio para la validación del formulario.
renderReactElement | ((props, state) => ReactElement)—Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad.

NumberField.Group

PropTipoPredeterminadoDescripción
childrenReactNode—El input y los botones de incremento y decremento envueltos por el grupo.
renderReactElement | ((props, state) => ReactElement)—Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad.

NumberField.Input

PropTipoPredeterminadoDescripción
renderReactElement | ((props, state) => ReactElement)—Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad.

NumberField.Increment

PropTipoPredeterminadoDescripción
childrenReactNode—Contenido del botón de incremento.
renderReactElement | ((props, state) => ReactElement)—Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad.

NumberField.Decrement

PropTipoPredeterminadoDescripción
childrenReactNode—Contenido del botón de decremento.
renderReactElement | ((props, state) => ReactElement)—Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad.

Teclado

TeclaAcción
TabLlevar el foco al control o sacarlo de él
Enter / SpaceActivar cuando tiene el foco (controles de tipo botón)

Accesibilidad

Usa HTML semántico siempre que es posible. Inspecciona el marcado renderizado en el entorno de pruebas: ARIA se añade solo cuando los elementos nativos no bastan.

Puntos de estilo

data-uiify-number-fielddata-disabled