Saltar al contenido principal

Resumen

InputGroup proporciona a un Input un borde compartido y contenido opcional al inicio o al final. Establece size en el grupo para dimensionar el contenedor y proporcionar un valor predeterminado para su entrada. El tamaño explícito del elemento secundario tiene prioridad sobre ese valor predeterminado; el grupo sigue controlando la altura del diseño compartido.

”Uso”

startElement y endElement aceptan nodos de React. Los prefijos y los sufijos son contenido visual; el valor enviado de la entrada solo contiene lo que introduce el usuario.

Opciones visuales

Compare los adornos de prefijo, sufijo y combinados en ambos tamaños de campo de entrada. El grupo comparte su tamaño con el campo de entrada.

Anatomía

Coloque la entrada dentro de InputGroup y mantenga las etiquetas y los mensajes de los campos fuera del borde compartido.
startElement y endElement son props de nodos de React, no componentes independientes. InputGroup no proporciona una etiqueta ni administra la validación. Asigne a la entrada un nombre accesible, ya sea mediante Field.Label o sus propios atributos de etiquetado.

Acción al final

Coloca las etiquetas, la validación y la gestión de valores en el campo o la entrada. Asigna a los botones de adorno sus propios nombres accesibles y usa type="button" cuando no deban enviar el formulario. El grupo admite los tamaños sm y md y usa md de forma predeterminada.

Personalizar diseño

Las props nativas, className, style, render y ref se aplican al div de diseño. Un elemento render personalizado recibe las props de diseño y los elementos secundarios. Mantén la referencia proporcionada en ese elemento de diseño. Coloca value, defaultValue, onValueChange, name, required, readOnly, disabled y la referencia del control nativo en Input. El grupo no administra el estado de la entrada ni reemplaza la asociación de etiquetas de Field.

”Props”

La referencia se genera a partir de los tipos de componentes públicos. Los atributos nativos, incluidos los nombres accesibles y los controladores de eventos, también se aceptan en las partes que representan elementos.
ReactNode
Content rendered after the input, such as a suffix or a button.
boolean
predeterminado:"true"
Set false to keep the group border unchanged on focus. Defaults to true. Error styling remains visible.
Ref<HTMLDivElement>
Ref to the layout element, a div by default.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Customizes the layout element. Forward its props, children and ref. Native control props belong on the child input.
"md" | "sm"
predeterminado:"md"
Visual size of the layout and default size for inputs that omit size. Defaults to md.
ReactNode
Content rendered before the input, such as a prefix or an icon.