Resumen
Input renderiza un campo de entrada de texto y acepta atributos de entrada nativos como type, name, required, disabled y autoComplete.
”Uso”
Estado no controlado
UsadefaultValue para establecer la dirección de correo electrónico inicial. La entrada controla los cambios posteriores.
Opciones visuales
Compare los campos de entrada pequeños y medianos en sus estados predeterminado, enfocado, no válido y deshabilitado. Use comentarios de validación junto con estilos no válidos.Apariencia simple
Usavariant="plain" dentro de una fila o superficie existente. Elimina el relleno, el borde, las esquinas redondeadas y el espaciado interno, y usa la altura natural. El elemento principal proporciona el espaciado y las dimensiones de la fila. El estilo del texto, del marcador de posición y del estado deshabilitado sigue siendo compartido. El contorno azul sigue el comportamiento nativo :focus-visible del navegador. En los controles de texto, esto puede incluir el foco del puntero y el enfoque automático, así como el foco del teclado. El estado no válido utiliza un contorno de peligro sin cambiar el diseño.
InputGroup proporciona automáticamente a su campo de entrada una apariencia simple y mantiene el grupo como el único marco de foco y validación. Sus alturas sm y md se mantienen en 24px y 32px. Los campos de entrada simples independientes no utilizan la altura fija asociada a size.
Estado controlado
Pasavalue y actualízalo con onValueChange para controlar la misma dirección de correo electrónico en el estado de React. La función de devolución de llamada recibe el siguiente valor de cadena y los detalles del evento.
Añadir un adorno
InputGroup controla el borde circundante y la altura del diseño. El tamaño de la entrada se determina a partir del size explícito del elemento secundario, luego del valor predeterminado del grupo y, por último, de md. La entrada agrupada se extiende dentro del borde compartido, por lo que se debe usar el size del grupo para cambiar la altura general del campo.
Personalización del control nativo y del contenedor
Los atributos nativos, los controladores,className, style y ref se aplican a la entrada. La ref recibe un HTMLInputElement. Use render para componer otro componente de entrada y reenviar las props proporcionadas y la ref a su entrada nativa.
onChange recibe un evento de cambio de React para la entrada nativa. onValueChange(value, details) recibe la siguiente cadena y los detalles del evento de Base UI, incluidos event, reason, cancel y allowPropagation. El evento tiene como destino la entrada. Cancelar los detalles conserva la política de validación de Base UI; no deshace una edición nativa. Quienes controlan el componente deciden qué valor confirmar.
Coloque los estilos de diseño, los atributos y las refs en InputGroup al personalizar el contenedor circundante. El grupo no posee ningún valor. El comportamiento nativo de name, form, required, readOnly, disabled, envío y restablecimiento permanece en la entrada, mientras que la nomenclatura y validación de Field se proporcionan mediante Field.Root.
”Props”
La referencia incluye props específicos del componente y props heredados de Base UI. También se aceptan atributos de entrada nativos. Una entrada independiente usamd de forma predeterminada; dentro de un grupo, si se omite el size de la entrada, hereda el tamaño del grupo.
CSS class applied to the element, or a function that
returns a class based on the component’s state.
Set false to hide the focus border or outline while keeping errors visible. Defaults to true. InputGroup controls grouped focus styling.
((value: string, eventDetails: { reason: "none"; event: Event; cancel: () => void; allowPropagation: () => void; isCanceled: boolean; isPropagationAllowed: boolean; trigger: Element | undefined; }) => void)
Receives the next string value and Base UI details, including the native event, reason and cancellation methods.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, InputState>
Composes the native input with a custom element or render callback. Forward the supplied props and ref to an input.
Visual size. Explicit input size takes precedence over the InputGroup default, then md applies. Group layout still sets the surrounding height.
Style applied to the element, or a function that
returns a style object based on the component’s state.
default keeps the field frame. plain removes fill, border, radius and padding and uses natural height. Its outline follows native :focus-visible, including pointer focus or autofocus on text inputs; invalid state uses a danger outline. InputGroup always owns the grouped frame.