@megafon/ui-core 8.17.1 → 8.17.3

package/dist/es/components/Search/Search.d.ts

@@ -0,0 +1,126 @@
+import * as React from 'react';
+import './Search.scss';
+export declare const MinTextareaHeight: {
+    readonly ONE_ROW: 24;
+    readonly THREE_ROWS: number;
+};
+type MinTextareaHeightType = (typeof MinTextareaHeight)[keyof typeof MinTextareaHeight];
+export declare const Verification: {
+    readonly VALID: "valid";
+    readonly ERROR: "error";
+};
+type VerificationType = (typeof Verification)[keyof typeof Verification];
+export declare const SearchItemsPaddings: {
+    readonly SMALL: "small";
+    readonly LARGE: "large";
+};
+export type SearchItem = {
+    /** Значение value элемента */
+    value: string;
+    /** Ссылка элемента */
+    href?: string;
+    /** Настраиваемое отображение элементов в выпадающем списке */
+    searchView?: React.ReactNode;
+    /** Размер горизонтальных отступов элемента */
+    paddings?: (typeof SearchItemsPaddings)[keyof typeof SearchItemsPaddings];
+};
+export type PopularItem = {
+    /** Название элемента */
+    title: string;
+    /** Ссылка элемента */
+    href?: string;
+    /** Иконка элемента */
+    icon?: JSX.Element;
+};
+export interface ISearchProps {
+    /** Дополнительные data атрибуты к внутренним элементам */
+    dataAttrs?: {
+        root?: Record<string, string>;
+        control?: Record<string, string>;
+        searchField?: Record<string, string>;
+        submit?: Record<string, string>;
+        item?: Record<string, string>;
+        itemTitle?: Record<string, string>;
+        notice?: Record<string, string>;
+        popularItem?: Record<string, string>;
+        clearButton?: Record<string, string>;
+        resizer?: Record<string, string>;
+    };
+    /** Значение */
+    value?: string;
+    /** Вид отображения */
+    type?: 'textfield' | 'compact';
+    /** Включить режим textarea */
+    textarea?: boolean;
+    /** Заголовок поля */
+    label?: string;
+    /** HTML идентификатор поля поиска */
+    searchId?: string;
+    /** Текст внутри поля по умолчанию */
+    placeholder?: string;
+    /** Запрещает отрисовку иконки */
+    hideIcon?: boolean;
+    /** Элементы выпадающего списка */
+    items?: SearchItem[];
+    /** Использование функции debounce для onChange */
+    changeDelay?: number;
+    /** Результат проверки данных */
+    verification?: VerificationType;
+    /** Дополнительный текст под полем. Свойство verification влияет на цвет текста. */
+    noticeText?: string | JSX.Element;
+    /** Максимальное вводимое количество текста */
+    maxLength?: number;
+    /** Максимальная высота для скролла */
+    maxHeightScrollBar?: number;
+    /** Отключение поля ввода */
+    disabled?: boolean;
+    /** Делает поле обязательным */
+    required?: boolean;
+    /** Дополнительный класс корневого элемента */
+    className?: string;
+    /** Дополнительные классы для внутренних элементов */
+    classes?: {
+        label?: string;
+        input?: string;
+        listItemTitle?: string;
+        list?: string;
+        listInner?: string;
+        control?: string;
+        icon?: string;
+        submitButton?: string;
+        textNotFound?: string;
+        popularTitle?: string;
+        popularItem?: string;
+        resizer?: string;
+    };
+    /** Отображение загрузки */
+    showLoader?: boolean;
+    /** Выводить результат, когда нет результатов поиска */
+    showNotFound?: boolean;
+    /** Текст, когда нет результатов поиска */
+    textNotFound?: string;
+    /** Популярные элементы (max 5) */
+    popularItems?: PopularItem[];
+    /** Заголовок перед популярными элементами */
+    popularTitle?: string;
+    /** Ссылка на элемент списка с результатами */
+    listRef?: React.Ref<HTMLDivElement>;
+    /** Минимальная высота textarea, px */
+    minTextareaHeight?: MinTextareaHeightType;
+    /** Показать хендлер для ресайза текстового поля */
+    showResizer?: boolean;
+    /** Ref обработчик */
+    inputRef?: (node: HTMLInputElement | HTMLTextAreaElement) => void;
+    /** Обработчик изменения поля */
+    onChange?: (value: string) => void;
+    /** Обработчик нажатия на enter */
+    onSubmit?: (value: string) => void;
+    /** Обработчик выхода из фокуса */
+    onBlur?: (e: React.FocusEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    /** Обработчик входа в фокус */
+    onFocus?: (e: React.FocusEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    /** Обработчик нажатия на популярный элемент */
+    onPopularItemClick?: (popularItemValue?: string) => void;
+}
+declare const Search: React.FC<ISearchProps>;
+export default Search;