@sberbusiness/triplex-next-mcp-server 0.24.0-beta1 → 0.36.0-beta0
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.
- package/README.md +10 -0
- package/bundle/components/Alert.md +272 -0
- package/bundle/components/Amount.md +138 -0
- package/bundle/components/AmountField.md +174 -0
- package/bundle/components/Avatar.md +72 -0
- package/bundle/components/Badge.md +203 -0
- package/bundle/components/BodyPage.md +186 -0
- package/bundle/components/Button.md +370 -85
- package/bundle/components/ButtonDropdown.md +328 -70
- package/bundle/components/ButtonIcon.md +98 -42
- package/bundle/components/Calendar.md +58 -0
- package/bundle/components/Checkbox.md +77 -44
- package/bundle/components/CheckboxTree.md +61 -0
- package/bundle/components/CheckboxTreeExtended.md +114 -0
- package/bundle/components/CheckboxXGroup.md +120 -16
- package/bundle/components/CheckboxYGroup.md +88 -15
- package/bundle/components/CollapsibleTree.md +581 -0
- package/bundle/components/CollapsibleTreeExtended.md +418 -0
- package/bundle/components/EmptyView.md +133 -15
- package/bundle/components/FooterPage.md +203 -0
- package/bundle/components/Gap.md +115 -57
- package/bundle/components/HeaderPage.md +226 -0
- package/bundle/components/HelpBox.md +231 -72
- package/bundle/components/ImageGallery.md +423 -0
- package/bundle/components/ImageGalleryExtended.md +606 -0
- package/bundle/components/List.md +194 -186
- package/bundle/components/ListItem.md +251 -0
- package/bundle/components/ListItemControlsButton.md +103 -0
- package/bundle/components/ListItemControlsButtonDropdown.md +107 -0
- package/bundle/components/ListItemSelectable.md +99 -0
- package/bundle/components/ListItemTable.md +390 -0
- package/bundle/components/ListMaster.md +877 -156
- package/bundle/components/ListMasterFooter.md +80 -0
- package/bundle/components/ListMasterHeader.md +86 -0
- package/bundle/components/ListSortable.md +153 -0
- package/bundle/components/ListSortableItem.md +175 -0
- package/bundle/components/ModalWindow.md +427 -237
- package/bundle/components/MonthYearField.md +145 -109
- package/bundle/components/Notification.md +625 -155
- package/bundle/components/Overlay.md +271 -170
- package/bundle/components/Page.md +283 -186
- package/bundle/components/Pagination.md +206 -229
- package/bundle/components/SliderExtended.md +285 -0
- package/bundle/guides/codestyle.md +38 -11
- package/bundle/guides/commits.md +1 -2
- package/bundle/guides/context.md +34 -30
- package/bundle/guides/stories.md +110 -40
- package/bundle/guides/template.md +3 -7
- package/bundle/guides/tests.md +6 -2
- package/bundle/manifest.json +194 -24
- package/bundle/release-notes/1.26.0.mdx +33 -2
- package/bundle/release-notes/1.27.0.mdx +43 -0
- package/bundle/release-notes/1.28.0.mdx +25 -0
- package/bundle/release-notes/1.29.0.mdx +47 -0
- package/bundle/release-notes/1.30.0.mdx +56 -0
- package/bundle/release-notes/1.31.0.mdx +52 -0
- package/bundle/release-notes/1.32.0.mdx +35 -0
- package/bundle/release-notes/1.33.0.mdx +61 -0
- package/bundle/release-notes/1.34.0.mdx +35 -0
- package/bundle/release-notes/1.35.0.mdx +21 -0
- package/bundle/release-notes/1.35.1.mdx +11 -0
- package/bundle/release-notes/1.36.0.mdx +21 -0
- package/bundle/release-notes/1.37.0.mdx +30 -0
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
|
@@ -443,3 +443,61 @@ weekday на английском.
|
|
|
443
443
|
| Дата | Изменение |
|
|
444
444
|
|---|---|
|
|
445
445
|
| 2026-04-18 | Создан документ |
|
|
446
|
+
|
|
447
|
+
---
|
|
448
|
+
|
|
449
|
+
## Примеры использования
|
|
450
|
+
|
|
451
|
+
### Default
|
|
452
|
+
|
|
453
|
+
`stories/Calendar/examples/DefaultExample.tsx`
|
|
454
|
+
|
|
455
|
+
```tsx
|
|
456
|
+
import moment from "moment";
|
|
457
|
+
import React, { useState } from "react";
|
|
458
|
+
import { Calendar } from "@sberbusiness/triplex-next";
|
|
459
|
+
|
|
460
|
+
export const DefaultExample = () => {
|
|
461
|
+
const [pickedDate, setPickedDate] = useState(moment());
|
|
462
|
+
|
|
463
|
+
return <Calendar pickedDate={pickedDate} onDateChange={setPickedDate} />;
|
|
464
|
+
};
|
|
465
|
+
```
|
|
466
|
+
|
|
467
|
+
### PickTypes
|
|
468
|
+
|
|
469
|
+
`stories/Calendar/examples/PickTypesExample.tsx`
|
|
470
|
+
|
|
471
|
+
```tsx
|
|
472
|
+
import moment from "moment";
|
|
473
|
+
import React, { useState } from "react";
|
|
474
|
+
import { Calendar, ECalendarPickType } from "@sberbusiness/triplex-next";
|
|
475
|
+
|
|
476
|
+
export const PickTypesExample = () => {
|
|
477
|
+
const initialDate = moment("2024-01-15");
|
|
478
|
+
const [pickedDateDatePick, setPickedDateDatePick] = useState(initialDate);
|
|
479
|
+
const [pickedDateMonthYearPick, setPickedDateMonthYearPick] = useState(initialDate);
|
|
480
|
+
|
|
481
|
+
return (
|
|
482
|
+
<div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
|
|
483
|
+
<div>
|
|
484
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>DATEPICK</div>
|
|
485
|
+
<Calendar
|
|
486
|
+
pickType={ECalendarPickType.datePick}
|
|
487
|
+
pickedDate={pickedDateDatePick}
|
|
488
|
+
onDateChange={setPickedDateDatePick}
|
|
489
|
+
/>
|
|
490
|
+
</div>
|
|
491
|
+
<div>
|
|
492
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>MONTHYEARPICK</div>
|
|
493
|
+
<Calendar
|
|
494
|
+
pickType={ECalendarPickType.monthYearPick}
|
|
495
|
+
pickedDate={pickedDateMonthYearPick}
|
|
496
|
+
onDateChange={setPickedDateMonthYearPick}
|
|
497
|
+
/>
|
|
498
|
+
</div>
|
|
499
|
+
</div>
|
|
500
|
+
);
|
|
501
|
+
};
|
|
502
|
+
```
|
|
503
|
+
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
component: Checkbox
|
|
3
3
|
category: Inputs
|
|
4
|
-
figma-node: ""
|
|
5
|
-
figma-file: ""
|
|
6
4
|
related: [CheckboxXGroup, CheckboxYGroup, CheckboxTree, CheckboxTreeExtended]
|
|
7
5
|
tokens:
|
|
8
6
|
- --triplex-next-Checkbox-Background_Default
|
|
@@ -26,7 +24,8 @@ version: "1.0"
|
|
|
26
24
|
# Checkbox
|
|
27
25
|
|
|
28
26
|
## Назначение
|
|
29
|
-
|
|
27
|
+
|
|
28
|
+
Нативный чекбокс в обёртке `<label>`, который поддерживает визуальные состояния (default / checked / disabled / focus) и режим частичного выбора через `bulk`.
|
|
30
29
|
|
|
31
30
|
Используй когда: нужен чекбокс с текстовой подписью (`children`) и стандартным поведением `<input type="checkbox">`.
|
|
32
31
|
Не используй когда: нужен сложный многошаговый выбор или компонент с нестандартной семантикой (тогда лучше другой control).
|
|
@@ -34,93 +33,127 @@ version: "1.0"
|
|
|
34
33
|
---
|
|
35
34
|
|
|
36
35
|
## Варианты и props
|
|
36
|
+
|
|
37
|
+
### Обязательные props
|
|
38
|
+
|
|
39
|
+
Обязательных custom-props нет.
|
|
40
|
+
|
|
37
41
|
### Опциональные props
|
|
42
|
+
|
|
38
43
|
| Prop | Тип | По умолчанию | Описание |
|
|
39
44
|
|---|---|---|---|
|
|
40
45
|
| `checked` | `boolean` | — | Состояние чекбокса (controlled). Передаётся через стандартные props `<input>`. |
|
|
41
46
|
| `defaultChecked` | `boolean` | — | Состояние чекбокса (uncontrolled). Передаётся через стандартные props `<input>`. |
|
|
42
47
|
| `disabled` | `boolean` | `false` | Блокирует взаимодействие и меняет визуальное состояние. |
|
|
43
|
-
| `bulk` | `boolean` | `false` | Влияет на отображаемую иконку (используется bulk-иконка)
|
|
48
|
+
| `bulk` | `boolean` | `false` | Влияет на отображаемую иконку (используется bulk-иконка). Видимость checkmark всё равно определяется состоянием `checked`. |
|
|
44
49
|
| `size` | `EComponentSize` | `EComponentSize.MD` | Размер: `SM` / `MD` / `LG`. |
|
|
45
50
|
| `children` | `React.ReactNode` | — | Контент лейбла рядом с чекбоксом. Если `children` нет — класс `.nonempty` не применяется. |
|
|
46
51
|
| `labelAttributes` | `React.LabelHTMLAttributes<HTMLLabelElement>` | — | Дополнительные HTML-атрибуты для корневого `<label>` (например, `className`, `onFocus`). |
|
|
47
|
-
| `...inputAttributes` | `Omit<React.InputHTMLAttributes<HTMLInputElement>, "type"
|
|
48
|
-
|
|
49
|
-
---
|
|
52
|
+
| `...inputAttributes` | `Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" \| "size">` | — | Все стандартные атрибуты `<input type="checkbox">` (включая `name`, `onChange`, `aria-label` и т.д.). |
|
|
50
53
|
|
|
51
|
-
|
|
52
|
-
### Ref forwarding
|
|
53
|
-
`ref` прокидывается на внутренний `<input type="checkbox">`.
|
|
54
|
+
### Ограничения использования
|
|
54
55
|
|
|
55
|
-
|
|
56
|
-
- `
|
|
57
|
-
- `bulk=true` — отрисовывается bulk-иконка.
|
|
58
|
-
|
|
59
|
-
### Структура DOM
|
|
60
|
-
Компонент рендерит:
|
|
61
|
-
1. корневой `<label>`
|
|
62
|
-
2. `<input type="checkbox">`
|
|
63
|
-
3. декоративные `<span>`/`svg` для отрисовки фона и галочки
|
|
56
|
+
- DOM-структура фиксирована: корневой `<label>` → `<input type="checkbox">` → декоративные `<span>` / `<svg>` для отрисовки фона и галочки.
|
|
57
|
+
- `ref` прокидывается на внутренний `<input type="checkbox">`.
|
|
64
58
|
|
|
65
59
|
---
|
|
66
60
|
|
|
67
|
-
##
|
|
68
|
-
Компонент использует нативный `<input type="checkbox">`, поэтому поддерживает стандартную клавиатурную навигацию (Tab + Space) и семантику формы.
|
|
61
|
+
## Дизайн-токены
|
|
69
62
|
|
|
70
|
-
|
|
63
|
+
```
|
|
64
|
+
--triplex-next-Checkbox-Background_Default
|
|
65
|
+
--triplex-next-Checkbox-BorderColor_Default
|
|
66
|
+
--triplex-next-Checkbox-Checkmark_Fill_Default
|
|
67
|
+
--triplex-next-Checkbox-Background_Hover
|
|
68
|
+
--triplex-next-Checkbox-BorderColor_Hover
|
|
69
|
+
--triplex-next-Checkbox-Background_Checked_Default
|
|
70
|
+
--triplex-next-Checkbox-BorderColor_Checked_Default
|
|
71
|
+
--triplex-next-Checkbox-Background_Disabled
|
|
72
|
+
--triplex-next-Checkbox-BorderColor_Disabled
|
|
73
|
+
--triplex-next-Checkbox-Background_Checked_Disabled
|
|
74
|
+
--triplex-next-Checkbox-BorderColor_Checked_Disabled
|
|
75
|
+
--triplex-next-Checkbox-Checkmark_Fill_Disabled
|
|
76
|
+
--triplex-next-Checkbox-BorderColor_Focus
|
|
77
|
+
--triplex-next-Checkbox-Background_Checked_Hover
|
|
78
|
+
```
|
|
71
79
|
|
|
72
80
|
---
|
|
73
81
|
|
|
74
82
|
## Инварианты
|
|
83
|
+
|
|
75
84
|
- `forwardRef` на компоненте обязателен и должен указывать на `<input>`.
|
|
76
85
|
- Корневой DOM-элемент компонента — `<label>`, внутри которого находится `<input>`.
|
|
77
86
|
- `className` и `size` — публичные части внешнего контрактного API: не менять семантику без согласования.
|
|
78
87
|
|
|
79
88
|
---
|
|
80
89
|
|
|
81
|
-
##
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
`--triplex-next-Checkbox-Checkmark_Fill_Default`,
|
|
86
|
-
`--triplex-next-Checkbox-Background_Hover`,
|
|
87
|
-
`--triplex-next-Checkbox-BorderColor_Hover`,
|
|
88
|
-
`--triplex-next-Checkbox-Background_Checked_Default`,
|
|
89
|
-
`--triplex-next-Checkbox-BorderColor_Checked_Default`,
|
|
90
|
-
`--triplex-next-Checkbox-Background_Disabled`,
|
|
91
|
-
`--triplex-next-Checkbox-BorderColor_Disabled`,
|
|
92
|
-
`--triplex-next-Checkbox-Background_Checked_Disabled`,
|
|
93
|
-
`--triplex-next-Checkbox-BorderColor_Checked_Disabled`,
|
|
94
|
-
`--triplex-next-Checkbox-Checkmark_Fill_Disabled`,
|
|
95
|
-
`--triplex-next-Checkbox-BorderColor_Focus`,
|
|
96
|
-
`--triplex-next-Checkbox-Background_Checked_Hover`.
|
|
90
|
+
## Accessibility
|
|
91
|
+
|
|
92
|
+
- Компонент использует нативный `<input type="checkbox">`, поэтому поддерживает стандартную клавиатурную навигацию (Tab + Space) и семантику формы.
|
|
93
|
+
- Библиотека мультиязычная: текст `aria-label` / `title` не захардкожен в компоненте. При необходимости потребитель передаёт `aria-*` через `...inputAttributes`.
|
|
97
94
|
|
|
98
95
|
---
|
|
99
96
|
|
|
100
97
|
## Связанные компоненты
|
|
98
|
+
|
|
101
99
|
- `CheckboxXGroup` — группировка чекбоксов по оси X.
|
|
102
100
|
- `CheckboxYGroup` — группировка чекбоксов по оси Y.
|
|
103
|
-
- `CheckboxTree` — декларативное дерево чекбоксов (
|
|
104
|
-
- `CheckboxTreeExtended` — расширенное дерево чекбоксов на базе `
|
|
101
|
+
- `CheckboxTree` — декларативное дерево чекбоксов (обёртка над `CheckboxTreeExtended`), поддерживает bulk-логику и распространение состояния checked по родителям/детям.
|
|
102
|
+
- `CheckboxTreeExtended` — расширенное дерево чекбоксов на базе `CollapsibleTreeExtended` с `Node` / `Checkbox` подкомпонентами (использует нативный `Checkbox` внутри для каждого узла).
|
|
105
103
|
|
|
106
104
|
---
|
|
107
105
|
|
|
108
106
|
## Stories
|
|
109
|
-
|
|
107
|
+
|
|
108
|
+
Основные истории: `stories/Checkbox/Checkbox.stories.tsx`
|
|
110
109
|
Файлы примеров: `stories/Checkbox/examples/`
|
|
111
110
|
|
|
112
111
|
| Story | Example file | Что демонстрирует |
|
|
113
112
|
|---|---|---|
|
|
114
113
|
| `Playground` | `PlaygroundExample.tsx` | Интерактивный контроль основных props |
|
|
115
114
|
| `Default` | `DefaultExample.tsx` | Минимальное использование |
|
|
116
|
-
| `Sizes` | `SizesExample.tsx` | Размеры SM / MD / LG |
|
|
117
|
-
| `XGroup` | `XGroupExample.tsx` | Группа по оси X |
|
|
118
|
-
| `YGroup` | `YGroupExample.tsx` | Группа по оси Y |
|
|
115
|
+
| `Sizes` | `SizesExample.tsx` | Размеры `SM` / `MD` / `LG` |
|
|
119
116
|
|
|
120
117
|
---
|
|
121
118
|
|
|
122
119
|
## История изменений
|
|
120
|
+
|
|
123
121
|
| Дата | Изменение |
|
|
124
122
|
|---|---|
|
|
125
123
|
| 2026-04-16 | Приведение `Checkbox` к AI-ready: соблюдены правила `docs/ai/codestyle.md`, добавлена AI-документация и unit-тест на передачу `className` корневому `label`. |
|
|
124
|
+
| 2026-04-27 | Приведён в соответствие с `docs/ai/template-ai.md`: убрана секция «Ключевые особенности реализации» (содержимое перенесено в `Ограничения использования`), переставлены секции (Accessibility после Инвариантов), добавлена колонка `Example file`. |
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## Примеры использования
|
|
129
|
+
|
|
130
|
+
### Default
|
|
131
|
+
|
|
132
|
+
`stories/Checkbox/examples/DefaultExample.tsx`
|
|
133
|
+
|
|
134
|
+
```tsx
|
|
135
|
+
import React from "react";
|
|
136
|
+
import { Checkbox } from "@sberbusiness/triplex-next";
|
|
137
|
+
|
|
138
|
+
export const DefaultExample = () => <Checkbox>Checkbox label</Checkbox>;
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
### Sizes
|
|
142
|
+
|
|
143
|
+
`stories/Checkbox/examples/SizesExample.tsx`
|
|
144
|
+
|
|
145
|
+
```tsx
|
|
146
|
+
import React from "react";
|
|
147
|
+
import { Checkbox, EComponentSize, Gap } from "@sberbusiness/triplex-next";
|
|
148
|
+
|
|
149
|
+
export const SizesExample = () => (
|
|
150
|
+
<>
|
|
151
|
+
<Checkbox size={EComponentSize.SM}>SM</Checkbox>
|
|
152
|
+
<Gap size={16} />
|
|
153
|
+
<Checkbox size={EComponentSize.MD}>MD</Checkbox>
|
|
154
|
+
<Gap size={16} />
|
|
155
|
+
<Checkbox size={EComponentSize.LG}>LG</Checkbox>
|
|
156
|
+
</>
|
|
157
|
+
);
|
|
158
|
+
```
|
|
126
159
|
|
|
@@ -278,3 +278,64 @@ onChange/bulk/checked. **Не упрощать** — CheckboxTreeExtended пол
|
|
|
278
278
|
| Дата | Изменение |
|
|
279
279
|
|---|---|
|
|
280
280
|
| 2026-04-18 | Создан документ |
|
|
281
|
+
|
|
282
|
+
---
|
|
283
|
+
|
|
284
|
+
## Примеры использования
|
|
285
|
+
|
|
286
|
+
### Default
|
|
287
|
+
|
|
288
|
+
`stories/CheckboxTree/examples/DefaultExample.tsx`
|
|
289
|
+
|
|
290
|
+
```tsx
|
|
291
|
+
import React, { useState } from "react";
|
|
292
|
+
import { CheckboxTree, ICheckboxTreeCheckboxData } from "@sberbusiness/triplex-next";
|
|
293
|
+
|
|
294
|
+
const SAMPLE: ICheckboxTreeCheckboxData[] = [
|
|
295
|
+
{ id: "1", label: "Группа 1", checked: false, children: [{ id: "1-1", label: "Значение 1-1", checked: false }] },
|
|
296
|
+
{ id: "2", label: "Группа 2", checked: false },
|
|
297
|
+
];
|
|
298
|
+
|
|
299
|
+
export const DefaultExample = () => {
|
|
300
|
+
const [checkboxes, setCheckboxes] = useState<ICheckboxTreeCheckboxData[]>(SAMPLE);
|
|
301
|
+
return <CheckboxTree checkboxes={checkboxes} onChange={setCheckboxes} />;
|
|
302
|
+
};
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
### Sizes
|
|
306
|
+
|
|
307
|
+
`stories/CheckboxTree/examples/SizesExample.tsx`
|
|
308
|
+
|
|
309
|
+
```tsx
|
|
310
|
+
import React, { useState } from "react";
|
|
311
|
+
import { CheckboxTree, Col, EComponentSize, ICheckboxTreeCheckboxData, Row } from "@sberbusiness/triplex-next";
|
|
312
|
+
|
|
313
|
+
const createData = (): ICheckboxTreeCheckboxData[] => [
|
|
314
|
+
{ id: "1", label: "Группа 1", checked: false, children: [{ id: "1-1", label: "Значение 1-1", checked: false }] },
|
|
315
|
+
{ id: "2", label: "Группа 2", checked: false },
|
|
316
|
+
];
|
|
317
|
+
|
|
318
|
+
export const SizesExample = () => {
|
|
319
|
+
const [sm, setSm] = useState<ICheckboxTreeCheckboxData[]>(createData());
|
|
320
|
+
const [md, setMd] = useState<ICheckboxTreeCheckboxData[]>(createData());
|
|
321
|
+
const [lg, setLg] = useState<ICheckboxTreeCheckboxData[]>(createData());
|
|
322
|
+
|
|
323
|
+
return (
|
|
324
|
+
<Row>
|
|
325
|
+
<Col size={4}>
|
|
326
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>SM</div>
|
|
327
|
+
<CheckboxTree checkboxes={sm} onChange={setSm} size={EComponentSize.SM} />
|
|
328
|
+
</Col>
|
|
329
|
+
<Col size={4}>
|
|
330
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>MD</div>
|
|
331
|
+
<CheckboxTree checkboxes={md} onChange={setMd} />
|
|
332
|
+
</Col>
|
|
333
|
+
<Col size={4}>
|
|
334
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>LG</div>
|
|
335
|
+
<CheckboxTree checkboxes={lg} onChange={setLg} size={EComponentSize.LG} />
|
|
336
|
+
</Col>
|
|
337
|
+
</Row>
|
|
338
|
+
);
|
|
339
|
+
};
|
|
340
|
+
```
|
|
341
|
+
|
|
@@ -319,3 +319,117 @@ margin). Кандидат на токенизацию.
|
|
|
319
319
|
| Дата | Изменение |
|
|
320
320
|
|---|---|
|
|
321
321
|
| 2026-04-18 | Создан документ |
|
|
322
|
+
|
|
323
|
+
---
|
|
324
|
+
|
|
325
|
+
## Примеры использования
|
|
326
|
+
|
|
327
|
+
### Default
|
|
328
|
+
|
|
329
|
+
`stories/CheckboxTreeExtended/examples/DefaultExample.tsx`
|
|
330
|
+
|
|
331
|
+
```tsx
|
|
332
|
+
import React from "react";
|
|
333
|
+
import { CheckboxTreeExtended, EComponentSize } from "@sberbusiness/triplex-next";
|
|
334
|
+
|
|
335
|
+
type CheckboxNode = { id: string; label: string; checked: boolean; bulk?: boolean; children?: CheckboxNode[] };
|
|
336
|
+
|
|
337
|
+
const INITIAL: CheckboxNode[] = [
|
|
338
|
+
{ id: "1", label: "Группа 1", checked: false, children: [{ id: "1-1", label: "Значение 1-1", checked: false }] },
|
|
339
|
+
{ id: "2", label: "Группа 2", checked: false },
|
|
340
|
+
];
|
|
341
|
+
|
|
342
|
+
export const DefaultExample = ({ size = EComponentSize.MD }: { size?: EComponentSize }) => {
|
|
343
|
+
const [checkboxes, setCheckboxes] = React.useState<CheckboxNode[]>(INITIAL);
|
|
344
|
+
|
|
345
|
+
const onChange = (target: CheckboxNode) => (event: React.ChangeEvent<HTMLInputElement>) => {
|
|
346
|
+
target.checked = event.target.checked;
|
|
347
|
+
setCheckboxes([...checkboxes]);
|
|
348
|
+
};
|
|
349
|
+
|
|
350
|
+
const renderNode = (node: CheckboxNode) => (
|
|
351
|
+
<CheckboxTreeExtended.Node
|
|
352
|
+
id={node.id}
|
|
353
|
+
key={node.id}
|
|
354
|
+
checkbox={(props) => (
|
|
355
|
+
<CheckboxTreeExtended.Checkbox
|
|
356
|
+
{...props}
|
|
357
|
+
onChange={onChange(node)}
|
|
358
|
+
bulk={node.bulk}
|
|
359
|
+
checked={node.checked}
|
|
360
|
+
>
|
|
361
|
+
{node.label}
|
|
362
|
+
</CheckboxTreeExtended.Checkbox>
|
|
363
|
+
)}
|
|
364
|
+
>
|
|
365
|
+
{node.children?.map((child) => renderNode(child))}
|
|
366
|
+
</CheckboxTreeExtended.Node>
|
|
367
|
+
);
|
|
368
|
+
|
|
369
|
+
return <CheckboxTreeExtended size={size}>{checkboxes.map((node) => renderNode(node))}</CheckboxTreeExtended>;
|
|
370
|
+
};
|
|
371
|
+
```
|
|
372
|
+
|
|
373
|
+
### Sizes
|
|
374
|
+
|
|
375
|
+
`stories/CheckboxTreeExtended/examples/SizesExample.tsx`
|
|
376
|
+
|
|
377
|
+
```tsx
|
|
378
|
+
import React from "react";
|
|
379
|
+
import { CheckboxTreeExtended, Col, EComponentSize, Row } from "@sberbusiness/triplex-next";
|
|
380
|
+
|
|
381
|
+
type CheckboxNode = { id: string; label: string; checked: boolean; bulk?: boolean; children?: CheckboxNode[] };
|
|
382
|
+
|
|
383
|
+
const INITIAL: CheckboxNode[] = [
|
|
384
|
+
{ id: "1", label: "Группа 1", checked: false, children: [{ id: "1-1", label: "Значение 1-1", checked: false }] },
|
|
385
|
+
{ id: "2", label: "Группа 2", checked: false },
|
|
386
|
+
];
|
|
387
|
+
|
|
388
|
+
const TreeBySize = ({ size = EComponentSize.MD }: { size?: EComponentSize }) => {
|
|
389
|
+
const [checkboxes, setCheckboxes] = React.useState<CheckboxNode[]>(INITIAL);
|
|
390
|
+
|
|
391
|
+
const onChange = (target: CheckboxNode) => (event: React.ChangeEvent<HTMLInputElement>) => {
|
|
392
|
+
target.checked = event.target.checked;
|
|
393
|
+
setCheckboxes([...checkboxes]);
|
|
394
|
+
};
|
|
395
|
+
|
|
396
|
+
const renderNode = (node: CheckboxNode) => (
|
|
397
|
+
<CheckboxTreeExtended.Node
|
|
398
|
+
id={node.id}
|
|
399
|
+
key={node.id}
|
|
400
|
+
checkbox={(props) => (
|
|
401
|
+
<CheckboxTreeExtended.Checkbox
|
|
402
|
+
{...props}
|
|
403
|
+
onChange={onChange(node)}
|
|
404
|
+
bulk={node.bulk}
|
|
405
|
+
checked={node.checked}
|
|
406
|
+
>
|
|
407
|
+
{node.label}
|
|
408
|
+
</CheckboxTreeExtended.Checkbox>
|
|
409
|
+
)}
|
|
410
|
+
>
|
|
411
|
+
{node.children?.map((child) => renderNode(child))}
|
|
412
|
+
</CheckboxTreeExtended.Node>
|
|
413
|
+
);
|
|
414
|
+
|
|
415
|
+
return <CheckboxTreeExtended size={size}>{checkboxes.map((node) => renderNode(node))}</CheckboxTreeExtended>;
|
|
416
|
+
};
|
|
417
|
+
|
|
418
|
+
export const SizesExample = () => (
|
|
419
|
+
<Row>
|
|
420
|
+
<Col size={4}>
|
|
421
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>SM</div>
|
|
422
|
+
<TreeBySize size={EComponentSize.SM} />
|
|
423
|
+
</Col>
|
|
424
|
+
<Col size={4}>
|
|
425
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>MD</div>
|
|
426
|
+
<TreeBySize size={EComponentSize.MD} />
|
|
427
|
+
</Col>
|
|
428
|
+
<Col size={4}>
|
|
429
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>LG</div>
|
|
430
|
+
<TreeBySize size={EComponentSize.LG} />
|
|
431
|
+
</Col>
|
|
432
|
+
</Row>
|
|
433
|
+
);
|
|
434
|
+
```
|
|
435
|
+
|
|
@@ -1,68 +1,172 @@
|
|
|
1
1
|
---
|
|
2
2
|
component: CheckboxXGroup
|
|
3
3
|
category: Inputs
|
|
4
|
-
figma-node: ""
|
|
5
|
-
figma-file: ""
|
|
6
4
|
related: [Checkbox]
|
|
7
5
|
tokens: []
|
|
8
|
-
stories: stories/
|
|
6
|
+
stories: stories/CheckboxXGroup/CheckboxXGroup.stories.tsx
|
|
9
7
|
version: "1.0"
|
|
10
8
|
---
|
|
11
9
|
|
|
12
10
|
# CheckboxXGroup
|
|
13
11
|
|
|
14
12
|
## Назначение
|
|
15
|
-
|
|
16
|
-
Используется как контейнер для нескольких `Checkbox`, когда нужно разложить их в строку с переносами.
|
|
13
|
+
|
|
14
|
+
Компонент-группа для компоновки чекбоксов с направлением по оси `X`. Используется как контейнер для нескольких `Checkbox`, когда нужно разложить их в строку с переносами.
|
|
15
|
+
|
|
16
|
+
Используй когда: несколько связанных чекбоксов нужно разместить в строку.
|
|
17
|
+
Не используй когда: чекбоксы должны идти вертикально — используй `CheckboxYGroup`.
|
|
17
18
|
|
|
18
19
|
---
|
|
19
20
|
|
|
20
21
|
## Варианты и props
|
|
22
|
+
|
|
23
|
+
### Обязательные props
|
|
24
|
+
|
|
25
|
+
Обязательных custom-props нет.
|
|
26
|
+
|
|
21
27
|
### Опциональные props
|
|
28
|
+
|
|
22
29
|
| Prop | Тип | По умолчанию | Описание |
|
|
23
30
|
|---|---|---|---|
|
|
24
31
|
| `indent` | `TIndentSize` | `12` | Отступы/зазоры между чекбоксами в группе. Возможные значения: `12, 16, 20, 24, 28, 32`. |
|
|
25
32
|
| `children` | `React.ReactNode` | — | Внутри обычно рендерятся `Checkbox`. |
|
|
26
33
|
| `...divAttributes` | `React.HTMLAttributes<HTMLDivElement>` | — | Все стандартные HTML-атрибуты для корневого элемента. |
|
|
27
34
|
|
|
28
|
-
|
|
35
|
+
### Ограничения использования
|
|
29
36
|
|
|
30
|
-
|
|
31
|
-
-
|
|
32
|
-
- Разметка: `inline-flex` и `flex-flow: row wrap`.
|
|
33
|
-
- `indent` управляет применением LESS-класса `indent-{n}` и задает отрицательные/положительные маргины для выравнивания сетки.
|
|
37
|
+
- Корневой элемент — `<div role="group">`, разметка построена на `inline-flex` и `flex-flow: row wrap`.
|
|
38
|
+
- `indent` управляет применением LESS-класса `indent-{n}` и задаёт отрицательные/положительные маргины для выравнивания сетки.
|
|
34
39
|
|
|
35
40
|
---
|
|
36
41
|
|
|
37
|
-
##
|
|
38
|
-
|
|
39
|
-
|
|
42
|
+
## Дизайн-токены
|
|
43
|
+
|
|
44
|
+
Компонент не использует собственных CSS-переменных. Все визуальные стили наследуются от `Checkbox`.
|
|
40
45
|
|
|
41
46
|
---
|
|
42
47
|
|
|
43
48
|
## Инварианты
|
|
49
|
+
|
|
44
50
|
- `forwardRef` обязателен и должен указывать на корневой `<div>`.
|
|
45
51
|
- Корневой DOM-элемент компонента — `<div>`, роль зафиксирована как `role="group"`.
|
|
46
52
|
|
|
47
53
|
---
|
|
48
54
|
|
|
55
|
+
## Accessibility
|
|
56
|
+
|
|
57
|
+
- `role="group"` описывает группу взаимосвязанных контролов.
|
|
58
|
+
- Семантика чекбоксов остаётся нативной на уровне `Checkbox` внутри группы.
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
49
62
|
## Связанные компоненты
|
|
63
|
+
|
|
50
64
|
- `Checkbox` — базовый чекбокс, обычно используется внутри `CheckboxXGroup`.
|
|
65
|
+
- `CheckboxYGroup` — аналогичная группа, но с направлением по оси `Y`.
|
|
51
66
|
|
|
52
67
|
---
|
|
53
68
|
|
|
54
69
|
## Stories
|
|
55
|
-
|
|
56
|
-
|
|
70
|
+
|
|
71
|
+
Основные истории: `stories/CheckboxXGroup/CheckboxXGroup.stories.tsx`
|
|
72
|
+
Файлы примеров: `stories/CheckboxXGroup/examples/`
|
|
57
73
|
|
|
58
74
|
| Story | Example file | Что демонстрирует |
|
|
59
75
|
|---|---|---|
|
|
60
|
-
| `
|
|
76
|
+
| `Playground` | `PlaygroundExample.tsx` | Интерактивный контроль `indent` |
|
|
77
|
+
| `Default` | `DefaultExample.tsx` | Группа по оси X |
|
|
78
|
+
| `CheckboxSizes` | `SizesExample.tsx` | Группа чекбоксов разных размеров |
|
|
79
|
+
| `Indents` | `IndentsExample.tsx` | Различные значения отступа |
|
|
61
80
|
|
|
62
81
|
---
|
|
63
82
|
|
|
64
83
|
## История изменений
|
|
84
|
+
|
|
65
85
|
| Дата | Изменение |
|
|
66
86
|
|---|---|
|
|
67
87
|
| 2026-04-16 | Приведение `CheckboxXGroup` к AI-ready: добавлен `forwardRef`, типизирован `children`, созданы AI-документ и инварианты. |
|
|
88
|
+
| 2026-04-27 | Приведён в соответствие с `docs/ai/template-ai.md`: убрана секция «Ключевые особенности реализации» (содержимое перенесено в `Ограничения использования`), переставлены секции, добавлена колонка `Example file` и пустой раздел `Дизайн-токены`. |
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## Примеры использования
|
|
93
|
+
|
|
94
|
+
### Default
|
|
95
|
+
|
|
96
|
+
`stories/CheckboxXGroup/examples/DefaultExample.tsx`
|
|
97
|
+
|
|
98
|
+
```tsx
|
|
99
|
+
import React from "react";
|
|
100
|
+
import { Checkbox, CheckboxXGroup } from "@sberbusiness/triplex-next";
|
|
101
|
+
|
|
102
|
+
export const DefaultExample = () => (
|
|
103
|
+
<CheckboxXGroup>
|
|
104
|
+
{[1, 2, 3].map((value) => (
|
|
105
|
+
<Checkbox key={value} name="checkbox-x-group" value={value}>
|
|
106
|
+
Checkbox text
|
|
107
|
+
</Checkbox>
|
|
108
|
+
))}
|
|
109
|
+
</CheckboxXGroup>
|
|
110
|
+
);
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### CheckboxSizes
|
|
114
|
+
|
|
115
|
+
`stories/CheckboxXGroup/examples/SizesExample.tsx`
|
|
116
|
+
|
|
117
|
+
```tsx
|
|
118
|
+
import React from "react";
|
|
119
|
+
import { Checkbox, CheckboxXGroup, EComponentSize } from "@sberbusiness/triplex-next";
|
|
120
|
+
|
|
121
|
+
const sizes = [
|
|
122
|
+
{ label: "SM", size: EComponentSize.SM },
|
|
123
|
+
{ label: "MD", size: EComponentSize.MD },
|
|
124
|
+
{ label: "LG", size: EComponentSize.LG },
|
|
125
|
+
] as const;
|
|
126
|
+
|
|
127
|
+
export const SizesExample = () => (
|
|
128
|
+
<div style={{ display: "flex", flexDirection: "column", gap: "24px" }}>
|
|
129
|
+
{sizes.map(({ label, size }) => (
|
|
130
|
+
<div key={label}>
|
|
131
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>{label}</div>
|
|
132
|
+
<CheckboxXGroup>
|
|
133
|
+
{[1, 2, 3].map((value) => (
|
|
134
|
+
<Checkbox key={value} name={`checkbox-x-group-${label}`} value={value} size={size}>
|
|
135
|
+
Checkbox text
|
|
136
|
+
</Checkbox>
|
|
137
|
+
))}
|
|
138
|
+
</CheckboxXGroup>
|
|
139
|
+
</div>
|
|
140
|
+
))}
|
|
141
|
+
</div>
|
|
142
|
+
);
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Indents
|
|
146
|
+
|
|
147
|
+
`stories/CheckboxXGroup/examples/IndentsExample.tsx`
|
|
148
|
+
|
|
149
|
+
```tsx
|
|
150
|
+
import React from "react";
|
|
151
|
+
import { Checkbox, CheckboxXGroup } from "@sberbusiness/triplex-next";
|
|
152
|
+
|
|
153
|
+
const indents = [12, 16, 20, 24, 28, 32] as const;
|
|
154
|
+
|
|
155
|
+
export const IndentsExample = () => (
|
|
156
|
+
<div style={{ display: "flex", flexDirection: "column", gap: "24px" }}>
|
|
157
|
+
{indents.map((indent) => (
|
|
158
|
+
<div key={indent}>
|
|
159
|
+
<div style={{ marginBottom: "8px", fontSize: "16px", fontWeight: "700" }}>{indent}px</div>
|
|
160
|
+
<CheckboxXGroup indent={indent}>
|
|
161
|
+
{[1, 2, 3, 4].map((value) => (
|
|
162
|
+
<Checkbox key={value} name={`checkbox-x-group-${indent}`} value={value}>
|
|
163
|
+
Checkbox text
|
|
164
|
+
</Checkbox>
|
|
165
|
+
))}
|
|
166
|
+
</CheckboxXGroup>
|
|
167
|
+
</div>
|
|
168
|
+
))}
|
|
169
|
+
</div>
|
|
170
|
+
);
|
|
171
|
+
```
|
|
68
172
|
|