Saltar al contenido
Logic2BUI

Buscar en la documentación

Busca componentes y documentación

Nuevo
Menú

Campo numérico

Campo numérico con controles para reducir o aumentar el valor, límites mínimo y máximo y tamaño de paso.

Quantity: 3 / 10

Instalación

npx logic2b@next add number-field

Uso

import { NumberField } from "@/components/ui/number-field"

<NumberField defaultValue={1} min={0} max={10} />

Controlado:

const [value, setValue] = React.useState(3)

<NumberField value={value} onValueChange={setValue} min={0} max={10} />

Genera un <input type="number"> real, por lo que admite el envío nativo de formularios y la introducción mediante teclado. Los controles propios del navegador se ocultan en favor de los botones con estilo, que se desactivan al alcanzar los límites min y max.

Ejemplos

Paso

Playground interactivo

Edita las propiedades del componente y revisa el JSX exacto antes de copiarlo. La vista previa se carga solo cuando esta sección entra en pantalla.

JSX generado
<NumberField
  defaultValue={3}
  min={0}
  max={12}
  step={1}
  aria-label="Quantity"
 />

Referencia de API

Generada a partir de las exportaciones públicas de TypeScript en src/ui/number-field.tsx. Las descripciones técnicas conservan el texto canónico del código fuente.

Ver JSON

NumberFieldProps

Tipo
interface NumberFieldProps extends Omit< React.ComponentProps<"input">, "value" | "defaultValue" | "onChange" | "type" > { value?: number defaultValue?: number onValueChange?: (value: number) => void min?: number max?: number step?: number }

NumberField

Componente

A numeric input with decrement/increment steppers, min/max clamping and step. Controlled via `value`/`onValueChange` or uncontrolled via `defaultValue`. Renders a real `<input type="number">` so native form submission and keyboard work; the native spinners are hidden in favor of the styled buttons.

Props: NumberFieldProps
PropiedadTipoObligatoriaValor predeterminadoDescripción
valuenumberNo——
defaultValuenumberNo——
onValueChange(value: number) => voidNo——
minnumberNo——
maxnumberNo——
stepnumberNo1—

Contrato de accesibilidad

Comportamiento legible por máquinas y responsabilidades de quien integra number-field. Los detalles normativos conservan el texto canónico del registro.

Ver JSON
Soporte
Semántica nativa
Patrón
spinbutton
HTMLInputElement type=number
Interacciones de teclado para number-field
TeclasComportamiento
ArrowUp ArrowDown ArrowLeft ArrowRightMove within the composite control.
EnterCommit typed input according to native number-field behavior.

Semántica incorporada

  • The input retains native spinbutton semantics; step buttons are native buttons with labels.

Responsabilidades de integración

  • Associate the input with a label and communicate min/max constraints in visible help text.