Перейти к основному содержанию

Обзор

Input отображает текстовое поле ввода и принимает нативные атрибуты ввода, такие как type, name, required, disabled и autoComplete.

Использование

Неконтролируемое состояние

Используйте defaultValue, чтобы задать начальный адрес электронной почты. Поле ввода управляет последующими изменениями.

Визуальные варианты

Сравните малые и средние поля ввода в состояниях по умолчанию, фокуса, ошибки и отключения. Используйте обратную связь при валидации вместе с оформлением ошибки.

Простой внешний вид

Используйте variant="plain" внутри существующей строки или поверхности. Он убирает заливку, границу, скруглённые углы и внутренние отступы и использует естественную высоту. Родительский элемент задаёт отступы и размеры строки. Стили текста, заполнителя и отключённого состояния остаются общими. Синяя обводка соответствует нативному поведению браузера для :focus-visible. Для текстовых элементов управления это может включать фокус указателя и автофокусировку, а также фокус клавиатуры. Недопустимое состояние использует контур опасности без изменения макета.
InputGroup автоматически придает своему полю ввода простой вид и оставляет группу единственной рамкой фокуса и валидации. Его высоты sm и md остаются равными 24px и 32px. Отдельные простые поля ввода не используют фиксированную высоту, связанную с size.

Контролируемое состояние

Передайте value и обновляйте его с помощью onValueChange, чтобы управлять тем же адресом электронной почты в состоянии React. Callback-функция получает следующее строковое значение и сведения о событии.

Добавьте дополнение

InputGroup управляет окружающей рамкой и высотой макета. Размер ввода определяется явным дочерним size, затем значением группы по умолчанию, затем md. Сгруппированный ввод растягивается внутри общей рамки, поэтому для изменения общей высоты поля используйте size группы.

Настройка нативного элемента управления и обёртки

Нативные атрибуты, обработчики, className, style и ref относятся к вводу. Ref получает HTMLInputElement. Используйте render, чтобы скомпоновать другой компонент ввода и перенаправить предоставленные props и ref его нативному элементу ввода. onChange получает событие изменения React для нативного элемента ввода. onValueChange(value, details) получает следующую строку и сведения о событии Base UI, включая event, reason, cancel и allowPropagation. Событие нацелено на элемент ввода. Отмена сведений сохраняет политику валидации Base UI; она не отменяет нативное редактирование. Управляемые вызывающие стороны определяют, какое значение фиксировать. При настройке окружающей обёртки задавайте стили макета, атрибуты и ref для InputGroup. Группа не владеет значением. Нативные name, form, required, readOnly, disabled, а также поведение отправки и сброса остаются у элемента ввода, а именование и валидация Field предоставляются через Field.Root.

Свойства

Справочник включает свойства, специфичные для компонента, и унаследованные свойства Base UI. Также поддерживаются нативные атрибуты ввода. Для автономного элемента ввода по умолчанию используется md; внутри группы размер элемента ввода size, если он не указан, наследует размер группы.
string | ((state: InputState) => string | undefined)
CSS class applied to the element, or a function that returns a class based on the component’s state.
string | number | readonly string[]
The default value of the input. Use when uncontrolled.
boolean
по умолчанию:"true"
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.
Ref<HTMLInputElement>
Ref to the native input element.
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.
"md" | "sm"
Visual size. Explicit input size takes precedence over the InputGroup default, then md applies. Group layout still sets the surrounding height.
CSSProperties | ((state: InputState) => CSSProperties | undefined)
Style applied to the element, or a function that returns a style object based on the component’s state.
"end" | "start"
Aligns text to the logical start or end of the input. Follows the text direction.
string | number | readonly string[]
The value of the input. Use when controlled.
"default" | "plain"
по умолчанию:"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.