Search

Компонент для реализации поисковых интерфейсов. Наследует все свойства нативного <input type="search"> с расширенными возможностями кастомизации.

Загружается...

Компонент поддерживает работу как в неконтролируемом режиме, так и контролируемом. Это стандартное поведение React-компонентов, прочитать про это можно в документации React ↗.

Для использования неконтролируемого режима достаточно просто не передавать value или передавать defaultValue, если требуется задать значение по умолчанию. Для контролируемого режима используйте связку свойств value/onChange для задания значения и его изменения.

// Неконтролируемое состояние
<Search defaultValue="Поиск" />;
 
// Контролируемое состояние
const [value, setValue] = React.useState('Поиск');
 
<Search value={value} onChange={(event) => setValue(event.target.value)} />;

Вы можете использовать любую иконку для кнопки поиска, просто прокинув ее в свойство icon. Также, в более сложных кейсах, можно использовать функцию в свойстве icon. В качестве параметра эта функция принимает другую функцию отрисовки иконки (тип ее можно посмотреть, импортировав RenderIconButtonFn);

Загружается...

Кнопка “Найти” отображается, если передать обработчик onFindButtonClick:

Загружается...

Свойство after позволяет поменять текст кнопки сброса:

Загружается...
СвойствоОписание
afterReactNode

Only iOS. Текст кнопки “отмена”, которая чистит текстовое поле и убирает фокус.

По умолчанию: Отмена
beforeReactNode

Контент, отображаемый перед полем ввода.

По умолчанию: <Icon16SearchOutline />
clearButtonTestIdstring

Передает атрибут data-testid для кнопки очистки.

По умолчанию: -
clearLabelstring

Текст для скринридеров, описывающий кнопку очистки.

По умолчанию: Очистить
defaultValuestring

Значение поля ввода по умолчанию.

По умолчанию: -
findButtonTestIdstring

Передает атрибут data-testid для кнопки поиска.

По умолчанию: -
findButtonTextstring

Текст для кнопки Найти.

По умолчанию: Найти
getRefRef<HTMLInputElement>
По умолчанию: -
getRootRefRef<HTMLDivElement>
По умолчанию: -
iconReactNode | ((renderFn: RenderIconButtonFn) => ReactNode)

Иконка поиска. Может быть React-элементом или функцией, возвращающей элемент.

По умолчанию: -
iconLabelstring

Текст для скринридеров, описывающий иконку поиска.

По умолчанию: -
noPaddingboolean

Удаляет отступы у компонента.

По умолчанию: -
onFindButtonClickMouseEventHandler<HTMLElement>

Обработчик, при нажатии на кнопку “Найти”.

По умолчанию: -
onIconClickPointerEventHandler<HTMLElement>

Обработчик нажатия на иконку поиска.

По умолчанию: -