Обзор
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, если он не указан, наследует размер группы.
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.