Search
Поисковое поле дизайн-системы: <input type='search'> с иконкой, опциональной кнопкой очистки, состоянием loading и слотом afterContent внутри поля — под дополнительное действие («Найти», «Фильтр»).
Когда использовать
- Основной поиск по списку / каталогу / таблице.
- Header-поиск с моментальной отдачей (live search).
- Форма поиска с явной кнопкой «Найти» (
afterContent).
Когда не подходит: для выбора из фиксированного списка используйте Combobox, для фильтра с префиксом — Input + Chip.
Анатомия
Size (default m)
Высота поля:
s— компактный (списки, тулбары).m— дефолт.l— для крупных форм и посадочных страниц.
AfterContent
Слот внутри поля, справа от строки ввода и кнопки очистки. Пустой по умолчанию: слот появляется тогда, когда в него передана нода.
Типовое наполнение — иконочная кнопка того же размера, что поле:
<Search size='m' afterContent={<Button size='m' view='function' appearance='neutral' icon={<SearchSVG />} onClick={submit} />} />Размер содержимого слот не навязывает — задавайте его тем же значением, что и size поля.
Outline (default true)
Рамка состояния вокруг поля. false — поле без рамки (например, поиск внутри выпадающего списка, где рамку даёт контейнер).
Установка
pnpm add @cloud-ru/ds-searchimport { Search } from '@cloud-ru/ds-search'Примеры использования
Базовое поле
tsx
import { Search } from '@cloud-ru/ds-search';
import { useState } from 'react';
export function Basic() {
const [value, setValue] = useState('');
return <Search placeholder='Поиск' value={value} onChange={setValue} />;
}Размер l для hero
tsx
import { Search } from '@cloud-ru/ds-search';
export function SizeL() {
return <Search size='l' placeholder='Поиск по каталогу' />;
}Loading
tsx
import { Search } from '@cloud-ru/ds-search';
export function Loading() {
return <Search placeholder='Поиск' loading />;
}Disabled
tsx
import { Search } from '@cloud-ru/ds-search';
export function Disabled() {
return <Search placeholder='Поиск' disabled />;
}Без фона
tsx
import { Search } from '@cloud-ru/ds-search';
export function TransparentBackground() {
return <Search placeholder='Прозрачный фон' background={false} />;
}Действие в слоте afterContent
tsx
import { APPEARANCE, Button, VIEW } from '@cloud-ru/ds-button';
import { PlaceholderSVG } from '@cloud-ru/ds-icons/interface/system';
import { Search } from '@cloud-ru/ds-search';
import { useState } from 'react';
export function WithAfterContent() {
const [value, setValue] = useState('');
const [submitted, setSubmitted] = useState('');
return (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
<Search
size='m'
placeholder='Поиск'
value={value}
onChange={setValue}
onSubmit={setSubmitted}
afterContent={
<Button
size='m'
view={VIEW.Function}
appearance={APPEARANCE.Neutral}
icon={<PlaceholderSVG />}
minWidth={false}
onClick={() => setSubmitted(value)}
/>
}
/>
<span>Запрос: {submitted || '—'}</span>
</div>
);
}Props
Types
Props
SearchProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
afterContent | ReactNode | — | no | Слот справа от строки ввода — после кнопки очистки, внутри поля. Типовое наполнение — иконочная кнопка того же размера, что поле: `<Button size={size} view='function' appearance='neutral' icon={…} />`. |
background | boolean | true | no | Наличие фона |
className | string | — | no | CSS-класс |
data-test-id | string | — | no | |
disabled | boolean | — | no | Деактивирован ли компонент |
inputMode | "decimal" | "email" | "none" | "numeric" | "search" | "tel" | "text" | "url" | — | no | Режим работы экранной клавиатуры |
loading | boolean | — | no | Состояние загрузки |
onBlur | FocusEventHandler<HTMLInputElement> | — | no | Колбек обработки потери фокуса |
onChange | ((value: string, e?: ChangeEvent<HTMLInputElement>) => void) | — | no | Колбек смены значения |
onFocus | FocusEventHandler<HTMLInputElement> | — | no | Колбек обработки получения фокуса |
onSubmit | ((value: string) => void) | — | no | Колбек на подтверждение поиска по строке |
outline | boolean | true | no | Наличие рамки состояния вокруг поля |
placeholder | string | — | no | Значение плейсхолдера |
showClearButton | boolean | true | no | Отображение кнопки Очистки поля |
size | "l" | "m" | "s" | m | no | Размер |
tabIndex | number | — | no | |
value | string | — | no | Значение input |