> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entrada

> Un campo de entrada de texto con atributos nativos, integración con campos y dos tamaños.

## Resumen

`Input` renderiza un campo de entrada de texto y acepta atributos de entrada nativos como `type`, `name`, `required`, `disabled` y `autoComplete`.

> [tab] Light
>
> [Ejemplo de Input (light)](https://storybook.twenty.com/iframe.html?id=ui-input-input--display\&viewMode=story\&globals=colorScheme:light)

> [tab] Dark
>
> [Ejemplo de Input (dark)](https://storybook.twenty.com/iframe.html?id=ui-input-input--display\&viewMode=story\&globals=colorScheme:dark)

[Open in Storybook](https://storybook.twenty.com/?path=/story/ui-input-input--display)

## "Uso"

### Estado no controlado

Usa `defaultValue` para establecer la dirección de correo electrónico inicial. La entrada controla los cambios posteriores.

```tsx theme={null}
import { Field, Input } from 'twenty-ui/primitives/input';

export const EmailField = () => (
  <Field.Root>
    <Field.Label>Email</Field.Label>
    <Input
      name="email"
      type="email"
      autoComplete="email"
      defaultValue="alex@example.com"
    />
    <Field.Description>Use your work email address.</Field.Description>
  </Field.Root>
);
```

## 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.

> [tab] Light
>
> [Opciones visuales para el campo de entrada (light)](https://storybook.twenty.com/iframe.html?id=ui-input-input--catalog\&viewMode=story\&globals=colorScheme:light)

> [tab] Dark
>
> [Opciones visuales para el campo de entrada (dark)](https://storybook.twenty.com/iframe.html?id=ui-input-input--catalog\&viewMode=story\&globals=colorScheme:dark)

[Open in Storybook](https://storybook.twenty.com/?path=/story/ui-input-input--catalog)

## Apariencia simple

Usa `variant="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.

```tsx theme={null}
import { Field, Input } from 'twenty-ui/primitives/input';

export const InlineSubject = () => (
  <Field.Root>
    <Field.Label>Subject</Field.Label>
    <Input variant="plain" placeholder="Add a subject" />
  </Field.Root>
);
```

`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

Pasa `value` 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.

```tsx theme={null}
import { useState } from 'react';
import { Field, Input } from 'twenty-ui/primitives/input';

export const EmailField = () => {
  const [email, setEmail] = useState('alex@example.com');

  return (
    <Field.Root>
      <Field.Label>Email</Field.Label>
      <Input
        name="email"
        type="email"
        autoComplete="email"
        value={email}
        onValueChange={setEmail}
      />
      <Field.Description>Use your work email address.</Field.Description>
    </Field.Root>
  );
};
```

## 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.

```tsx theme={null}
import { IconSearch } from 'twenty-ui/icon';
import { Input, InputGroup } from 'twenty-ui/primitives/input';

export const CompactSearch = () => (
  <InputGroup size="sm" startElement={<IconSearch size={16} aria-hidden />}>
    <Input aria-label="Search contacts" />
  </InputGroup>
);
```

## 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 usa `md` de forma predeterminada; dentro de un grupo, si se omite el `size` de la entrada, hereda el tamaño del grupo.

**className** `string | ((state: InputState) =\> string | undefined)`

CSS class applied to the element, or a function that
returns a class based on the component's state.

**defaultValue** `string | number | readonly string[]`

The default value of the input. Use when uncontrolled.

**hasFocusRing** `boolean` (default: true)

Set false to hide the focus border or outline while keeping errors visible. Defaults to true. InputGroup controls grouped focus styling.

**onValueChange** `((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.

**ref** `Ref\<HTMLInputElement\>`

Ref to the native input element.

**render** `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.

**size** `"md" | "sm"`

Visual size. Explicit input size takes precedence over the InputGroup default, then md applies. Group layout still sets the surrounding height.

**style** `CSSProperties | ((state: InputState) =\> CSSProperties | undefined)`

Style applied to the element, or a function that
returns a style object based on the component's state.

**textAlign** `"end" | "start"`

Aligns text to the logical start or end of the input. Follows the text direction.

**value** `string | number | readonly string[]`

The value of the input. Use when controlled.

**variant** `"default" | "plain"` (default: default)

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.