fui-material 2.5.5 → 2.5.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1,16 +1,73 @@
|
|
|
1
1
|
import React, { type ChangeEvent, type ReactNode, type CSSProperties } from "react";
|
|
2
|
+
/**
|
|
3
|
+
* Интерфейс пропсов для компонента `FSearchableSelect`.
|
|
4
|
+
*
|
|
5
|
+
* @interface IFSearchableSelect
|
|
6
|
+
* @extends {Omit<React.InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange'>}
|
|
7
|
+
*/
|
|
2
8
|
export interface IFSearchableSelect extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange'> {
|
|
9
|
+
/**
|
|
10
|
+
* Метка (label), отображаемая над полем ввода.
|
|
11
|
+
* @type {string | undefined}
|
|
12
|
+
*/
|
|
3
13
|
label?: string;
|
|
14
|
+
/**
|
|
15
|
+
* Инлайновые стили для внешнего контейнера компонента.
|
|
16
|
+
* @type {CSSProperties | undefined}
|
|
17
|
+
*/
|
|
4
18
|
st?: CSSProperties;
|
|
19
|
+
/**
|
|
20
|
+
* Дочерние элементы (обычно `<option>`), из которых формируется список выбора.
|
|
21
|
+
* Значения извлекаются из пропсов `value` и `children` переданных элементов.
|
|
22
|
+
* @type {ReactNode | undefined}
|
|
23
|
+
*/
|
|
5
24
|
children?: ReactNode;
|
|
25
|
+
/**
|
|
26
|
+
* Флаг, указывающий, должен ли компонент занимать 100% ширины родителя.
|
|
27
|
+
* @type {boolean | undefined}
|
|
28
|
+
*/
|
|
6
29
|
fullWidth?: boolean;
|
|
30
|
+
/**
|
|
31
|
+
* Флаг состояния загрузки. Если true, отображается спиннер, а взаимодействие блокируется.
|
|
32
|
+
* @type {boolean | undefined}
|
|
33
|
+
*/
|
|
7
34
|
load?: boolean;
|
|
35
|
+
/**
|
|
36
|
+
* Массив строк с текстом ошибок. Если массив не пуст, поле подсвечивается красным.
|
|
37
|
+
* @type {string[] | undefined}
|
|
38
|
+
*/
|
|
8
39
|
errText?: string[];
|
|
40
|
+
/**
|
|
41
|
+
* Вспомогательный текст, отображаемый под полем ввода.
|
|
42
|
+
* @type {string | undefined}
|
|
43
|
+
*/
|
|
9
44
|
helpText?: string;
|
|
45
|
+
/**
|
|
46
|
+
* Явное указание ширины компонента.
|
|
47
|
+
* @type {string | number | undefined}
|
|
48
|
+
*/
|
|
10
49
|
width?: string | number;
|
|
50
|
+
/**
|
|
51
|
+
* Явное указание высоты компонента.
|
|
52
|
+
* @type {string | number | undefined}
|
|
53
|
+
*/
|
|
11
54
|
height?: string | number;
|
|
55
|
+
/**
|
|
56
|
+
* Разрешить создание новых элементов, отсутствующих в списке.
|
|
57
|
+
* При вводе уникального текста появится опция "Создать".
|
|
58
|
+
* @type {boolean | undefined}
|
|
59
|
+
*/
|
|
12
60
|
allowCreate?: boolean;
|
|
61
|
+
/**
|
|
62
|
+
* Текущее значение поля (контролируемый компонент).
|
|
63
|
+
* @type {string | number | readonly string[] | undefined}
|
|
64
|
+
*/
|
|
13
65
|
value?: string | number | readonly string[];
|
|
66
|
+
/**
|
|
67
|
+
* Callback, вызываемый при изменении значения.
|
|
68
|
+
* Возвращает синтетическое событие с объектом target, содержащим name и value.
|
|
69
|
+
* @type {((event: { target: { name: string; value: string } } | ChangeEvent<HTMLInputElement>) => void) | undefined}
|
|
70
|
+
*/
|
|
14
71
|
onChange?: (event: {
|
|
15
72
|
target: {
|
|
16
73
|
name: string;
|
|
@@ -18,5 +75,53 @@ export interface IFSearchableSelect extends Omit<React.InputHTMLAttributes<HTMLI
|
|
|
18
75
|
};
|
|
19
76
|
} | ChangeEvent<HTMLInputElement>) => void;
|
|
20
77
|
}
|
|
78
|
+
/**
|
|
79
|
+
* Компонент `FSearchableSelect` — выпадающий список с возможностью поиска и фильтрации опций.
|
|
80
|
+
*
|
|
81
|
+
* Особенности:
|
|
82
|
+
* - Поддерживает фильтрацию списка при вводе текста.
|
|
83
|
+
* - Может работать как обычный Select или как Combobox (с `allowCreate`).
|
|
84
|
+
* - Парсит опции из переданных `children` (например, `<option value="1">One</option>`).
|
|
85
|
+
* - Поддерживает навигацию с клавиатуры (стрелки, Enter, Escape).
|
|
86
|
+
* - Имеет состояния: ошибка, загрузка, disabled.
|
|
87
|
+
*
|
|
88
|
+
* @component
|
|
89
|
+
* @example
|
|
90
|
+
* // Простой пример использования с опциями
|
|
91
|
+
* <FSearchableSelect
|
|
92
|
+
* label="Выберите город"
|
|
93
|
+
* value={city}
|
|
94
|
+
* onChange={(e) => setCity(e.target.value)}
|
|
95
|
+
* fullWidth
|
|
96
|
+
* >
|
|
97
|
+
* <option value="moscow">Москва</option>
|
|
98
|
+
* <option value="spb">Санкт-Петербург</option>
|
|
99
|
+
* </FSearchableSelect>
|
|
100
|
+
*
|
|
101
|
+
* @example
|
|
102
|
+
* // Пример с созданием новых значений (allowCreate) и ошибкой
|
|
103
|
+
* <FSearchableSelect
|
|
104
|
+
* label="Теги"
|
|
105
|
+
* allowCreate
|
|
106
|
+
* value={tag}
|
|
107
|
+
* onChange={(e) => setTag(e.target.value)}
|
|
108
|
+
* errText={hasError ? ['Некорректный тег'] : undefined}
|
|
109
|
+
* >
|
|
110
|
+
* {tagsList.map(t => <option key={t.id} value={t.name}>{t.name}</option>)}
|
|
111
|
+
* </FSearchableSelect>
|
|
112
|
+
*
|
|
113
|
+
* @param {string} [label] - Метка поля.
|
|
114
|
+
* @param {CSSProperties} [st] - Стили контейнера.
|
|
115
|
+
* @param {ReactNode} [children] - Опции списка.
|
|
116
|
+
* @param {boolean} [fullWidth=false] - Растянуть на 100%.
|
|
117
|
+
* @param {boolean} [load=false] - Показать лоадер.
|
|
118
|
+
* @param {string[]} [errText] - Текст ошибки.
|
|
119
|
+
* @param {string} [helpText] - Подсказка.
|
|
120
|
+
* @param {boolean} [allowCreate=false] - Разрешить ввод своих значений.
|
|
121
|
+
* @param {string|number} [value] - Значение.
|
|
122
|
+
* @param {Function} [onChange] - Обработчик изменений.
|
|
123
|
+
*
|
|
124
|
+
* @returns {JSX.Element} Рендерит кастомный Select с поиском.
|
|
125
|
+
*/
|
|
21
126
|
declare const FSearchableSelect: React.ForwardRefExoticComponent<IFSearchableSelect & React.RefAttributes<HTMLInputElement>>;
|
|
22
127
|
export default FSearchableSelect;
|