sellmate-design-system-react 9.0.0-beta.4 → 9.0.0-beta.40
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/AGENTS.md +642 -88
- package/README.md +111 -9
- package/dist/components/SAccountListBox/AccountListBoxPortal.d.ts +31 -0
- package/dist/components/SAccountListBox/README.md +86 -0
- package/dist/components/SAccountListBox/SAccountListBox.d.ts +79 -0
- package/dist/components/SAccountListBox/SystemMenuPortal.d.ts +58 -0
- package/dist/components/SAccountListBox/accountListBox.config.d.ts +64 -0
- package/dist/components/SAccountListBox/index.d.ts +2 -0
- package/dist/components/SBadge/README.md +26 -0
- package/dist/components/SBadge/SBadge.d.ts +1 -1
- package/dist/components/SBarcodeInput/README.md +9 -1
- package/dist/components/SBarcodeInput/SBarcodeInput.d.ts +7 -1
- package/dist/components/SButton/README.md +38 -0
- package/dist/components/SCalendar/README.md +13 -0
- package/dist/components/SCalendarBoard/CalendarDayCard.d.ts +38 -0
- package/dist/components/SCalendarBoard/CalendarDayEventListBox.d.ts +26 -0
- package/dist/components/SCalendarBoard/CalendarEventButton.d.ts +13 -0
- package/dist/components/SCalendarBoard/CalendarMoreButton.d.ts +12 -0
- package/dist/components/SCalendarBoard/README.md +137 -0
- package/dist/components/SCalendarBoard/SCalendarBoard.d.ts +68 -0
- package/dist/components/SCalendarBoard/calendarBoard.config.d.ts +33 -0
- package/dist/components/SCalendarBoard/index.d.ts +3 -0
- package/dist/components/SCalendarBoard/types.d.ts +31 -0
- package/dist/components/SCallout/README.md +16 -1
- package/dist/components/SCallout/SCallout.d.ts +9 -4
- package/dist/components/SCard/README.md +16 -0
- package/dist/components/SCard/SCard.d.ts +17 -2
- package/dist/components/SCheckbox/README.md +8 -0
- package/dist/components/SChipFilter/README.md +339 -14
- package/dist/components/SChipFilter/SChipFilter.d.ts +150 -60
- package/dist/components/SChipFilter/index.d.ts +1 -1
- package/dist/components/SChipInput/README.md +15 -1
- package/dist/components/SChipInput/SChipInput.d.ts +7 -1
- package/dist/components/SChipInput/index.d.ts +1 -1
- package/dist/components/SCircleProgress/README.md +8 -0
- package/dist/components/SConfirmModal/README.md +17 -1
- package/dist/components/SConfirmModal/SConfirmModal.d.ts +2 -2
- package/dist/components/SConfirmModal/index.d.ts +1 -1
- package/dist/components/SDatePicker/README.md +20 -2
- package/dist/components/SDatePicker/SDatePicker.d.ts +27 -4
- package/dist/components/SDateRangePicker/README.md +17 -2
- package/dist/components/SDateRangePicker/SDateRangePicker.d.ts +16 -3
- package/dist/components/SDivider/README.md +7 -0
- package/dist/components/SDivider/SDivider.d.ts +11 -0
- package/dist/components/SDraggableItem/README.md +37 -0
- package/dist/components/SDraggableItem/SDraggableItem.d.ts +2 -0
- package/dist/components/SDraggableItem/index.d.ts +1 -1
- package/dist/components/SDraggableList/README.md +30 -0
- package/dist/components/SDraggableList/SDraggableList.d.ts +11 -0
- package/dist/components/SDraggableList/index.d.ts +1 -1
- package/dist/components/SDrawer/README.md +8 -0
- package/dist/components/SDropdownButton/README.md +19 -0
- package/dist/components/SEditor/EditorBody.d.ts +36 -0
- package/dist/components/SEditor/EditorToolbar.d.ts +93 -0
- package/dist/components/SEditor/README.md +203 -0
- package/dist/components/SEditor/SEditor.d.ts +114 -0
- package/dist/components/SEditor/editor-icons.d.ts +63 -0
- package/dist/components/SEditor/editor.config.d.ts +119 -0
- package/dist/components/SEditor/index.d.ts +8 -0
- package/dist/components/SEditor/tiptap-api.d.ts +29 -0
- package/dist/components/SEditor/use-is-mobile.d.ts +14 -0
- package/dist/components/SExpansionItem/README.md +36 -0
- package/dist/components/SExpansionItem/index.d.ts +1 -1
- package/dist/components/SField/README.md +27 -3
- package/dist/components/SField/SField.d.ts +12 -6
- package/dist/components/SFilePicker/README.md +15 -1
- package/dist/components/SFilePicker/SFilePicker.d.ts +7 -1
- package/dist/components/SFooter/README.md +25 -0
- package/dist/components/SFooter/SFooter.d.ts +4 -3
- package/dist/components/SForm/README.md +11 -0
- package/dist/components/SGhostButton/README.md +22 -4
- package/dist/components/SGnb/README.md +51 -0
- package/dist/components/SGnb/SGnb.d.ts +50 -0
- package/dist/components/SGnb/gnb.config.d.ts +10 -3
- package/dist/components/SGnb/index.d.ts +1 -1
- package/dist/components/SGnbSystem/README.md +186 -0
- package/dist/components/SGnbSystem/SGnbSystem.d.ts +179 -0
- package/dist/components/SGnbSystem/gnbSystem.config.d.ts +122 -0
- package/dist/components/SGnbSystem/index.d.ts +2 -0
- package/dist/components/SGuide/README.md +15 -0
- package/dist/components/SIcon/README.md +10 -0
- package/dist/components/SIcon/SIcon.d.ts +1 -1
- package/dist/components/SIcon/icons.gen.d.ts +4 -0
- package/dist/components/SImage/README.md +14 -0
- package/dist/components/SInput/README.md +3 -1
- package/dist/components/SInput/SInput.d.ts +7 -1
- package/dist/components/SKeyValueTable/README.md +86 -0
- package/dist/components/SKeyValueTable/SKeyValueTable.d.ts +6 -2
- package/dist/components/SKeyValueTable/index.d.ts +1 -1
- package/dist/components/SLayout/README.md +21 -0
- package/dist/components/SLayout/SLayout.d.ts +4 -0
- package/dist/components/SLayout/index.d.ts +1 -1
- package/dist/components/SLinearProgress/README.md +15 -0
- package/dist/components/SLinearProgress/SLinearProgress.d.ts +3 -0
- package/dist/components/SLinearProgress/index.d.ts +1 -1
- package/dist/components/SList/README.md +5 -1
- package/dist/components/SList/SList.d.ts +0 -2
- package/dist/components/SListItem/README.md +41 -0
- package/dist/components/SListItem/index.d.ts +1 -1
- package/dist/components/SLoadingContainer/loading.d.ts +18 -2
- package/dist/components/SLoadingModal/README.md +9 -1
- package/dist/components/SLoadingModal/SLoadingModal.d.ts +2 -2
- package/dist/components/SLoadingModal/index.d.ts +1 -1
- package/dist/components/SNumberInput/README.md +9 -1
- package/dist/components/SNumberInput/SNumberInput.d.ts +7 -1
- package/dist/components/SPage/README.md +47 -4
- package/dist/components/SPage/SPage.d.ts +15 -10
- package/dist/components/SPage/SPageHeader.d.ts +18 -11
- package/dist/components/SPage/index.d.ts +1 -1
- package/dist/components/SPage/page-column.d.ts +25 -0
- package/dist/components/SPopover/README.md +15 -0
- package/dist/components/SPopup/README.md +19 -0
- package/dist/components/SPortal/README.md +18 -0
- package/dist/components/SRadio/README.md +20 -0
- package/dist/components/SRadioButton/README.md +18 -0
- package/dist/components/SRadioButton/SRadioButton.d.ts +1 -1
- package/dist/components/SRadioCard/README.md +78 -0
- package/dist/components/SRadioCard/SRadioCard.d.ts +29 -0
- package/dist/components/SRadioCard/SRadioCardGroup.d.ts +36 -0
- package/dist/components/SRadioCard/index.d.ts +2 -0
- package/dist/components/SScrollArea/README.md +27 -0
- package/dist/components/SSearchInput/README.md +63 -0
- package/dist/components/SSearchInput/SSearchInput.d.ts +52 -0
- package/dist/components/SSearchInput/index.d.ts +1 -0
- package/dist/components/SSectionHeaderCard/README.md +37 -0
- package/dist/components/SSectionHeaderCard/SSectionHeaderCard.d.ts +10 -0
- package/dist/components/SSelect/README.md +24 -6
- package/dist/components/SSelect/SSelect.d.ts +14 -2
- package/dist/components/SSplitter/README.md +15 -0
- package/dist/components/SStepper/README.md +26 -0
- package/dist/components/SSwitch/README.md +13 -0
- package/dist/components/SSystemActionButton/README.md +221 -0
- package/dist/components/SSystemActionButton/SSystemActionButton.d.ts +161 -0
- package/dist/components/SSystemActionButton/index.d.ts +2 -0
- package/dist/components/SSystemActionButton/systemActionButton.config.d.ts +93 -0
- package/dist/components/STable/README.md +86 -1
- package/dist/components/STable/STable.d.ts +121 -11
- package/dist/components/STable/index.d.ts +1 -1
- package/dist/components/STabs/README.md +12 -1
- package/dist/components/STabs/STabs.d.ts +2 -4
- package/dist/components/STabs/index.d.ts +1 -1
- package/dist/components/STabs/tabs.config.d.ts +3 -4
- package/dist/components/STag/README.md +52 -0
- package/dist/components/STag/STag.d.ts +3 -1
- package/dist/components/STextLink/README.md +18 -0
- package/dist/components/STextLink/STextLink.d.ts +4 -0
- package/dist/components/STextarea/README.md +1 -1
- package/dist/components/STextarea/STextarea.d.ts +7 -1
- package/dist/components/STimePicker/README.md +15 -1
- package/dist/components/STimePicker/STimePicker.d.ts +7 -1
- package/dist/components/STimePicker/timepicker.config.d.ts +4 -2
- package/dist/components/STimeRangePicker/README.md +27 -1
- package/dist/components/STimeRangePicker/STimeRangePicker.d.ts +7 -1
- package/dist/components/SToast/README.md +24 -0
- package/dist/components/SToggle/README.md +8 -0
- package/dist/components/SToggle/index.d.ts +1 -1
- package/dist/components/STooltip/README.md +24 -0
- package/dist/components/STree/README.md +41 -0
- package/dist/components/STree/STree.d.ts +8 -0
- package/dist/components/STree/index.d.ts +1 -1
- package/dist/docs/Gallery.d.ts +9 -0
- package/dist/docs/gallery-previews.d.ts +24 -0
- package/dist/index.cjs +10754 -5244
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +8 -0
- package/dist/index.js +10718 -5244
- package/dist/index.js.map +1 -1
- package/dist/lib/doc-sections.d.ts +35 -0
- package/dist/lib/field-width.d.ts +31 -0
- package/dist/lib/floating-height.d.ts +15 -0
- package/dist/lib/story-docs.d.ts +19 -3
- package/dist/lib/truncated-value-tooltip.d.ts +18 -0
- package/dist/llms-full.txt +3263 -228
- package/dist/llms.txt +647 -90
- package/dist/playground/categories.d.ts +19 -0
- package/dist/styles.css +1725 -169
- package/dist/theme.css +216 -24
- package/eslint/index.mjs +14 -0
- package/eslint/lib/table-column.mjs +26 -0
- package/eslint/rules/divider-vertical-height.mjs +137 -0
- package/eslint/rules/field-width-grade.d.mts +41 -0
- package/eslint/rules/field-width-grade.mjs +311 -0
- package/eslint/rules/table-column-width.mjs +110 -0
- package/eslint/scale.gen.mjs +5 -2
- package/package.json +13 -1
|
@@ -14,3 +14,30 @@
|
|
|
14
14
|
| `maxHeight?` | `string` | — | viewport 최대 높이 (예: '400px'). 비우면 부모 크기를 따른다. |
|
|
15
15
|
| `maxWidth?` | `string` | — | viewport 최대 너비 (예: '480px'). 비우면 부모 크기를 따른다. |
|
|
16
16
|
|
|
17
|
+
## Types
|
|
18
|
+
|
|
19
|
+
### SScrollAreaAxis
|
|
20
|
+
|
|
21
|
+
```ts
|
|
22
|
+
export type SScrollAreaAxis = (typeof SCROLL_AREA_AXES)[number];
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### SCROLL_AREA_AXES
|
|
26
|
+
|
|
27
|
+
```ts
|
|
28
|
+
export const SCROLL_AREA_AXES = ['vertical', 'horizontal', 'both'] as const;
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Dependencies
|
|
32
|
+
|
|
33
|
+
### Used by
|
|
34
|
+
|
|
35
|
+
- [SCalendarBoard](../SCalendarBoard)
|
|
36
|
+
|
|
37
|
+
### Graph
|
|
38
|
+
|
|
39
|
+
```mermaid
|
|
40
|
+
graph TD;
|
|
41
|
+
SCalendarBoard --> SScrollArea
|
|
42
|
+
style SScrollArea fill:#f9f,stroke:#333,stroke-width:4px
|
|
43
|
+
```
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# SSearchInput
|
|
2
|
+
|
|
3
|
+
> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
|
|
4
|
+
|
|
5
|
+
### SSearchInput
|
|
6
|
+
|
|
7
|
+
#### Props
|
|
8
|
+
|
|
9
|
+
| Prop | Type | Default | Description |
|
|
10
|
+
|------|------|---------|-------------|
|
|
11
|
+
| `value?` | `string \| number` | — | 값 (제어) |
|
|
12
|
+
| `size?` | `SSearchInputSize` | `'sm'` | 크기 |
|
|
13
|
+
| `placeholder?` | `string` | `'결과 내 검색'` | 플레이스홀더 |
|
|
14
|
+
| `clearable?` | `boolean` | `false` | 지우기 버튼 — 값이 있을 때만 나타난다 |
|
|
15
|
+
| `disabled?` | `boolean` | `false` | 비활성 |
|
|
16
|
+
| `width?` | `SFieldWidth` | — | 컨트롤 너비 — 폭 등급(`'xs' | 'sm' | 'md' | 'lg' | 'xl'`) · 숫자=px · CSS 길이. 등급은 `--cmp-field-width-*` 토큰으로 풀리므로 토큰이 바뀌면 화면이 따라간다. 값 길이에 상한이 없으면 `"100%"` 로 두어 행 전체를 쓴다. 미지정 시 부모 폭을 채운다. |
|
|
17
|
+
| `focused?` | `boolean` | — | 포커스 상태 (제어/반영) |
|
|
18
|
+
| `hovered?` | `boolean` | — | 호버 상태 (제어/반영) |
|
|
19
|
+
| `inputClass?` | `string` | — | 내부 input 요소 className |
|
|
20
|
+
| `inputStyle?` | `CSSProperties` | — | 내부 input 요소 style |
|
|
21
|
+
| `className?` | `string` | — | |
|
|
22
|
+
| `style?` | `CSSProperties` | — | |
|
|
23
|
+
|
|
24
|
+
#### Events
|
|
25
|
+
|
|
26
|
+
| Event | Type | Description |
|
|
27
|
+
|-------|------|-------------|
|
|
28
|
+
| `onValueChange` | `(value: string) => void` | 값 변경 — 문자열 전달 |
|
|
29
|
+
| `onChange` | `InputHTMLAttributes<HTMLInputElement>['onChange']` | 네이티브 onChange (form-agnostic 연동용, RHF 등) |
|
|
30
|
+
| `onSearch` | `(value: string) => void` | 검색 실행 — Enter 키에서 현재 값과 함께 호출된다. 한글 조합 중의 Enter(IME 확정)는 검색으로 치지 않는다. |
|
|
31
|
+
|
|
32
|
+
## Types
|
|
33
|
+
|
|
34
|
+
### SSearchInputSize
|
|
35
|
+
|
|
36
|
+
```ts
|
|
37
|
+
export type SSearchInputSize = SFieldSize;
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Dependencies
|
|
41
|
+
|
|
42
|
+
### Used by
|
|
43
|
+
|
|
44
|
+
- [SChipFilter](../SChipFilter)
|
|
45
|
+
- [SSelect](../SSelect)
|
|
46
|
+
|
|
47
|
+
### Depends on
|
|
48
|
+
|
|
49
|
+
- [SField](../SField)
|
|
50
|
+
- [SGhostButton](../SGhostButton)
|
|
51
|
+
- [SIcon](../SIcon)
|
|
52
|
+
|
|
53
|
+
### Graph
|
|
54
|
+
|
|
55
|
+
```mermaid
|
|
56
|
+
graph TD;
|
|
57
|
+
SSearchInput --> SField
|
|
58
|
+
SSearchInput --> SGhostButton
|
|
59
|
+
SSearchInput --> SIcon
|
|
60
|
+
SChipFilter --> SSearchInput
|
|
61
|
+
SSelect --> SSearchInput
|
|
62
|
+
style SSearchInput fill:#f9f,stroke:#333,stroke-width:4px
|
|
63
|
+
```
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import { type CSSProperties, type InputHTMLAttributes } from 'react';
|
|
2
|
+
import { type SFieldSize } from '../SField';
|
|
3
|
+
import { type SFieldWidth } from '../../lib/field-width';
|
|
4
|
+
export type SSearchInputSize = SFieldSize;
|
|
5
|
+
export interface SSearchInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'value' | 'onChange' | 'type' | 'prefix' | 'suffix'> {
|
|
6
|
+
/** 값 (제어) */
|
|
7
|
+
value?: string | number;
|
|
8
|
+
/** 값 변경 — 문자열 전달 */
|
|
9
|
+
onValueChange?: (value: string) => void;
|
|
10
|
+
/** 네이티브 onChange (form-agnostic 연동용, RHF 등) */
|
|
11
|
+
onChange?: InputHTMLAttributes<HTMLInputElement>['onChange'];
|
|
12
|
+
/**
|
|
13
|
+
* 검색 실행 — Enter 키에서 현재 값과 함께 호출된다.
|
|
14
|
+
* 한글 조합 중의 Enter(IME 확정)는 검색으로 치지 않는다.
|
|
15
|
+
*/
|
|
16
|
+
onSearch?: (value: string) => void;
|
|
17
|
+
/** 크기 */
|
|
18
|
+
size?: SSearchInputSize;
|
|
19
|
+
/** 플레이스홀더 */
|
|
20
|
+
placeholder?: string;
|
|
21
|
+
/** 지우기 버튼 — 값이 있을 때만 나타난다 */
|
|
22
|
+
clearable?: boolean;
|
|
23
|
+
/** 비활성 */
|
|
24
|
+
disabled?: boolean;
|
|
25
|
+
/**
|
|
26
|
+
* 컨트롤 너비 — 폭 등급(`'xs' | 'sm' | 'md' | 'lg' | 'xl'`) · 숫자=px · CSS 길이.
|
|
27
|
+
* 등급은 `--cmp-field-width-*` 토큰으로 풀리므로 토큰이 바뀌면 화면이 따라간다.
|
|
28
|
+
* 값 길이에 상한이 없으면 `"100%"` 로 두어 행 전체를 쓴다.
|
|
29
|
+
* 미지정 시 부모 폭을 채운다.
|
|
30
|
+
*/
|
|
31
|
+
width?: SFieldWidth;
|
|
32
|
+
/** 포커스 상태 (제어/반영) */
|
|
33
|
+
focused?: boolean;
|
|
34
|
+
/** 호버 상태 (제어/반영) */
|
|
35
|
+
hovered?: boolean;
|
|
36
|
+
/** 내부 input 요소 className */
|
|
37
|
+
inputClass?: string;
|
|
38
|
+
/** 내부 input 요소 style */
|
|
39
|
+
inputStyle?: CSSProperties;
|
|
40
|
+
className?: string;
|
|
41
|
+
style?: CSSProperties;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* SSearchInput — 목록·결과를 검색어로 좁히는 한 줄 입력.
|
|
45
|
+
*
|
|
46
|
+
* 테두리 박스(border/radius/배경 + hover·focus 강조)는 `SField` 가 소유하고,
|
|
47
|
+
* 이 컴포넌트는 그 안의 돋보기 아이콘 + input 만 그린다.
|
|
48
|
+
* 좌측 아이콘은 **장식**이라 클릭 대상이 아니다 — 검색 실행은 Enter(`onSearch`) 다.
|
|
49
|
+
*
|
|
50
|
+
* 라벨·검증·에러 메시지가 필요한 폼 필드라면 `SInput` 을 쓴다.
|
|
51
|
+
*/
|
|
52
|
+
export declare const SSearchInput: import("react").ForwardRefExoticComponent<SSearchInputProps & import("react").RefAttributes<HTMLInputElement>>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { SSearchInput, type SSearchInputProps, type SSearchInputSize } from './SSearchInput';
|
|
@@ -19,13 +19,49 @@
|
|
|
19
19
|
| `headerClassName?` | `string` | — | 헤더 영역 클래스 |
|
|
20
20
|
| `padding?` | `SSectionHeaderCardBodyPadding` | — | 바디 안쪽 여백. 기본은 `default`. 성격이 다른 요소가 세 종류 이상 섞인 영역에만 `wide`, 표를 가장자리까지 채울 때만 `none`. |
|
|
21
21
|
| `background?` | `SSectionHeaderCardBodyBackground` | — | 본문 배경. 기본은 `frame` — 카드가 깐 흰 면을 그대로 쓴다. `neutral` 은 바탕을 한 단계 눌러앉혀, 흰 면 덩어리(표·리스트)가 여럿일 때 그것들이 **"면 위에 놓인 객체"로 읽히게** 한다. 위계를 한 단계 더 주고 싶을 때 고르는 선택지이며, **기본값이 틀린 것은 아니다** — 표·리스트는 테두리·라운드·헤더 줄과 간격을 이미 갖고 있어 흰 바탕에서도 경계가 읽힌다. 깔아도 **효과가 없는** 자리가 있다 — 덩어리가 가장자리까지 차는 경우(`padding="none"` 으로 표를 채우면 바탕이 완전히 가려진다), 덩어리에 회색 면이 섞인 경우(그 덩어리가 바탕에 묻힌다), 맨 텍스트나 폼 컨트롤만 있는 본문(떠오를 흰 면이 없다). |
|
|
22
|
+
| `footerLeft?` | `ReactNode` | — | 하단 액션 영역 좌측 슬롯. 보조 버튼(취소·목록 등)이 오는 자리다. `footerLeft` 또는 `button` 중 하나라도 있으면 하단 액션 영역이 렌더된다. |
|
|
23
|
+
| `button?` | `SFooterButton` | — | 하단 액션 영역 우측 주 액션 버튼 |
|
|
24
|
+
| `footerClassName?` | `string` | — | 하단 액션 영역 클래스 |
|
|
22
25
|
| `children?` | `SSectionHeaderCardChildren` | — | 바디 콘텐츠. 특정 컴포넌트 타입으로 제한하지 않습니다. |
|
|
23
26
|
|
|
27
|
+
## Types
|
|
28
|
+
|
|
29
|
+
### SSectionHeaderCardTitleSize
|
|
30
|
+
|
|
31
|
+
```ts
|
|
32
|
+
export type SSectionHeaderCardTitleSize = 'xs' | 'sm';
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
### SSectionHeaderCardThickness
|
|
36
|
+
|
|
37
|
+
```ts
|
|
38
|
+
export type SSectionHeaderCardThickness = false | 'default' | 'accent';
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### SSectionHeaderCardBodyPadding
|
|
42
|
+
|
|
43
|
+
```ts
|
|
44
|
+
export type SSectionHeaderCardBodyPadding = 'default' | 'wide' | 'none';
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### SSectionHeaderCardBodyBackground
|
|
48
|
+
|
|
49
|
+
```ts
|
|
50
|
+
export type SSectionHeaderCardBodyBackground = 'frame' | 'neutral';
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### SSectionHeaderCardChildren
|
|
54
|
+
|
|
55
|
+
```ts
|
|
56
|
+
export type SSectionHeaderCardChildren = ReactNode;
|
|
57
|
+
```
|
|
58
|
+
|
|
24
59
|
## Dependencies
|
|
25
60
|
|
|
26
61
|
### Depends on
|
|
27
62
|
|
|
28
63
|
- [SBadge](../SBadge)
|
|
64
|
+
- [SFooter](../SFooter)
|
|
29
65
|
- [SIcon](../SIcon)
|
|
30
66
|
- [STooltip](../STooltip)
|
|
31
67
|
|
|
@@ -34,6 +70,7 @@
|
|
|
34
70
|
```mermaid
|
|
35
71
|
graph TD;
|
|
36
72
|
SSectionHeaderCard --> SBadge
|
|
73
|
+
SSectionHeaderCard --> SFooter
|
|
37
74
|
SSectionHeaderCard --> SIcon
|
|
38
75
|
SSectionHeaderCard --> STooltip
|
|
39
76
|
style SSectionHeaderCard fill:#f9f,stroke:#333,stroke-width:4px
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { type HTMLAttributes, type ReactNode } from 'react';
|
|
2
|
+
import { type SFooterButton } from '../SFooter';
|
|
2
3
|
export type SSectionHeaderCardBodyChildren = ReactNode;
|
|
3
4
|
export type SSectionHeaderCardChildren = ReactNode;
|
|
4
5
|
export type SSectionHeaderCardThickness = false | 'default' | 'accent';
|
|
@@ -42,6 +43,15 @@ export interface SSectionHeaderCardProps extends Omit<HTMLAttributes<HTMLDivElem
|
|
|
42
43
|
* 맨 텍스트나 폼 컨트롤만 있는 본문(떠오를 흰 면이 없다).
|
|
43
44
|
*/
|
|
44
45
|
background?: SSectionHeaderCardBodyBackground;
|
|
46
|
+
/**
|
|
47
|
+
* 하단 액션 영역 좌측 슬롯. 보조 버튼(취소·목록 등)이 오는 자리다.
|
|
48
|
+
* `footerLeft` 또는 `button` 중 하나라도 있으면 하단 액션 영역이 렌더된다.
|
|
49
|
+
*/
|
|
50
|
+
footerLeft?: ReactNode;
|
|
51
|
+
/** 하단 액션 영역 우측 주 액션 버튼 */
|
|
52
|
+
button?: SFooterButton;
|
|
53
|
+
/** 하단 액션 영역 클래스 */
|
|
54
|
+
footerClassName?: string;
|
|
45
55
|
/** 바디 콘텐츠. 특정 컴포넌트 타입으로 제한하지 않습니다. */
|
|
46
56
|
children?: SSectionHeaderCardChildren;
|
|
47
57
|
}
|
|
@@ -18,10 +18,11 @@
|
|
|
18
18
|
| `allSelectedLabel?` | `string` | `'전체'` | 전체선택 레이블 |
|
|
19
19
|
| `placeholder?` | `string` | `'선택'` | placeholder |
|
|
20
20
|
| `disabled?` | `boolean` | `false` | 비활성 |
|
|
21
|
+
| `clearable?` | `boolean` | `false` | 선택값 지우기(×) 버튼 노출. 선택값이 있고 비활성이 아닐 때만 나타나며, 누르면 드롭다운을 열지 않고 값만 비운다. |
|
|
21
22
|
| `error?` | `boolean` | `false` | 에러 상태 |
|
|
22
23
|
| `rules?` | `Rule[]` | — | 유효성 규칙 — 닫힐 때 자동 검증 |
|
|
23
24
|
| `labelTooltipProps?` | `Partial<STooltipProps>` | — | 레이블 툴팁 상세 옵션 |
|
|
24
|
-
| `dropdownHeight?` | `string` | `'
|
|
25
|
+
| `dropdownHeight?` | `string` | `'640px'` | 드롭다운 최대 높이. 기본 640px — 창이 이보다 작으면 창 안에 남는 만큼까지만 채워진다 |
|
|
25
26
|
| `dropdownWidth?` | `string` | — | 드롭다운 너비 (없으면 트리거 너비). 창보다 넓게 줘도 창 폭까지만 벌어진다. |
|
|
26
27
|
| `maxDropdownWidth?` | `string` | `'640px'` | 드롭다운 최대 너비. 창이 이보다 좁으면 창 폭이 상한이 된다. |
|
|
27
28
|
| `label?` | `string` | — | |
|
|
@@ -33,7 +34,7 @@
|
|
|
33
34
|
| `addonAlign?` | `SFieldAddonAlign` | — | 어드온 정렬 |
|
|
34
35
|
| `hint?` | `string` | — | |
|
|
35
36
|
| `errorMessage?` | `string` | — | |
|
|
36
|
-
| `width?` | `
|
|
37
|
+
| `width?` | `SFieldWidth` | — | 컨트롤 너비 — 폭 등급(`'xs' | 'sm' | 'md' | 'lg' | 'xl'`) · 숫자=px · CSS 길이. 등급은 `--cmp-field-width-*` 토큰으로 풀리므로 토큰이 바뀌면 화면이 따라간다. 값 길이에 상한이 없으면 `"100%"` 로 두어 행 전체를 쓴다. 셀렉트는 `maxLength` 개념이 없어 목록 최장값을 담는 등급으로 고른다. |
|
|
37
38
|
| `className?` | `string` | — | |
|
|
38
39
|
| `style?` | `CSSProperties` | — | |
|
|
39
40
|
|
|
@@ -51,30 +52,47 @@
|
|
|
51
52
|
| `focus` | `() => void` | 트리거 버튼에 포커스 (sdFocus) |
|
|
52
53
|
| `open` | `() => void` | 드롭다운 열기 (sdOpen) |
|
|
53
54
|
|
|
55
|
+
## Types
|
|
56
|
+
|
|
57
|
+
### SSelectOption
|
|
58
|
+
|
|
59
|
+
```ts
|
|
60
|
+
export interface SSelectOption {
|
|
61
|
+
value: string | number;
|
|
62
|
+
label: string;
|
|
63
|
+
disabled?: boolean;
|
|
64
|
+
children?: SSelectOption[];
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### SSelectType
|
|
69
|
+
|
|
70
|
+
```ts
|
|
71
|
+
export type SSelectType = 'default' | 'multi' | 'default_depth' | 'multi_depth';
|
|
72
|
+
```
|
|
73
|
+
|
|
54
74
|
## Dependencies
|
|
55
75
|
|
|
56
76
|
### Used by
|
|
57
77
|
|
|
58
|
-
- [SChipFilter](../SChipFilter)
|
|
59
78
|
- [SKeyValueTable](../SKeyValueTable)
|
|
60
79
|
- [STable](../STable)
|
|
61
80
|
|
|
62
81
|
### Depends on
|
|
63
82
|
|
|
64
83
|
- [SField](../SField)
|
|
65
|
-
- [SGhostButton](../SGhostButton)
|
|
66
84
|
- [SIcon](../SIcon)
|
|
67
85
|
- [SPortal](../SPortal)
|
|
86
|
+
- [SSearchInput](../SSearchInput)
|
|
68
87
|
|
|
69
88
|
### Graph
|
|
70
89
|
|
|
71
90
|
```mermaid
|
|
72
91
|
graph TD;
|
|
73
92
|
SSelect --> SField
|
|
74
|
-
SSelect --> SGhostButton
|
|
75
93
|
SSelect --> SIcon
|
|
76
94
|
SSelect --> SPortal
|
|
77
|
-
|
|
95
|
+
SSelect --> SSearchInput
|
|
78
96
|
SKeyValueTable --> SSelect
|
|
79
97
|
STable --> SSelect
|
|
80
98
|
style SSelect fill:#f9f,stroke:#333,stroke-width:4px
|
|
@@ -5,6 +5,7 @@ import { type SIconName } from '../SIcon';
|
|
|
5
5
|
import { type SColor } from '../../lib/color';
|
|
6
6
|
import { type STooltipProps } from '../STooltip';
|
|
7
7
|
import { type SSelectOption, type SSelectType } from './select.config';
|
|
8
|
+
import { type SFieldWidth } from '../../lib/field-width';
|
|
8
9
|
export type { SSelectOption, SSelectType } from './select.config';
|
|
9
10
|
export interface SSelectHandle {
|
|
10
11
|
/** 트리거 버튼에 포커스 (sdFocus) */
|
|
@@ -37,13 +38,18 @@ export interface SSelectProps {
|
|
|
37
38
|
placeholder?: string;
|
|
38
39
|
/** 비활성 */
|
|
39
40
|
disabled?: boolean;
|
|
41
|
+
/**
|
|
42
|
+
* 선택값 지우기(×) 버튼 노출. 선택값이 있고 비활성이 아닐 때만 나타나며,
|
|
43
|
+
* 누르면 드롭다운을 열지 않고 값만 비운다.
|
|
44
|
+
*/
|
|
45
|
+
clearable?: boolean;
|
|
40
46
|
/** 에러 상태 */
|
|
41
47
|
error?: boolean;
|
|
42
48
|
/** 유효성 규칙 — 닫힐 때 자동 검증 */
|
|
43
49
|
rules?: Rule[];
|
|
44
50
|
/** 레이블 툴팁 상세 옵션 */
|
|
45
51
|
labelTooltipProps?: Partial<STooltipProps>;
|
|
46
|
-
/** 드롭다운 최대
|
|
52
|
+
/** 드롭다운 최대 높이. 기본 640px — 창이 이보다 작으면 창 안에 남는 만큼까지만 채워진다 */
|
|
47
53
|
dropdownHeight?: string;
|
|
48
54
|
/** 드롭다운 너비 (없으면 트리거 너비). 창보다 넓게 줘도 창 폭까지만 벌어진다. */
|
|
49
55
|
dropdownWidth?: string;
|
|
@@ -62,7 +68,13 @@ export interface SSelectProps {
|
|
|
62
68
|
addonAlign?: SFieldAddonAlign;
|
|
63
69
|
hint?: string;
|
|
64
70
|
errorMessage?: string;
|
|
65
|
-
|
|
71
|
+
/**
|
|
72
|
+
* 컨트롤 너비 — 폭 등급(`'xs' | 'sm' | 'md' | 'lg' | 'xl'`) · 숫자=px · CSS 길이.
|
|
73
|
+
* 등급은 `--cmp-field-width-*` 토큰으로 풀리므로 토큰이 바뀌면 화면이 따라간다.
|
|
74
|
+
* 값 길이에 상한이 없으면 `"100%"` 로 두어 행 전체를 쓴다.
|
|
75
|
+
* 셀렉트는 `maxLength` 개념이 없어 목록 최장값을 담는 등급으로 고른다.
|
|
76
|
+
*/
|
|
77
|
+
width?: SFieldWidth;
|
|
66
78
|
className?: string;
|
|
67
79
|
style?: CSSProperties;
|
|
68
80
|
}
|
|
@@ -25,3 +25,18 @@
|
|
|
25
25
|
|-------|------|-------------|
|
|
26
26
|
| `onValueChange` | `(value: number) => void` | 크기가 확정될 때. emitImmediately 가 아니면 드래그를 놓는 순간 한 번만 온다 |
|
|
27
27
|
|
|
28
|
+
## Types
|
|
29
|
+
|
|
30
|
+
### SSplitterUnit
|
|
31
|
+
|
|
32
|
+
```ts
|
|
33
|
+
/** 모델·limits 를 읽는 단위. Quasar QSplitter 의 `unit` 과 같다. */
|
|
34
|
+
export type SSplitterUnit = (typeof SSPLITTER_UNITS)[number];
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### SSPLITTER_UNITS
|
|
38
|
+
|
|
39
|
+
```ts
|
|
40
|
+
export const SSPLITTER_UNITS = ['%', 'px'] as const;
|
|
41
|
+
```
|
|
42
|
+
|
|
@@ -30,6 +30,32 @@
|
|
|
30
30
|
| `showItemTooltip` | `() => void` | error 아이템 중 첫 번째에 툴팁을 연다. error 아이템이 없으면 아무 일도 일어나지 않는다. |
|
|
31
31
|
| `hideItemTooltip` | `() => void` | 열려있는 커스텀 툴팁을 닫는다. 활성 단계(value prop)가 바뀌면 별도 호출 없이도 자동으로 닫힌다. |
|
|
32
32
|
|
|
33
|
+
## Types
|
|
34
|
+
|
|
35
|
+
### SStepperItem
|
|
36
|
+
|
|
37
|
+
```ts
|
|
38
|
+
export type SStepperItem = {
|
|
39
|
+
label: string;
|
|
40
|
+
value?: string;
|
|
41
|
+
group?: string;
|
|
42
|
+
completed?: boolean;
|
|
43
|
+
error?: boolean;
|
|
44
|
+
};
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### SStepperSize
|
|
48
|
+
|
|
49
|
+
```ts
|
|
50
|
+
export type SStepperSize = (typeof STEPPER_SIZES)[number];
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### STEPPER_SIZES
|
|
54
|
+
|
|
55
|
+
```ts
|
|
56
|
+
export const STEPPER_SIZES = ['sm', 'lg'] as const;
|
|
57
|
+
```
|
|
58
|
+
|
|
33
59
|
## Dependencies
|
|
34
60
|
|
|
35
61
|
### Depends on
|
|
@@ -22,3 +22,16 @@
|
|
|
22
22
|
|-------|------|-------------|
|
|
23
23
|
| `onValueChange` | `(value: boolean) => void` | 변경 (sdUpdate) |
|
|
24
24
|
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
### Used by
|
|
28
|
+
|
|
29
|
+
- [SKeyValueTable](../SKeyValueTable)
|
|
30
|
+
|
|
31
|
+
### Graph
|
|
32
|
+
|
|
33
|
+
```mermaid
|
|
34
|
+
graph TD;
|
|
35
|
+
SKeyValueTable --> SSwitch
|
|
36
|
+
style SSwitch fill:#f9f,stroke:#333,stroke-width:4px
|
|
37
|
+
```
|
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
# SSystemActionButton
|
|
2
|
+
|
|
3
|
+
> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
|
|
4
|
+
|
|
5
|
+
### SSystemActionButtonAccount
|
|
6
|
+
|
|
7
|
+
#### Props
|
|
8
|
+
|
|
9
|
+
| Prop | Type | Default | Description |
|
|
10
|
+
|------|------|---------|-------------|
|
|
11
|
+
| `type` | `'account'` | — | 계정 행 |
|
|
12
|
+
| `label?` | `string` | — | 라벨 텍스트 |
|
|
13
|
+
| `option` | `SSystemActionButtonAccountOption` | — | 누르면 뜨는 계정 리스트박스. **필수다** — 계정 행은 늘 이 패널의 트리거이고, 눌러도 아무것도 뜨지 않는 계정 행은 없다. 아이콘은 `user` 로 고정이라 여기서 받지 않는다. |
|
|
14
|
+
|
|
15
|
+
### SSystemActionButtonBase
|
|
16
|
+
|
|
17
|
+
#### Props
|
|
18
|
+
|
|
19
|
+
| Prop | Type | Default | Description |
|
|
20
|
+
|------|------|---------|-------------|
|
|
21
|
+
| `color?` | `SSystemActionButtonColor` | — | 색상(놓이는 표면). light = 흰 면, dark = 오션블루 면, darker = 네이비 면. 기본 `'light'` |
|
|
22
|
+
| `disabled?` | `boolean` | — | 비활성 여부. 기본 `false` |
|
|
23
|
+
|
|
24
|
+
### SSystemActionButtonSelect
|
|
25
|
+
|
|
26
|
+
#### Props
|
|
27
|
+
|
|
28
|
+
| Prop | Type | Default | Description |
|
|
29
|
+
|------|------|---------|-------------|
|
|
30
|
+
| `type` | `'select'` | — | 화살표만 붙는 행 |
|
|
31
|
+
| `label?` | `string` | — | 라벨 텍스트 |
|
|
32
|
+
| `option` | `SSystemActionButtonIconOption` | — | 선행 아이콘 |
|
|
33
|
+
|
|
34
|
+
### SSystemActionButtonStatus
|
|
35
|
+
|
|
36
|
+
#### Props
|
|
37
|
+
|
|
38
|
+
| Prop | Type | Default | Description |
|
|
39
|
+
|------|------|---------|-------------|
|
|
40
|
+
| `type` | `'status'` | — | 라벨 자리에 상태 태그가 들어가는 행 |
|
|
41
|
+
| `label?` | `never` | — | 태그가 라벨 자리를 차지하므로 받지 않는다 |
|
|
42
|
+
| `option` | `SSystemActionButtonStatusOption` | — | 상태 태그 + 고를 목록. **필수다** — 상태 행은 늘 그 상태를 바꾸는 메뉴의 트리거다. |
|
|
43
|
+
|
|
44
|
+
### SSystemActionButtonSubSelect
|
|
45
|
+
|
|
46
|
+
#### Props
|
|
47
|
+
|
|
48
|
+
| Prop | Type | Default | Description |
|
|
49
|
+
|------|------|---------|-------------|
|
|
50
|
+
| `type` | `'subSelect'` | — | 우측에 지금 선택된 값이 붙는 행 |
|
|
51
|
+
| `label?` | `string` | — | 라벨 텍스트 |
|
|
52
|
+
| `option` | `SSystemActionButtonSubSelectOption` | — | 선행 아이콘 + 우측 값 + 고를 목록 |
|
|
53
|
+
|
|
54
|
+
### SSystemActionButtonSwitch
|
|
55
|
+
|
|
56
|
+
#### Props
|
|
57
|
+
|
|
58
|
+
| Prop | Type | Default | Description |
|
|
59
|
+
|------|------|---------|-------------|
|
|
60
|
+
| `type` | `'switch'` | — | 우측에 보조 조작 문구가 붙는 행 |
|
|
61
|
+
| `label?` | `string` | — | 라벨 텍스트 |
|
|
62
|
+
| `option` | `SSystemActionButtonTextOption` | — | 선행 아이콘 + 우측 액션 텍스트 |
|
|
63
|
+
|
|
64
|
+
## Types
|
|
65
|
+
|
|
66
|
+
### SSystemActionButtonAccountOption
|
|
67
|
+
|
|
68
|
+
```ts
|
|
69
|
+
/**
|
|
70
|
+
* `account` 타입의 option — 행을 눌렀을 때 뜨는 계정 리스트박스.
|
|
71
|
+
* 내용(이메일·이름·권한·행들)은 `SAccountListBox` 와 같다.
|
|
72
|
+
*
|
|
73
|
+
* **뜨는 자리는 받지 않는다.** 계정 행이 놓인 자리가 정한다 — 판이면 행 위로 · 왼쪽 끝에 맞춰,
|
|
74
|
+
* 전폭 상단바면 행 아래로 · 오른쪽 끝에 맞춰 펼친다(시안). 화면마다 고를 값이 아니라,
|
|
75
|
+
* prop 으로 열면 같은 계정 행이 앱마다 다른 방향으로 뜬다.
|
|
76
|
+
*/
|
|
77
|
+
export interface SSystemActionButtonAccountOption extends SAccountListBoxContent {
|
|
78
|
+
/**
|
|
79
|
+
* 리스트박스 열림 상태를 밖에서 쥔다(controlled). 주지 않으면 버튼이 스스로 여닫는다.
|
|
80
|
+
* 행을 담은 쪽이 닫아야 하는 자리가 있어 열어 둔 통로다 — 리스트박스는 SPortal 로 떠 있어
|
|
81
|
+
* 트리거가 화면에서 빠져도(GNB 를 접으면 메뉴 컬럼이 미끄러져 나간다) 따라 사라지지 않는다.
|
|
82
|
+
*/
|
|
83
|
+
open?: boolean;
|
|
84
|
+
/** 리스트박스 열림/닫힘 변경 */
|
|
85
|
+
onOpenChange?: (open: boolean) => void;
|
|
86
|
+
}
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### SSystemActionButtonColor
|
|
90
|
+
|
|
91
|
+
```ts
|
|
92
|
+
export type SSystemActionButtonColor = (typeof SYSTEM_ACTION_BUTTON_COLORS)[number];
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### SSystemActionButtonIconOption
|
|
96
|
+
|
|
97
|
+
```ts
|
|
98
|
+
/** 선행 아이콘만 받는 타입(`select`)의 option */
|
|
99
|
+
export interface SSystemActionButtonIconOption {
|
|
100
|
+
/** 선행 아이콘명 */
|
|
101
|
+
icon: SIconName;
|
|
102
|
+
}
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### SSystemActionButtonStatusOption
|
|
106
|
+
|
|
107
|
+
```ts
|
|
108
|
+
/**
|
|
109
|
+
* `status` 타입의 option — 라벨 자리에 들어가는 상태 태그 + 고를 목록.
|
|
110
|
+
*
|
|
111
|
+
* `options` 는 **필수다** — 상태 행은 늘 그 상태를 바꾸는 메뉴의 트리거이고, 지금 상태(`value`)에
|
|
112
|
+
* 해당하는 칸의 색·이름이 곧 태그가 된다. 보여주기만 하는 상태 줄이 필요하면 이 버튼이 아니라
|
|
113
|
+
* `STag` 를 쓴다.
|
|
114
|
+
*/
|
|
115
|
+
export interface SSystemActionButtonStatusOption {
|
|
116
|
+
/** 지금 상태. `options` 에서 같은 `value` 를 찾아 그 색·이름으로 태그를 그린다 */
|
|
117
|
+
value?: string;
|
|
118
|
+
/** 고를 수 있는 상태. **필수다** — 이 목록이 행 오른쪽으로 펼쳐진다 */
|
|
119
|
+
options: SSystemActionButtonStatusMenuOption[];
|
|
120
|
+
/** 메뉴에서 상태를 고름. 고르면 메뉴가 닫힌다 */
|
|
121
|
+
onChange?: (value: string) => void;
|
|
122
|
+
}
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
### SSystemActionButtonSubSelectOption
|
|
126
|
+
|
|
127
|
+
```ts
|
|
128
|
+
/**
|
|
129
|
+
* `subSelect` 타입의 option — 지금 값 + 고를 목록.
|
|
130
|
+
*
|
|
131
|
+
* `options` 는 **필수다** — `subSelect` 는 "지금 값이 적혀 있고 눌러서 바꾸는 행"이라, 눌러도
|
|
132
|
+
* 아무것도 뜨지 않으면 그것은 `select`(눌러 들어가는 행)이지 `subSelect` 가 아니다.
|
|
133
|
+
*/
|
|
134
|
+
export interface SSystemActionButtonSubSelectOption extends SSystemActionButtonIconOption {
|
|
135
|
+
/**
|
|
136
|
+
* 지금 값. `options` 에서 같은 `value` 를 찾아 우측에 그 `label` 로 적는다
|
|
137
|
+
* (못 찾으면 `value` 가 그대로 남는다).
|
|
138
|
+
*/
|
|
139
|
+
value?: string;
|
|
140
|
+
/** 고를 수 있는 값. **필수다** — 이 목록이 행 오른쪽으로 펼쳐진다 */
|
|
141
|
+
options: SSystemActionButtonMenuOption[];
|
|
142
|
+
/** 메뉴에서 값을 고름. 고르면 메뉴가 닫힌다 */
|
|
143
|
+
onChange?: (value: string) => void;
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
### SSystemActionButtonTextOption
|
|
148
|
+
|
|
149
|
+
```ts
|
|
150
|
+
/** 우측 액션 텍스트까지 받는 타입(`switch` · `subSelect`)의 option */
|
|
151
|
+
export interface SSystemActionButtonTextOption extends SSystemActionButtonIconOption {
|
|
152
|
+
/** 우측 액션 텍스트 */
|
|
153
|
+
text?: string;
|
|
154
|
+
}
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### SYSTEM_ACTION_BUTTON_COLORS
|
|
158
|
+
|
|
159
|
+
```ts
|
|
160
|
+
/**
|
|
161
|
+
* SSystemActionButton 설정.
|
|
162
|
+
*
|
|
163
|
+
* 토큰은 GNB system 패널 한 벌(`--cmp-gnb-system-*`)을 그대로 쓴다.
|
|
164
|
+
* 행 공통(높이·라운드·아이콘 프레임·라벨) → --cmp-gnb-system-item-*
|
|
165
|
+
* 색(color 축) light / dark / darker → --cmp-gnb-system-item-<color>-*
|
|
166
|
+
* 우측 액션(패딩·간격·아이콘·텍스트색) → --cmp-gnb-system-actionButton-*
|
|
167
|
+
*
|
|
168
|
+
* 타이포그래피는 CSS 변수가 아니라 `.typo-*` 프리셋으로 나온다.
|
|
169
|
+
* item.label → typo-body-sm-semibold (12/600/20)
|
|
170
|
+
* actionButton.switch → typo-field-sm-default (12/400/20)
|
|
171
|
+
* actionButton.selectData → typo-control-xs-medium (12/500/20)
|
|
172
|
+
*/
|
|
173
|
+
|
|
174
|
+
/** 색상(표면). light = 흰 면, dark = 오션블루 면, darker = 네이비 면 */
|
|
175
|
+
export const SYSTEM_ACTION_BUTTON_COLORS = ['light', 'dark', 'darker'] as const;
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
### SSystemActionButtonStatusMenuOption
|
|
179
|
+
|
|
180
|
+
```ts
|
|
181
|
+
/** 상태 메뉴의 한 칸 — 점과 글자가 그 상태의 색으로 함께 물든다 */
|
|
182
|
+
export interface SSystemActionButtonStatusMenuOption extends SSystemActionButtonMenuOption {
|
|
183
|
+
/** 상태 색. 기본 `'blue'` */
|
|
184
|
+
color?: STagColor;
|
|
185
|
+
}
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
### SSystemActionButtonMenuOption
|
|
189
|
+
|
|
190
|
+
```ts
|
|
191
|
+
/** 값 고르기 메뉴의 한 칸 */
|
|
192
|
+
export interface SSystemActionButtonMenuOption {
|
|
193
|
+
/** 값. `option.value` 와 맞춰 지금 값을 가린다 */
|
|
194
|
+
value: string;
|
|
195
|
+
/** 화면에 적히는 이름 */
|
|
196
|
+
label: string;
|
|
197
|
+
}
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
## Dependencies
|
|
201
|
+
|
|
202
|
+
### Used by
|
|
203
|
+
|
|
204
|
+
- [SGnbSystem](../SGnbSystem)
|
|
205
|
+
|
|
206
|
+
### Depends on
|
|
207
|
+
|
|
208
|
+
- [SAccountListBox](../SAccountListBox)
|
|
209
|
+
- [SIcon](../SIcon)
|
|
210
|
+
- [STag](../STag)
|
|
211
|
+
|
|
212
|
+
### Graph
|
|
213
|
+
|
|
214
|
+
```mermaid
|
|
215
|
+
graph TD;
|
|
216
|
+
SSystemActionButton --> SAccountListBox
|
|
217
|
+
SSystemActionButton --> SIcon
|
|
218
|
+
SSystemActionButton --> STag
|
|
219
|
+
SGnbSystem --> SSystemActionButton
|
|
220
|
+
style SSystemActionButton fill:#f9f,stroke:#333,stroke-width:4px
|
|
221
|
+
```
|