sellmate-design-system-react 9.0.0-beta.0 → 9.0.0-beta.10
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 +153 -45
- package/README.md +63 -0
- package/dist/components/SChipFilter/README.md +2 -1
- package/dist/components/SChipFilter/SChipFilter.d.ts +13 -6
- package/dist/components/SCircleProgress/README.md +3 -0
- package/dist/components/SCircleProgress/SCircleProgress.d.ts +7 -1
- package/dist/components/SDatePicker/README.md +41 -3
- package/dist/components/SDatePicker/SDatePicker.d.ts +36 -3
- package/dist/components/SDatePicker/index.d.ts +1 -1
- package/dist/components/SField/README.md +3 -0
- package/dist/components/SField/SField.d.ts +12 -0
- package/dist/components/SGhostButton/README.md +2 -0
- package/dist/components/SGnb/gnb.config.d.ts +2 -0
- package/dist/components/SIcon/README.md +4 -0
- package/dist/components/SImage/README.md +44 -0
- package/dist/components/SImage/SImage.d.ts +41 -0
- package/dist/components/SImage/index.d.ts +1 -0
- package/dist/components/SKeyValueTable/README.md +1 -0
- package/dist/components/SKeyValueTable/SKeyValueTable.d.ts +8 -1
- package/dist/components/SList/README.md +0 -1
- package/dist/components/SList/SList.d.ts +0 -2
- package/dist/components/SPage/README.md +2 -0
- package/dist/components/SPage/SPage.d.ts +17 -1
- package/dist/components/SPage/index.d.ts +1 -1
- package/dist/components/SPage/page.config.d.ts +8 -0
- package/dist/components/SSearchInput/README.md +48 -0
- package/dist/components/SSearchInput/SSearchInput.d.ts +46 -0
- package/dist/components/SSearchInput/index.d.ts +1 -0
- package/dist/components/SSectionHeaderCard/README.md +10 -23
- package/dist/components/SSectionHeaderCard/SSectionHeaderCard.d.ts +21 -14
- package/dist/components/SSectionHeaderCard/index.d.ts +1 -1
- package/dist/components/SSelect/README.md +2 -0
- package/dist/components/STable/README.md +1 -0
- package/dist/components/STable/STable.d.ts +20 -0
- package/dist/components/STabs/README.md +0 -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/STimePicker/timepicker.config.d.ts +5 -0
- package/dist/components/SToggle/README.md +1 -0
- package/dist/components/SToggle/SToggle.d.ts +4 -1
- package/dist/components/STree/README.md +3 -0
- package/dist/components/STree/STree.d.ts +8 -0
- package/dist/components/STree/index.d.ts +1 -1
- package/dist/index.cjs +1545 -359
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.js +1540 -360
- package/dist/index.js.map +1 -1
- package/dist/lib/truncated-value-tooltip.d.ts +18 -0
- package/dist/llms-full.txt +300 -69
- package/dist/llms.txt +157 -48
- package/dist/styles.css +201 -32
- package/dist/theme.css +34 -11
- package/eslint/index.mjs +5 -0
- package/eslint/rules/field-width-grade.d.mts +41 -0
- package/eslint/rules/field-width-grade.mjs +294 -0
- package/eslint/scale.gen.mjs +1 -1
- package/package.json +1 -1
package/dist/llms-full.txt
CHANGED
|
@@ -35,12 +35,12 @@
|
|
|
35
35
|
| 분류 | 컴포넌트 |
|
|
36
36
|
| --- | --- |
|
|
37
37
|
| **버튼·링크** | `SButton` `SGhostButton` `SDropdownButton` `STextLink` `SSwitch` `SToggle` |
|
|
38
|
-
| **입력 (폼)** | `SForm` `SField` `SInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
|
|
39
|
-
| **날짜·시간** | `SCalendar` `SDatePicker` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
|
|
38
|
+
| **입력 (폼)** | `SForm` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
|
|
39
|
+
| **날짜·시간** | `SCalendar` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
|
|
40
40
|
| **표·목록** | `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SListItem` `SExpansionList` `SDraggableList` `SDraggableItem` `STree` |
|
|
41
41
|
| **레이아웃** | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) `SSectionHeaderCard` `SCard` `SDivider` `SSplitter` `SScrollArea` `SExpansionItem` |
|
|
42
42
|
| **내비게이션** | `STabs` `SPagination` `SStepper` |
|
|
43
|
-
| **표시·상태** | `STag` `SBadge` `SIcon` `SCallout` `SGuide` |
|
|
43
|
+
| **표시·상태** | `STag` `SBadge` `SIcon` `SImage` `SCallout` `SGuide` |
|
|
44
44
|
| **진행·로딩** | `SLinearProgress` `SCircleProgress` `SLoadingContainer` `SLoadingModal` |
|
|
45
45
|
| **오버레이** | `STooltip` `SPopover` `SPopup` `SDrawer` `SPortal` |
|
|
46
46
|
| **모달** | `SModal.confirm()` `SModal.create()` + `SActionModal` `SConfirmModal` `SModalOutlet`(앱 루트 1회) |
|
|
@@ -68,6 +68,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
|
|
|
68
68
|
| --- | --- |
|
|
69
69
|
| `<button>` | `SButton`, `SGhostButton`, `SDropdownButton`, `STextLink` |
|
|
70
70
|
| `<input type="text/password/...">` | `SInput` |
|
|
71
|
+
| `<input type="search">` | `SSearchInput` |
|
|
71
72
|
| `<input type="number">` | `SNumberInput` |
|
|
72
73
|
| `<input type="checkbox">` | `SCheckbox`, `SToggle`, `SSwitch` |
|
|
73
74
|
| `<input type="radio">` | `SRadio`, `SRadioButton` |
|
|
@@ -80,7 +81,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
|
|
|
80
81
|
| `alert()`, `confirm()` | `SToast`, `SModal.confirm(...)` |
|
|
81
82
|
| 직접 만든 탭/페이지네이션/스텝퍼 | `STabs`, `SPagination`, `SStepper` |
|
|
82
83
|
| `<ul>`/`<li>` 로 만든 목록 UI | `SList` + `SListItem` (드래그 정렬은 `SDraggableItem`) |
|
|
83
|
-
| 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard`
|
|
84
|
+
| 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard` 의 `title` / `padding` props |
|
|
84
85
|
| `<svg>` 직접 삽입, 이모지 아이콘 | `SIcon` |
|
|
85
86
|
| `<hr>` | `SDivider` |
|
|
86
87
|
| `<details>` / `<summary>` | `SExpansionItem` |
|
|
@@ -146,7 +147,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
146
147
|
| --- | --- | --- |
|
|
147
148
|
| **셸** | 앱 전체 뼈대. 페이지가 바뀌어도 남는다 | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) |
|
|
148
149
|
| **블록** | `SPage` 의 직계 자식. 페이지를 세로로 쌓는 단위 | `SSectionHeaderCard` `SCard` `SForm` `SSplitter` `SScrollArea` `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SExpansionList` `SDraggableList` `STree` `SCallout` `STabs` `SStepper` `SPagination` `SDivider` |
|
|
149
|
-
| **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `SButton` `SGhostButton` `SDropdownButton` `SField` `SInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SSwitch` `SToggle` `SChipInput` `SBarcodeInput` `SFilePicker` `SDatePicker` `SDateRangePicker` `STimePicker` `STimeRangePicker` `SCalendar` `SListItem` `SExpansionItem` `SDraggableItem` `SLinearProgress` `SCircleProgress` |
|
|
150
|
+
| **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `SButton` `SGhostButton` `SDropdownButton` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SSwitch` `SToggle` `SChipInput` `SBarcodeInput` `SFilePicker` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` `SCalendar` `SListItem` `SExpansionItem` `SDraggableItem` `SImage` `SLinearProgress` `SCircleProgress` |
|
|
150
151
|
| **인라인** | 텍스트 흐름·셀·라벨 안에 섞인다. 혼자 블록이 되지 않는다 | `STag` `SBadge` `SIcon` `STextLink` `SChip` |
|
|
151
152
|
| **레이어** | 문서 흐름 **밖**에 떠서 그려진다. 어느 층에서 띄우든 레이아웃에 영향이 없다 | `SModal` `SActionModal` `SConfirmModal` `SPopup` `SDrawer` `SPopover` `STooltip` `SPortal` `SToast` `SLoadingModal` `SLoadingContainer` `SGuide` |
|
|
152
153
|
|
|
@@ -166,7 +167,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
166
167
|
| 담는 것 | 올 수 있는 것 | 오면 안 되는 것 |
|
|
167
168
|
| --- | --- | --- |
|
|
168
169
|
| `SPage` | **블록만** | **요소를 직접** — 버튼 하나도 블록에 담아 놓는다 |
|
|
169
|
-
| `SSectionHeaderCard
|
|
170
|
+
| `SSectionHeaderCard` 의 `children` | 그리는 블록 · 요소 | `SSectionHeaderCard` · `SCard` (카드 겹침, §3-7-8) |
|
|
170
171
|
| `SCard` | 그리는 블록 · 요소 | `SCard` · `SSectionHeaderCard` |
|
|
171
172
|
| `SForm` | 블록 (보통 `SKeyValueTable` + 하단 액션) | — |
|
|
172
173
|
| `SSplitter.Before` / `.After` | 블록 | — |
|
|
@@ -230,7 +231,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
230
231
|
|
|
231
232
|
페이지 제목만 18px 로 크게 두고 그 아래는 14 / 12 로 촘촘하게 간다. 중간 크기(16px)는 기본 골격에서 쓰지 않는다.
|
|
232
233
|
|
|
233
|
-
- **페이지·섹션 제목의 타이포를 직접 주지 않는다.** `SPage` 의 `header.title`, `SSectionHeaderCard
|
|
234
|
+
- **페이지·섹션 제목의 타이포를 직접 주지 않는다.** `SPage` 의 `header.title`, `SSectionHeaderCard` 의 `header.title` 이 이미 넣는다 — 그 위에 `typo-heading-lg`/`typo-heading-sm` 을 또 씌우지 않는다.
|
|
234
235
|
- **하위 제목이 필요하면 먼저 섹션을 나눌 수 없는지 본다.** 한 섹션 안에서 제목이 두 단으로 갈린다는 것은 대개 섹션이 둘이라는 뜻이다 (§3-7-8).
|
|
235
236
|
- 본문 안에서 한 단어를 강조할 때는 `typo-body-sm-medium` 을 쓴다. `typo-body-sm-bold` 는 제목 성격의 짧은 라벨에만 쓴다. <!-- TODO(디자인): 강조 굵기 기준 확정 -->
|
|
236
237
|
|
|
@@ -300,7 +301,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
300
301
|
|
|
301
302
|
**페이지 프레임은 예외 없이 `SPage` 가 넣는다.** 아래 규칙은 그 안의 **섹션·패널 레벨에만** 적용된다.
|
|
302
303
|
|
|
303
|
-
**컴포넌트가 자체 여백을 가지면 컴포넌트 기준이 우선한다.** `SKeyValueTable`·`STable` 처럼 자기 여백을 토큰으로 갖고 있는 컴포넌트에는 이 판정을 적용하지 않는다 — 손댈 것이 없다. 아래 판정이 필요한 자리는 **직접 만든 컨테이너**와 **`SSectionHeaderCard
|
|
304
|
+
**컴포넌트가 자체 여백을 가지면 컴포넌트 기준이 우선한다.** `SKeyValueTable`·`STable` 처럼 자기 여백을 토큰으로 갖고 있는 컴포넌트에는 이 판정을 적용하지 않는다 — 손댈 것이 없다. 아래 판정이 필요한 자리는 **직접 만든 컨테이너**와 **`SSectionHeaderCard` 의 `padding`** 두 곳뿐이다.
|
|
304
305
|
|
|
305
306
|
판정은 **그 영역이 담고 있는 콘텐츠 덩어리의 종류 수**로 한다.
|
|
306
307
|
|
|
@@ -335,14 +336,47 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
335
336
|
|
|
336
337
|
**중첩되면 안쪽 여백을 주지 않는다.** 24 영역 안에 또 여백을 주면 가장자리가 40 으로 벌어져 한 면적처럼 읽힌다. 안쪽 카드·목록이 **배경색이 다르거나 테두리가 있어** 경계가 스스로 보이는 경우에만 자기 여백을 유지한다.
|
|
337
338
|
|
|
338
|
-
`SSectionHeaderCard
|
|
339
|
+
`SSectionHeaderCard` 는 이 규칙을 **`padding` prop 으로 받는다** — 직접 `p-sd-*` 를 주지 않는다.
|
|
339
340
|
|
|
340
341
|
```tsx
|
|
341
|
-
<SSectionHeaderCard
|
|
342
|
-
<SSectionHeaderCard
|
|
343
|
-
<SSectionHeaderCard
|
|
342
|
+
<SSectionHeaderCard title="기본 정보">…</SSectionHeaderCard> {/* 기본 = 16 */}
|
|
343
|
+
<SSectionHeaderCard title="기본 정보" padding="wide">…</SSectionHeaderCard> {/* 3종류 이상 */}
|
|
344
|
+
<SSectionHeaderCard title="기본 정보" padding="none">…</SSectionHeaderCard> {/* 표를 가장자리까지 */}
|
|
344
345
|
```
|
|
345
346
|
|
|
347
|
+
##### 카드 가장자리까지 채우는 표는 자기 테두리를 끈다
|
|
348
|
+
|
|
349
|
+
여기서 "표"는 **`STable` 과 `SKeyValueTable` 둘 다**다. 두 컴포넌트 모두 자기 바깥 테두리를 그리는데, 카드도 바깥 테두리를 그린다. `padding="none"` 으로 붙이면 **1px 두 개가 나란히 놓여 그 변만 2px** 로 보인다(카드의 다른 변은 1px 그대로라 굵기가 어긋난다).
|
|
350
|
+
|
|
351
|
+
```tsx
|
|
352
|
+
<SSectionHeaderCard title="발주 내역" padding="none">
|
|
353
|
+
<SKeyValueTable fields={…} bordered={false} radius="useTop" />
|
|
354
|
+
<STable columns={…} rows={…} bordered={false} radius="useTop" />
|
|
355
|
+
</SSectionHeaderCard>
|
|
356
|
+
```
|
|
357
|
+
|
|
358
|
+
- **`bordered={false}`** 로 표의 테두리를 끈다. 카드가 이미 그린다.
|
|
359
|
+
- **`radius="useTop"`** 으로 위쪽 모서리를 죽인다. 아래쪽 라운드는 카드가 처리한다.
|
|
360
|
+
- `STable` 은 **페이지네이션 바의 테두리와 `-mt-px` 겹침도 함께 꺼진다** — 본문 테두리가 없으면 겹칠 대상이 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다.
|
|
361
|
+
|
|
362
|
+
#### 본문 바탕 눌러앉히기 (선택)
|
|
363
|
+
|
|
364
|
+
`SSectionHeaderCard` 는 **`background="neutral"`** 로 본문 바탕을 한 단계 눌러앉힐 수 있다. 흰 면 덩어리(표·리스트)가 여럿일 때 그 덩어리들이 **"면 위에 놓인 객체"로 읽혀 묶음이 더 강하게 보인다.**
|
|
365
|
+
|
|
366
|
+
```tsx
|
|
367
|
+
<SSectionHeaderCard title="발주 상세" background="neutral">…흰 면 표 여럿…</SSectionHeaderCard>
|
|
368
|
+
```
|
|
369
|
+
|
|
370
|
+
**기본값(`frame`, 흰 면)이 틀린 것이 아니다.** 이 저장소의 표·리스트는 테두리·라운드·헤더 줄과 `gap-sd-12` 를 이미 갖고 있어 흰 바탕에서도 경계가 읽힌다. 위계를 한 단계 더 주고 싶을 때 고르는 수단이지, 덩어리가 둘 이상이면 반드시 깔아야 하는 규칙이 아니다.
|
|
371
|
+
|
|
372
|
+
깔아도 **효과가 없는** 자리는 있다.
|
|
373
|
+
|
|
374
|
+
- **덩어리가 가장자리까지 차는 경우** — `padding="none"` 으로 표를 채우면 깐 바탕이 표에 완전히 가려 보이지 않는다.
|
|
375
|
+
- **덩어리에 회색 면이 섞인 경우** — 그 덩어리가 바탕과 같은 색이 되어 묻힌다.
|
|
376
|
+
- **맨 텍스트·폼 컨트롤만 있는 본문** — 떠오를 흰 면이 없다.
|
|
377
|
+
|
|
378
|
+
바탕을 깐 경우, 표 사이 구분선(`SDivider`)은 대개 불필요해진다 — 색이 이미 경계를 만든다.
|
|
379
|
+
|
|
346
380
|
#### 스크롤 영역의 하단 여백
|
|
347
381
|
|
|
348
382
|
스크롤을 끝까지 내렸을 때 마지막 항목이 화면 경계에 붙으면 **목록이 끝난 것인지 더 있는 것인지** 읽히지 않는다. 그래서 스크롤 영역은 **하단만** 넓게 둔다. 나머지 세 방향은 위 16 / 24 규칙 그대로다.
|
|
@@ -352,7 +386,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
352
386
|
| **패널 자체 스크롤** (좌측 목록, 중앙 대화 등) | 그 패널 안쪽 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` — `SPage` 와 같은 토큰이라 값이 바뀌어도 함께 따라간다 |
|
|
353
387
|
| **페이지 단위 스크롤** | **`SPage` 가 넣는다. 직접 주지 않는다** |
|
|
354
388
|
|
|
355
|
-
`SPage` 는 기본으로 넣으므로 **아무것도 하지 않으면 맞다.**
|
|
389
|
+
`SPage` 는 기본으로 넣으므로 **아무것도 하지 않으면 맞다.** 직접 끌 일은 없다 — **페이지네이션이 붙은 테이블**은 `contentHeight="fill"` 을 쓰고, 이 모드에서는 페이지가 스크롤하지 않아 스크롤 끝 여백이 **자동으로 무시**된다 (§4-2 목록 페이지).
|
|
356
390
|
|
|
357
391
|
### 2-3. 색상
|
|
358
392
|
|
|
@@ -414,6 +448,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
414
448
|
| --- | --- | --- |
|
|
415
449
|
| 한 줄 텍스트를 받는다 | `SInput` | §3-7-1 |
|
|
416
450
|
| 여러 줄 텍스트를 받는다 | `STextarea` | §3-7-1 |
|
|
451
|
+
| 목록·결과를 검색어로 좁힌다 | `SSearchInput` | §3-7-1 |
|
|
417
452
|
| 숫자(수량·금액)를 받는다 | `SNumberInput` | |
|
|
418
453
|
| 바코드를 스캔해 받는다 | `SBarcodeInput` | |
|
|
419
454
|
| 목록에서 하나 고르게 한다 | `SSelect` | §3-7-2 |
|
|
@@ -427,6 +462,8 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
427
462
|
| 입력된 값 하나를 지우거나 고치게 한다 | `SChip` | §3-1 |
|
|
428
463
|
| 파일을 받는다 | `SFilePicker` | |
|
|
429
464
|
| 날짜 하나를 받는다 | `SDatePicker` | §3-7-4 |
|
|
465
|
+
| 연도 선택 리스트만 커스텀 조합에 넣는다 | `SDatePickerYearListbox` | §3-7-4 |
|
|
466
|
+
| 연도+월 선택 리스트만 커스텀 조합에 넣는다 | `SDatePickerMonthListbox` | §3-7-4 |
|
|
430
467
|
| 날짜 기간을 받는다 | `SDateRangePicker` | §3-7-4 |
|
|
431
468
|
| 시각 하나를 받는다 | `STimePicker` | |
|
|
432
469
|
| 시각 범위를 받는다 | `STimeRangePicker` | |
|
|
@@ -450,6 +487,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
450
487
|
| 상태·분류를 라벨로 찍는다 | `STag` | §3-1 |
|
|
451
488
|
| 색 점만으로 상태를 찍는다 | `SBadge` | §3-1 |
|
|
452
489
|
| 아이콘을 넣는다 | `SIcon` | |
|
|
490
|
+
| 사진·썸네일을 보여준다 (로딩·실패 상태 포함) | `SImage` | §3-7-12 |
|
|
453
491
|
| 문장 안에서 다른 화면으로 보낸다 | `STextLink` | §3-5-6 |
|
|
454
492
|
|
|
455
493
|
#### C. 동작을 실행시킨다
|
|
@@ -557,9 +595,26 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
557
595
|
| | 무엇인가 | 크기 |
|
|
558
596
|
| --- | --- | --- |
|
|
559
597
|
| **SPopup** | **별도 브라우저 창** (`window.open` 으로 여는 전용 라우트) | 창 크기 = 콘텐츠 크기 |
|
|
560
|
-
| **SActionModal** | 같은 창 위 오버레이 카드 | `width`
|
|
598
|
+
| **SActionModal** | 같은 창 위 오버레이 카드 | `width` prop. **높이는 주지 않는다** (아래) |
|
|
561
599
|
| **SModal.confirm** (`SConfirmModal`) | 같은 창 위 확인창 | 고정 |
|
|
562
600
|
|
|
601
|
+
##### 모달 높이는 내용이 정하고, 상한은 시스템이 건다
|
|
602
|
+
|
|
603
|
+
**`height` 를 주지 않는다.** 높이는 내용이 정하고, 카드는 **뷰포트의 85%** 에서 멈춘다(시스템이 모든 모달에 건다). 데이터가 적으면 내용만큼 작아지고, 많으면 85% 에서 멈춘다.
|
|
604
|
+
|
|
605
|
+
가로는 좌우 24px 씩을 뺀 값으로 클램핑하는데 **세로만 비율**인 이유는, 모달이 화면을 거의 다 덮으면 뒤 맥락이 사라져 "떠 있는 것"으로 읽히지 않기 때문이다.
|
|
606
|
+
|
|
607
|
+
**상한에 닿았을 때 스크롤되어야 하는 것은 모달 본문이 아니라 표다.**
|
|
608
|
+
|
|
609
|
+
```tsx
|
|
610
|
+
<SActionModal modalTitle="발주 검토" button={{ label: '확정', onClick: submit }}>
|
|
611
|
+
{/* 표가 남은 높이를 먹고 자기 안에서 스크롤한다 — 헤더·합계·푸터는 늘 보인다 */}
|
|
612
|
+
<STable className="min-h-0 flex-1" columns={columns} rows={rows} />
|
|
613
|
+
</SActionModal>
|
|
614
|
+
```
|
|
615
|
+
|
|
616
|
+
본문(`overflow-auto` 영역)이 통째로 스크롤되면 표 헤더와 합계 줄이 위로 밀려 사라진다. `SActionModal` 의 본문은 이미 `min-h-0 flex-1` 이므로, 표에 `min-h-0 flex-1` 을 주면 세로 축이 이어져 표만 스크롤한다 (§4-2 목록 페이지와 같은 사슬이다).
|
|
617
|
+
|
|
563
618
|
**성격이 먼저 둘로 갈린다.**
|
|
564
619
|
|
|
565
620
|
| 성격 | 정의 | 컴포넌트 |
|
|
@@ -747,6 +802,7 @@ const columns: STableColumn[] = [
|
|
|
747
802
|
|
|
748
803
|
컬럼 폭은 `width` 로 **고정**되고, `<td>` 는 그 폭을 넘는 내용을 잘라낸다(`overflow: hidden`). 텍스트라면 말줄임으로 끝나지만, 셀에 `STag` · `SButton` · `SGhostButton` · `SSelect` · `SInput` · `SNumberInput` 처럼 **자기 폭을 가진 요소**를 넣으면 요소 자체가 잘려 **누르거나 읽거나 입력할 수 없게 된다.** `width` 를 생략해도 내용에 맞춰 늘어나지 않고 `STable` 의 기본 폭이 될 뿐이므로, 컨트롤이 들어가는 컬럼은 폭을 직접 판단해서 준다.
|
|
749
804
|
|
|
805
|
+
- **컨트롤이 들어가는 컬럼에는 `contentType: 'control'` 을 함께 준다.** 좌우 패딩이 텍스트용(넓게)에서 컨트롤용(좁게)으로 바뀌어, 같은 컬럼 폭에서도 요소가 쓸 폭이 넓어진다. 기본값은 `text` 다.
|
|
750
806
|
- 기준은 **요소가 온전히 보이는 폭 + 셀 좌우 패딩**이다. 좌우 패딩은 `STable` 이 토큰으로 넣으므로(직접 주지 않는다) 그만큼을 뺀 나머지가 요소 몫이라는 점을 계산에 넣는다.
|
|
751
807
|
- 요소가 둘 이상이면 요소 폭의 합에 **`gap` 까지** 더한다 (행 내부 인라인 액션 간격은 `gap-sd-4` 고정, §3-5-5).
|
|
752
808
|
- 값에 따라 폭이 달라지는 요소(`STag` 라벨, 라벨 있는 버튼)는 **가장 긴 값** 기준으로 잡는다. `판매중` 에 맞춰두면 `판매중지 요청` 에서 잘린다.
|
|
@@ -754,6 +810,13 @@ const columns: STableColumn[] = [
|
|
|
754
810
|
- 폭을 넉넉히 줄 수 없는 자리는 폭을 줄이는 게 아니라 **요소를 바꾼다** — 라벨 버튼 대신 아이콘만 있는 `SGhostButton`, `size="xs"` (§3-5-2, §3-5-5).
|
|
755
811
|
- **`autoWidth` 는 해법이 아니다.** 내용에 맞춰 늘어나는 게 아니라 고정폭 컬럼들이 가져가고 **남은 폭을 나눠 갖는 것**이라, 테이블이 좁으면 역시 잘린다. 컨트롤 컬럼은 `width` 로 직접 확보한다.
|
|
756
812
|
|
|
813
|
+
```tsx
|
|
814
|
+
{ name: 'normal', label: '정상', field: 'normal', width: '96px',
|
|
815
|
+
align: 'center', contentType: 'control', render: row => <SNumberInput … /> },
|
|
816
|
+
```
|
|
817
|
+
|
|
818
|
+
**셀 좌우 여백은 내용이 정한다.** 텍스트는 넓게, 컨트롤은 좁게다 — `SKeyValueTable` 은 `field.type` 으로 이 판정을 스스로 하지만, `STable` 의 셀은 소비 앱이 넘긴 임의의 `render` 결과라 컴포넌트가 알 수 없다. 그래서 `contentType` 으로 알려준다. 여백 값 자체는 토큰이 정하므로 `tdClass` 로 패딩을 직접 덮어쓰지 않는다.
|
|
819
|
+
|
|
757
820
|
**`resizable` 테이블이면 `minWidth` 를 함께 준다.** resize 하한 기본값은 어떤 컨트롤도 담지 못할 만큼 작아, 사용자가 끝까지 끌면 그대로 잘린다. `width` 를 정한 근거와 같은 값을 하한으로 둔다 — 텍스트 컬럼과 달리 여기서는 더 줄일 여지가 없다.
|
|
758
821
|
|
|
759
822
|
```tsx
|
|
@@ -966,16 +1029,19 @@ const columns: STableColumn[] = [
|
|
|
966
1029
|
|
|
967
1030
|
> §3-0 라우팅에서 이 절을 가리키는 자리들이다. <!-- TODO(디자인): 전체 검수·확정 -->
|
|
968
1031
|
|
|
969
|
-
#### 3-7-1. SInput vs STextarea
|
|
1032
|
+
#### 3-7-1. SInput vs STextarea vs SSearchInput
|
|
970
1033
|
|
|
971
|
-
|
|
1034
|
+
**먼저 "그 값이 저장되는가"를 본다.** 저장되면 폼 필드(`SInput`·`STextarea`), 화면을 좁히기만 하고 사라지면 `SSearchInput` 이다.
|
|
972
1035
|
|
|
973
1036
|
| 값 | 사용 |
|
|
974
1037
|
| --- | --- |
|
|
975
1038
|
| 이름·코드·전화번호·URL 처럼 형식이 정해진 값 | `SInput` |
|
|
976
1039
|
| 메모·사유·설명처럼 길이가 예측되지 않는 문장 | `STextarea` |
|
|
1040
|
+
| 지금 보이는 목록·결과를 좁히는 검색어 | `SSearchInput` |
|
|
1041
|
+
|
|
1042
|
+
폼 필드 둘은 **줄 수가 아니라 값의 성격으로** 갈린다. 값이 길어질 수 있는데 `SInput` 을 쓰면 사용자가 자기가 쓴 것을 다시 읽지 못한다 — 한 줄 안에서 좌우로 스크롤해야 하기 때문이다. 반대로 짧은 값에 `STextarea` 를 쓰면 빈 공간이 남아 입력량을 잘못 기대하게 한다.
|
|
977
1043
|
|
|
978
|
-
|
|
1044
|
+
`SSearchInput` 은 폼 필드가 아니다 — 라벨·힌트·유효성 규칙·에러 메시지를 받지 않고, `SForm` 의 제출 검증 대상에도 들어가지 않는다. 돋보기 아이콘이 항상 앞에 붙어 "여기는 검색"임을 스스로 밝히므로 라벨을 따로 붙이지 않는다. 검색 실행은 `onSearch`(Enter) 로 받고, 값이 바뀔 때마다 좁히는 실시간 필터라면 `onValueChange` 만 쓴다. 반대로 검색어를 **저장하거나 검증해야 한다면** 그것은 폼 값이므로 `SInput` 이다.
|
|
979
1045
|
|
|
980
1046
|
#### 3-7-2. 하나를 고르게 하는 다섯 — SSelect vs SRadioGroup vs SRadioButton vs STabs vs SRadio
|
|
981
1047
|
|
|
@@ -1012,11 +1078,25 @@ const columns: STableColumn[] = [
|
|
|
1012
1078
|
| 판별 | 사용 |
|
|
1013
1079
|
| --- | --- |
|
|
1014
1080
|
| 날짜 **하나**를 값으로 받는다 | `SDatePicker` |
|
|
1081
|
+
| 연도 선택 리스트만 필요하다 (트리거·팝오버는 직접 조합) | `SDatePickerYearListbox` |
|
|
1082
|
+
| 연도+월 선택 리스트만 필요하다 (트리거·팝오버는 직접 조합) | `SDatePickerMonthListbox` |
|
|
1015
1083
|
| **시작~종료** 를 값으로 받는다 | `SDateRangePicker` |
|
|
1016
1084
|
| 달력 격자 **자체가 화면 콘텐츠** 다 (일정·이벤트 보기) | `SCalendar` |
|
|
1017
1085
|
|
|
1018
1086
|
- **기간을 `SDatePicker` 두 개로 만들지 않는다.** 시작이 종료보다 뒤인 입력을 막는 검증과 한쪽만 고른 중간 상태 처리가 `SDateRangePicker` 안에 이미 있다. 두 개로 쪼개면 그게 전부 앱 몫이 된다.
|
|
1019
1087
|
- `SDatePicker`·`SDateRangePicker` 는 내부적으로 `SCalendar` 를 팝오버로 띄운다. 값을 받는 자리에 `SCalendar` 를 직접 쓰지 않는다.
|
|
1088
|
+
- `SDatePickerYearListbox`·`SDatePickerMonthListbox` 는 `SDatePicker` 의 mode listbox 조각만 떼어낸 컴포넌트다. 일반 폼 입력에는 `SDatePicker mode="year" | "month"` 를 우선 쓰고, 다른 트리거·팝오버 안에 리스트만 끼워 넣을 때만 직접 쓴다.
|
|
1089
|
+
|
|
1090
|
+
**날짜·시간 피커는 폭 상한을 스스로 갖는다 — `width` 를 주지 않는다.** 값 길이가 `YYYY-MM-DD` 처럼 정해져 있어 컴포넌트가 사이즈별 상한을 안다. `SKeyValueTable` 이 모든 컨트롤에 `width="100%"` 를 넘기지만, 이 상한 덕분에 행 전체로 늘어나지 않고 제 폭에서 멈춘다.
|
|
1091
|
+
|
|
1092
|
+
| 컴포넌트 | `size="sm"` | `size="md"` |
|
|
1093
|
+
| --- | --- | --- |
|
|
1094
|
+
| `SDatePicker` | md | lg |
|
|
1095
|
+
| `SDateRangePicker` | lg | xl |
|
|
1096
|
+
| `STimePicker` | md | lg |
|
|
1097
|
+
| `STimeRangePicker` | md | lg (오전/오후 표시는 두 사이즈 모두 lg) |
|
|
1098
|
+
|
|
1099
|
+
`SDateRangePicker` 가 한 등급씩 위인 것은 값이 `YYYY-MM-DD ~ YYYY-MM-DD` 로 두 배가 넘기 때문이다. 같은 이유로 `STimeRangePicker` 의 오전/오후 모드도 sm 에서 한 등급 위를 쓴다 — 그 모드의 최소 폭이 md 등급을 이미 넘어, 그대로 두면 하한이 상한을 넘어 상한이 무력해진다.
|
|
1020
1100
|
|
|
1021
1101
|
#### 3-7-5. SField 를 직접 쓰는 경우
|
|
1022
1102
|
|
|
@@ -1064,7 +1144,7 @@ const columns: STableColumn[] = [
|
|
|
1064
1144
|
|
|
1065
1145
|
- 페이지 골격에서 콘텐츠를 묶는 섹션은 **사실상 전부 `SSectionHeaderCard`** 다 (§4-4·§4-5). 제목·필수 표시·도움말·헤더 우측 액션이 전부 여기 붙는다.
|
|
1066
1146
|
- **카드 안에 카드를 겹치지 않는다.** 섹션 안을 더 나눠야 하면 `SDivider` 로 끊거나(§3-6) 섹션을 둘로 분리한다.
|
|
1067
|
-
- 안쪽 여백은 `SSectionHeaderCard
|
|
1147
|
+
- 안쪽 여백은 `SSectionHeaderCard` 의 `padding` prop 으로 준다 — `p-sd-*` 를 직접 주지 않는다 (§2-2).
|
|
1068
1148
|
|
|
1069
1149
|
#### 3-7-9. SLinearProgress vs SCircleProgress
|
|
1070
1150
|
|
|
@@ -1093,6 +1173,23 @@ const columns: STableColumn[] = [
|
|
|
1093
1173
|
- 검색 실행 시점이 다르다 — `SKeyValueTable` 필터는 앱이 검색 버튼을 직접 놓지만, `SChipFilter` 는 편집 팝오버가 닫히거나 "검색" 을 누를 때 `onSearch` 가 값 맵과 함께 호출된다. 값이 바뀌지 않았으면 호출되지 않는다.
|
|
1094
1174
|
- 함께 걸어야 하는 조건(예: 기간 중 하나는 필수)이 있으면 `fields` 를 그룹으로 넘긴다. 규칙을 못 채운 동안 경고 툴팁이 떠 있고 `onSearch` 가 막힌다.
|
|
1095
1175
|
|
|
1176
|
+
#### 3-7-12. 이미지 — SImage
|
|
1177
|
+
|
|
1178
|
+
사진·썸네일은 `<img>` 를 직접 쓰지 않고 `SImage` 를 쓴다. **로딩·실패 상태를 컴포넌트가 이미 처리하기 때문이다.**
|
|
1179
|
+
|
|
1180
|
+
- **로딩 스피너와 실패 표시를 앱이 만들지 않는다.** `src` 가 없거나 로드에 실패하면 빈 이미지 아이콘이, 로딩 중에는 스피너가 자동으로 놓인다. 크기는 상자 높이에 비례하므로 썸네일이든 큰 미리보기든 따로 맞출 것이 없다.
|
|
1181
|
+
- **크기는 `ratio` 와 너비로 준다.** `ratio` 기본값이 `1`(정사각형)이라 너비만 주면 정사각형이 된다. `className`/`style` 로 높이를 직접 주면 그쪽이 이기고 `ratio` 는 무시된다.
|
|
1182
|
+
- 상자를 채우는 방식은 `fit`(기본 `cover`), 붙는 위치는 `position` 이다. 안쪽 `<img>` 에 네이티브 속성이 필요하면 `imgProps` 로 넘긴다 — 목록에서 고스트 드래그를 막는 `imgProps={{ draggable: false }}` 가 대표적이다.
|
|
1183
|
+
- 썸네일이 많은 목록에서는 `loadingShowDelay` 를 준다. 캐시된 이미지가 즉시 로드될 때 스피너가 한 프레임 번쩍이는 것을 막는다.
|
|
1184
|
+
|
|
1185
|
+
```tsx
|
|
1186
|
+
✅ <SImage src={item.thumbnailUrl} alt={item.name} style={{ width: 64 }} /> {/* 정사각 썸네일 */}
|
|
1187
|
+
✅ <SImage src={banner} ratio={16 / 9} className="w-full" /> {/* 가로형 배너 */}
|
|
1188
|
+
|
|
1189
|
+
❌ <img src={item.thumbnailUrl} /> {/* 로딩·실패 상태가 없다 */}
|
|
1190
|
+
❌ {loading ? <SCircleProgress indeterminate /> : <SImage src={url} />} {/* SImage 가 이미 한다 */}
|
|
1191
|
+
```
|
|
1192
|
+
|
|
1096
1193
|
---
|
|
1097
1194
|
|
|
1098
1195
|
## 4. 페이지 레시피 — 표준 골격
|
|
@@ -1119,15 +1216,27 @@ export default function AppShell({
|
|
|
1119
1216
|
children,
|
|
1120
1217
|
header,
|
|
1121
1218
|
scrollEndSpacing,
|
|
1122
|
-
|
|
1219
|
+
contentHeight,
|
|
1220
|
+
}: {
|
|
1221
|
+
children: React.ReactNode;
|
|
1222
|
+
header?: SPageHeaderProps;
|
|
1223
|
+
scrollEndSpacing?: boolean;
|
|
1224
|
+
contentHeight?: SPageContentHeight;
|
|
1225
|
+
}) {
|
|
1123
1226
|
return (
|
|
1124
1227
|
<SLayout type="box" header="fix">
|
|
1125
1228
|
{/* type/header/folded 는 SLayout 에만 준다 — SGnb 는 context 에서 읽는다 */}
|
|
1126
1229
|
<SGnb items={MENU} value={current} onValueChange={navigate} logo={<Logo />} />
|
|
1127
1230
|
{/* 콘텐츠 패딩은 SPage 가 토큰으로 넣는다 — p-sd-* 로 덮어쓰지 않는다 */}
|
|
1128
1231
|
{/* 스크롤 끝 여백도 SPage 가 넣는다. 끄는 건 페이지네이션 있는 목록뿐이라 페이지가 정한다 */}
|
|
1232
|
+
{/* 본문이 남은 높이를 채우는 목록 페이지는 contentHeight="fill" 을 넘긴다 (§4-2) */}
|
|
1129
1233
|
{/* header 는 페이지마다 달라 AppShell 이 그대로 받아 넘긴다 — 페이지 제목은 여기서 만들지 않는다 */}
|
|
1130
|
-
<SPage
|
|
1234
|
+
<SPage
|
|
1235
|
+
background="frame"
|
|
1236
|
+
scrollEndSpacing={scrollEndSpacing}
|
|
1237
|
+
contentHeight={contentHeight}
|
|
1238
|
+
header={header}
|
|
1239
|
+
>
|
|
1131
1240
|
{children}
|
|
1132
1241
|
</SPage>
|
|
1133
1242
|
</SLayout>
|
|
@@ -1169,7 +1278,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
1169
1278
|
|
|
1170
1279
|
**최소 너비는 `SLayout` 이 보장한다 — 앱이 `min-w-*` 를 직접 주지 않는다.** 창이 최소 너비(`SLAYOUT_MIN_WIDTH`, GNB 포함한 전체 기준)보다 좁아지면 GNB·상단바는 제자리에 남고 **`SPage` 안에만 가로 스크롤이 생긴다.** 문서(브라우저 창)에는 가로 스크롤이 생기지 않는다. 그래서 셸을 감싸는 요소에 `min-width` 나 `overflow-x` 를 걸지 않는다 — 걸면 창 전체가 스크롤되어 GNB 가 화면 밖으로 밀린다.
|
|
1171
1280
|
|
|
1172
|
-
**셸의 `SPage` 는 모든 페이지가 공유하므로,
|
|
1281
|
+
**셸의 `SPage` 는 모든 페이지가 공유하므로, 페이지마다 달라지는 것은 페이지가 셸에 알려야 한다.** 위처럼 프레임 컴포넌트가 `scrollEndSpacing` · `contentHeight` 를 받아 그대로 넘기고, 페이지네이션이 있는 목록 페이지만 `contentHeight="fill"` 을 준다 (§4-2). 나머지 페이지는 넘기지 않으면 기본값(`auto`, 스크롤 끝 여백 켬)이 적용된다.
|
|
1173
1282
|
|
|
1174
1283
|
**상단바 배치는 `header` 가 정한다.** 요소 순서가 달라지므로 슬롯을 채우기 전에 어느 쪽인지부터 정한다.
|
|
1175
1284
|
|
|
@@ -1191,7 +1300,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
1191
1300
|
topContent={
|
|
1192
1301
|
/* 남는 폭 전체를 받는다 — 왼쪽은 그대로, 오른쪽 끝은 ml-auto */
|
|
1193
1302
|
<div className="flex w-full items-center gap-sd-8">
|
|
1194
|
-
<
|
|
1303
|
+
<SSearchInput value={keyword} onValueChange={setKeyword} onSearch={runSearch} placeholder="통합 검색" />
|
|
1195
1304
|
<SButton size="sm" color="neutral" outline label="내 계정" className="ml-auto" onClick={openAccount} />
|
|
1196
1305
|
</div>
|
|
1197
1306
|
}
|
|
@@ -1208,7 +1317,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
1208
1317
|
{/* 접히면 menuTop·menuFooter 가 함께 빠지므로, 폴드 레일에 남길 것만 foldedTop 으로 따로 준다 */}
|
|
1209
1318
|
<SGnb
|
|
1210
1319
|
items={MENU} value={current} onValueChange={navigate} useRail
|
|
1211
|
-
menuTop={<
|
|
1320
|
+
menuTop={<SSearchInput value={keyword} onValueChange={setKeyword} placeholder="메뉴 검색" />}
|
|
1212
1321
|
menuFooter={<AccountRow />}
|
|
1213
1322
|
foldedTop={<SGhostButton icon="search" size="sm" ariaLabel="메뉴 검색" onClick={openSearch} />}
|
|
1214
1323
|
/>
|
|
@@ -1227,7 +1336,9 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
1227
1336
|
- **페이지 제목 줄에는 이 페이지의 주요 액션을 두지 않는다.** 부가적인 것만 `header.slot` 에 `SButton size="sm"` 으로 온다 (§4-1 "페이지 헤더 사용 규칙").
|
|
1228
1337
|
- **주요 액션(등록 등)은 `STableBar` 의 `rightActions`** 에 둔다.
|
|
1229
1338
|
- **선택 상태 액션(선택 삭제 등)은 `STableBar` 의 `actions`** 에 둔다. `actions` 슬롯은 건수 요약이 있으면 앞에 구분선(`SDivider`)을 **자동으로** 넣으므로 직접 구분선을 만들지 않는다.
|
|
1230
|
-
- **페이지네이션이 있으면
|
|
1339
|
+
- **페이지네이션이 있으면 본문이 남은 높이를 채우게 한다** — `AppShell` 에 `contentHeight="fill"` 을 넘긴다. 페이지가 통째로 스크롤되면 페이지네이션이 화면 밖으로 밀려 "여기서 끝"이 읽히지 않는다. `fill` 이면 **표만 자기 안에서 스크롤하고 페이지네이션은 하단에 고정**된다.
|
|
1340
|
+
- 본문 루트에 `h-full min-h-0` 으로 세로 축을 잇고, 남은 높이를 먹을 `STable` 에 `min-h-0 flex-1` 을 준다. 이 사슬이 하나라도 끊기면 표가 높이를 못 잡는다.
|
|
1341
|
+
- `fill` 에서는 페이지가 스크롤하지 않으므로 **`scrollEndSpacing` 은 무시된다** — 따로 끄지 않는다 (§2-2).
|
|
1231
1342
|
|
|
1232
1343
|
```tsx
|
|
1233
1344
|
import {
|
|
@@ -1275,9 +1386,10 @@ export default function ProductListPage() {
|
|
|
1275
1386
|
// 이 페이지의 주요 액션이 아니라 부가 액션 — slot 은 sm 버튼으로만 채운다
|
|
1276
1387
|
slot: <SButton size="sm" color="neutral" outline label="이용 가이드" onClick={openGuide} />,
|
|
1277
1388
|
}}
|
|
1278
|
-
|
|
1389
|
+
contentHeight="fill" // 표가 남은 높이를 채우고 페이지네이션이 하단에 고정된다
|
|
1279
1390
|
>
|
|
1280
|
-
|
|
1391
|
+
{/* h-full min-h-0 → STable 의 min-h-0 flex-1 로 세로 축이 이어진다 */}
|
|
1392
|
+
<div className="flex h-full min-h-0 flex-col gap-sd-12">
|
|
1281
1393
|
{/* 필터 — search 를 켜면 우측에 검색 패널이 붙는다 */}
|
|
1282
1394
|
<SKeyValueTable
|
|
1283
1395
|
fields={filterFields}
|
|
@@ -1302,7 +1414,9 @@ export default function ProductListPage() {
|
|
|
1302
1414
|
}
|
|
1303
1415
|
/>
|
|
1304
1416
|
|
|
1417
|
+
{/* 남은 높이를 채우고 본문만 스크롤한다 — 페이지네이션 바는 표 안에서 하단 고정 */}
|
|
1305
1418
|
<STable
|
|
1419
|
+
className="min-h-0 flex-1"
|
|
1306
1420
|
columns={columns}
|
|
1307
1421
|
rows={rows}
|
|
1308
1422
|
rowKey="id"
|
|
@@ -1388,7 +1502,7 @@ export default function ProductCreatePage() {
|
|
|
1388
1502
|
|
|
1389
1503
|
- 조회 값은 `type: 'text'` 행으로 표시한다. **상태·분류 태그도 별도 영역이 아니라 표의 한 행**으로 넣는다 (`render` 에 `STag`).
|
|
1390
1504
|
- 행이 많아지면 **유형별로 섹션을 나누고, 각 섹션을 `SSectionHeaderCard` 로 감싼다.**
|
|
1391
|
-
|
|
1505
|
+
섹션 제목은 `title` prop 으로, 바디 여백은 `padding` prop 으로 준다.
|
|
1392
1506
|
- **수정·삭제 버튼은 하단에 둔다.** 내용이 짧아 우측 상단에 두는 변형도 있으나 기본은 하단이다.
|
|
1393
1507
|
|
|
1394
1508
|
```tsx
|
|
@@ -1421,24 +1535,18 @@ export default function ProductDetailPage() {
|
|
|
1421
1535
|
// 목록에서 들어온 상세 페이지 — onBack 으로 뒤로가기를 준다
|
|
1422
1536
|
<AppShell header={{ fix: true, title: '클래식 셔츠', onBack: goList }}>
|
|
1423
1537
|
<div className="flex flex-col gap-sd-12">
|
|
1424
|
-
<SSectionHeaderCard>
|
|
1425
|
-
<
|
|
1426
|
-
<SSectionHeaderCard.Body>
|
|
1427
|
-
<SKeyValueTable fields={basicFields} values={product} />
|
|
1428
|
-
</SSectionHeaderCard.Body>
|
|
1538
|
+
<SSectionHeaderCard title="기본 정보" marker thickness="accent">
|
|
1539
|
+
<SKeyValueTable fields={basicFields} values={product} />
|
|
1429
1540
|
</SSectionHeaderCard>
|
|
1430
1541
|
|
|
1431
|
-
|
|
1432
|
-
|
|
1433
|
-
|
|
1434
|
-
|
|
1435
|
-
|
|
1436
|
-
|
|
1437
|
-
|
|
1438
|
-
/>
|
|
1439
|
-
<SSectionHeaderCard.Body>
|
|
1440
|
-
<SKeyValueTable fields={priceFields} values={product} />
|
|
1441
|
-
</SSectionHeaderCard.Body>
|
|
1542
|
+
{/* 헤더 우측에 액션이 필요하면 slot 을 쓴다 */}
|
|
1543
|
+
<SSectionHeaderCard
|
|
1544
|
+
title="가격 정보"
|
|
1545
|
+
marker
|
|
1546
|
+
helpText={['부가세 포함 금액입니다.']}
|
|
1547
|
+
slot={<SButton size="sm" color="secondary" label="이력" onClick={openHistory} />}
|
|
1548
|
+
>
|
|
1549
|
+
<SKeyValueTable fields={priceFields} values={product} />
|
|
1442
1550
|
</SSectionHeaderCard>
|
|
1443
1551
|
|
|
1444
1552
|
{/* 액션은 하단 — 목록(되돌리기)은 왼쪽 끝, 실행 액션은 오른쪽 끝 */}
|
|
@@ -1487,8 +1595,8 @@ export default function ProductDetailPage() {
|
|
|
1487
1595
|
- [ ] 텍스트 회색 위계를 순차 적용했는가 (기본 → `text-fg-secondary` → `text-fg-tertiary`, 단계 건너뛰기 ❌)
|
|
1488
1596
|
- [ ] `SPage`·`SPopup` 의 기본 패딩을 `p-sd-*` 로 덮어쓰지 않았는가, 블록·섹션 **간격**이 `gap-sd-12` 인가 (`gap-sd-16`/`gap-sd-24` ❌ — 24 는 안쪽 여백에만 열린다)
|
|
1489
1597
|
- [ ] 섹션·패널의 안쪽 **여백**이 §2-2 판정과 맞는가 (덩어리 두 종류 → 16 / 세 종류 이상 → 24, 서면 16)
|
|
1490
|
-
- [ ] `SSectionHeaderCard
|
|
1491
|
-
- [ ] 자체 스크롤하는 패널의 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` 이 있는가, 페이지네이션 있는 목록에서 `
|
|
1598
|
+
- [ ] `SSectionHeaderCard` 의 여백을 `p-sd-*` 가 아니라 `padding` prop 으로 줬는가
|
|
1599
|
+
- [ ] 자체 스크롤하는 패널의 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` 이 있는가, 페이지네이션 있는 목록에서 `contentHeight="fill"` 을 넘기고 `h-full min-h-0` → `STable` 의 `min-h-0 flex-1` 사슬을 이었는가
|
|
1492
1600
|
- [ ] 같은 컴포넌트를 나열할 때 §2-2 그룹 간격을 썼는가 (체크박스 가로 `gap-sd-24` 등)
|
|
1493
1601
|
- [ ] 페이지가 §4의 표준 골격에서 시작했는가
|
|
1494
1602
|
- [ ] `header.fix` 가 프로젝트 전체와 같은 값인가 (다른 페이지와 다르게 섞어 쓰지 않았는가, §4-1)
|
|
@@ -1575,7 +1683,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
1575
1683
|
- oceanblue: 15 25 50 60 65 70 75 80 85 90 95 99
|
|
1576
1684
|
- brilliantblue: 10 20 25 40 50 60 70 75 80 85 90 95 99 05
|
|
1577
1685
|
- bg: screen frame brand subtle accent accentLight accentBright accentFaint deep danger dangerLight warning caution progress success successLight neutralLight neutralBright tableHeader
|
|
1578
|
-
- fg: primary secondary tertiary quaternary brand subtleWarm subtleCool deep success dangerLight accent accentLight danger warning inverse
|
|
1686
|
+
- fg: primary secondary tertiary quaternary brand subtleWarm subtleCool deep success successLight dangerLight accent accentLight danger warning inverse
|
|
1579
1687
|
- border: default strong bold accent accentLight danger warning success
|
|
1580
1688
|
- disabled: bg text icon border
|
|
1581
1689
|
- link: accent
|
|
@@ -1701,6 +1809,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
1701
1809
|
--sys-color-fg-subtleCool
|
|
1702
1810
|
--sys-color-fg-subtleWarm
|
|
1703
1811
|
--sys-color-fg-success
|
|
1812
|
+
--sys-color-fg-successLight
|
|
1704
1813
|
--sys-color-fg-tertiary
|
|
1705
1814
|
--sys-color-fg-warning
|
|
1706
1815
|
--sys-color-field-bg-default
|
|
@@ -2068,7 +2177,6 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
2068
2177
|
| `activeKeys?` | `string[]` | — | 노출 필터 key 목록. 지정하면 제어 컴포넌트로 동작 — "필터 추가"로 고른 필드를 이 배열에 직접 넣어줘야 칩이 나타난다(onActiveKeysChange에서 받은 keys로 갱신). 지정하지 않으면 필드별 defaultActive 값을 기준으로 컴포넌트가 내부 상태로 관리하는 비제어 방식으로 동작한다 |
|
|
2069
2178
|
| `label?` | `string` | `'검색 필터'` | 좌측 태그 텍스트 |
|
|
2070
2179
|
| `showLabel?` | `boolean` | `false` | 좌측 태그(label)·구분선 표시 여부 |
|
|
2071
|
-
| `showAddButton?` | `boolean` | `true` | 필터 추가 버튼 표시 여부 |
|
|
2072
2180
|
| `showReset?` | `boolean` | `true` | 검색 초기화 링크 표시 여부 |
|
|
2073
2181
|
| `disabled?` | `boolean` | `false` | 바 비활성 상태 |
|
|
2074
2182
|
| `className?` | `string` | — | |
|
|
@@ -2103,6 +2211,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
2103
2211
|
- [SIcon](../SIcon)
|
|
2104
2212
|
- [SRadio](../SRadio)
|
|
2105
2213
|
- [SRadioButton](../SRadioButton)
|
|
2214
|
+
- [SSelect](../SSelect)
|
|
2106
2215
|
- [STag](../STag)
|
|
2107
2216
|
- [STextLink](../STextLink)
|
|
2108
2217
|
- [STooltip](../STooltip)
|
|
@@ -2194,6 +2303,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
2194
2303
|
| `value?` | `number` | `0` | 진행률 (0–100) |
|
|
2195
2304
|
| `type?` | `SCircleProgressType` | `'primary'` | 색상 테마 |
|
|
2196
2305
|
| `indeterminate?` | `boolean` | `false` | 불확정(스피너) 모드 — value 무시 |
|
|
2306
|
+
| `size?` | `number \| string` | `DEFAULT_SIZE` | 링의 지름. 숫자는 px 로 해석한다. 부모 크기에 비례시키려면 컨테이너 쿼리 단위(`'45cqh'`)를 쓴다 — 퍼센트는 부모가 inline-flex 라 기준 폭이 정해지지 않아 해석되지 않는다. |
|
|
2197
2307
|
| `label?` | `string` | — | 하단 레이블 |
|
|
2198
2308
|
| `innerValue?` | `boolean` | `false` | true면 퍼센트를 원 아래가 아닌 원 가운데에 표시 |
|
|
2199
2309
|
| `className?` | `string` | — | |
|
|
@@ -2203,6 +2313,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
2203
2313
|
|
|
2204
2314
|
### Used by
|
|
2205
2315
|
|
|
2316
|
+
- [SImage](../SImage)
|
|
2206
2317
|
- [SLoadingContainer](../SLoadingContainer)
|
|
2207
2318
|
- [SLoadingModal](../SLoadingModal)
|
|
2208
2319
|
- [STable](../STable)
|
|
@@ -2270,15 +2381,35 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
2270
2381
|
|
|
2271
2382
|
> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
|
|
2272
2383
|
|
|
2384
|
+
### SDatePickerMonthListbox
|
|
2385
|
+
|
|
2386
|
+
#### Props
|
|
2387
|
+
|
|
2388
|
+
| Prop | Type | Default | Description |
|
|
2389
|
+
|------|------|---------|-------------|
|
|
2390
|
+
| `value?` | `string \| null` | — | 선택 월 (YYYY-MM) |
|
|
2391
|
+
| `anchorYear?` | `number` | — | 연도 리스트가 처음 열릴 때 중앙에 둘 연도. 기본값은 올해 |
|
|
2392
|
+
| `selectable?` | `[string, string]` | — | 선택 가능 범위 [시작, 종료] |
|
|
2393
|
+
| `className?` | `string` | — | |
|
|
2394
|
+
| `style?` | `CSSProperties` | — | |
|
|
2395
|
+
|
|
2396
|
+
#### Events
|
|
2397
|
+
|
|
2398
|
+
| Event | Type | Description |
|
|
2399
|
+
|-------|------|-------------|
|
|
2400
|
+
| `onValueChange` | `(value: string) => void` | |
|
|
2401
|
+
| `onMonthSelect` | `(value: string) => void` | 월 컬럼에서 월을 선택했을 때 호출 |
|
|
2402
|
+
|
|
2273
2403
|
### SDatePicker
|
|
2274
2404
|
|
|
2275
2405
|
#### Props
|
|
2276
2406
|
|
|
2277
2407
|
| Prop | Type | Default | Description |
|
|
2278
2408
|
|------|------|---------|-------------|
|
|
2279
|
-
| `value?` | `string \| null` | — | 선택
|
|
2409
|
+
| `value?` | `string \| null` | — | 선택 값 (date: YYYY-MM-DD, month: YYYY-MM, year: YYYY) |
|
|
2410
|
+
| `mode?` | `SDatePickerMode` | `'date'` | 선택 모드 |
|
|
2280
2411
|
| `size?` | `SDatePickerSize` | `'sm'` | |
|
|
2281
|
-
| `placeholder?` | `string` |
|
|
2412
|
+
| `placeholder?` | `string` | — | |
|
|
2282
2413
|
| `selectable?` | `[string, string]` | — | 선택 가능 범위 [시작, 종료] |
|
|
2283
2414
|
| `disabled?` | `boolean` | `false` | |
|
|
2284
2415
|
| `width?` | `number \| string` | — | |
|
|
@@ -2303,9 +2434,27 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
2303
2434
|
|
|
2304
2435
|
| Event | Type | Description |
|
|
2305
2436
|
|-------|------|-------------|
|
|
2306
|
-
| `onValueChange` | `(
|
|
2437
|
+
| `onValueChange` | `(value: string) => void` | 선택 변경 (sdUpdate) |
|
|
2307
2438
|
| `onViewChange` | `(view: { year: number; month: number }) => void` | 보이는 연·월 변경 (sdViewChange) |
|
|
2308
2439
|
|
|
2440
|
+
### SDatePickerYearListbox
|
|
2441
|
+
|
|
2442
|
+
#### Props
|
|
2443
|
+
|
|
2444
|
+
| Prop | Type | Default | Description |
|
|
2445
|
+
|------|------|---------|-------------|
|
|
2446
|
+
| `value?` | `string \| null` | — | 선택 연도 (YYYY) |
|
|
2447
|
+
| `anchorYear?` | `number` | — | 리스트가 처음 열릴 때 중앙에 둘 연도. 기본값은 올해 |
|
|
2448
|
+
| `selectable?` | `[string, string]` | — | 선택 가능 범위 [시작, 종료] |
|
|
2449
|
+
| `className?` | `string` | — | |
|
|
2450
|
+
| `style?` | `CSSProperties` | — | |
|
|
2451
|
+
|
|
2452
|
+
#### Events
|
|
2453
|
+
|
|
2454
|
+
| Event | Type | Description |
|
|
2455
|
+
|-------|------|-------------|
|
|
2456
|
+
| `onValueChange` | `(year: string) => void` | |
|
|
2457
|
+
|
|
2309
2458
|
## Dependencies
|
|
2310
2459
|
|
|
2311
2460
|
### Used by
|
|
@@ -2704,6 +2853,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
2704
2853
|
| `readOnly?` | `boolean` | `false` | 읽기 전용 (회색 배경) |
|
|
2705
2854
|
| `width?` | `number \| string` | — | 컨트롤 너비 (숫자=px). 지정하면 필드가 부모 폭을 다 먹지 않고 (레이블 + width) 만큼만 차지한다. 다른 요소와 나란히 놓으려면 부모를 flex 로 두면 된다. |
|
|
2706
2855
|
| `minWidth?` | `number \| string` | — | 컨트롤 최소 너비 (숫자=px). 하한선만 지정하며 필드는 계속 부모 폭을 채운다 |
|
|
2856
|
+
| `maxWidth?` | `number \| string` | — | 컨트롤 최대 너비 (숫자=px). 상한선만 지정하며 필드는 그 아래에서 부모 폭을 채운다. `width` 와 달리 hug 로 전환하지 않는다 — 부모가 좁으면 같이 좁아지고, 넓어도 여기서 멈춘다. 값 길이가 정해진 컨트롤(날짜·시간)이 `width="100%"` 를 받아 행 전체로 늘어나는 것을 막는 데 쓴다. **라벨은 상한에 들어가지 않는다** — 라벨은 컨트롤의 형제라 이 상한 밖이다. `addonLabel` 은 테두리 박스 안이라 상한을 나눠 먹으므로, `labelWidth`(= addon 폭)만큼 상한을 자동으로 늘린다. addon 이 있는데 `labelWidth` 가 없으면 폭을 알 수 없어 상한을 걸지 않는다 — 컨트롤이 잘리는 것보다 넓은 편이 낫다. |
|
|
2707
2857
|
| `multiline?` | `boolean` | `false` | 멀티라인(textarea) — 컨트롤 높이를 고정하지 않고 min-height만 적용 |
|
|
2708
2858
|
| `borderless?` | `boolean` | `false` | 테두리 박스 제거 (inline 컨트롤용) — border/배경/hover·focus 강조만 사라지고 label·hint·errorMessage 등 나머지 필드 구성은 그대로 동작한다. |
|
|
2709
2859
|
| `children?` | `ReactNode` | — | 실제 컨트롤 (input/select 등) — 테두리 없이 렌더, 테두리는 SField가 제공 |
|
|
@@ -2734,6 +2884,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
2734
2884
|
- [SFilePicker](../SFilePicker)
|
|
2735
2885
|
- [SInput](../SInput)
|
|
2736
2886
|
- [SNumberInput](../SNumberInput)
|
|
2887
|
+
- [SSearchInput](../SSearchInput)
|
|
2737
2888
|
- [SSelect](../SSelect)
|
|
2738
2889
|
- [STextarea](../STextarea)
|
|
2739
2890
|
- [STimePicker](../STimePicker)
|
|
@@ -2926,6 +3077,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
2926
3077
|
- [SOverlayHeader](../SOverlayHeader)
|
|
2927
3078
|
- [SPage](../SPage)
|
|
2928
3079
|
- [SPopover](../SPopover)
|
|
3080
|
+
- [SSearchInput](../SSearchInput)
|
|
2929
3081
|
- [SSelect](../SSelect)
|
|
2930
3082
|
- [STimePicker](../STimePicker)
|
|
2931
3083
|
- [STimeRangePicker](../STimeRangePicker)
|
|
@@ -3063,12 +3215,14 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
3063
3215
|
- [SGhostButton](../SGhostButton)
|
|
3064
3216
|
- [SGnb](../SGnb)
|
|
3065
3217
|
- [SGuide](../SGuide)
|
|
3218
|
+
- [SImage](../SImage)
|
|
3066
3219
|
- [SKeyValueTable](../SKeyValueTable)
|
|
3067
3220
|
- [SListItem](../SListItem)
|
|
3068
3221
|
- [SLoadingModal](../SLoadingModal)
|
|
3069
3222
|
- [SNumberInput](../SNumberInput)
|
|
3070
3223
|
- [SPagination](../SPagination)
|
|
3071
3224
|
- [SPopover](../SPopover)
|
|
3225
|
+
- [SSearchInput](../SSearchInput)
|
|
3072
3226
|
- [SSectionHeaderCard](../SSectionHeaderCard)
|
|
3073
3227
|
- [SSelect](../SSelect)
|
|
3074
3228
|
- [SStepper](../SStepper)
|
|
@@ -3084,6 +3238,46 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
3084
3238
|
|
|
3085
3239
|
---
|
|
3086
3240
|
|
|
3241
|
+
# SImage
|
|
3242
|
+
|
|
3243
|
+
> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
|
|
3244
|
+
|
|
3245
|
+
### SImage
|
|
3246
|
+
|
|
3247
|
+
#### Props
|
|
3248
|
+
|
|
3249
|
+
| Prop | Type | Default | Description |
|
|
3250
|
+
|------|------|---------|-------------|
|
|
3251
|
+
| `src?` | `string` | — | 이미지 경로. 없으면 빈 이미지 아이콘이 나온다 |
|
|
3252
|
+
| `alt?` | `string` | `''` | 대체 텍스트 |
|
|
3253
|
+
| `ratio?` | `number` | `1` | 가로세로 비율. 소비자가 높이를 직접 주면 그쪽이 이긴다 |
|
|
3254
|
+
| `fit?` | `SImageFit` | `'cover'` | 이미지가 상자를 채우는 방식 (object-fit) |
|
|
3255
|
+
| `position?` | `string` | `'50% 50%'` | 이미지 정렬 위치 (object-position) |
|
|
3256
|
+
| `loading?` | `'lazy' \| 'eager'` | `'lazy'` | 브라우저 로딩 방식 |
|
|
3257
|
+
| `loadingShowDelay?` | `number` | `0` | 스피너를 띄우기까지 기다리는 시간(ms). 이 시간 안에 로드되면 스피너를 아예 그리지 않는다 — 캐시된 이미지에서 스피너가 한 프레임 번쩍이는 것을 막는다. |
|
|
3258
|
+
| `noSpinner?` | `boolean` | `false` | 로딩 중에도 스피너를 그리지 않는다 |
|
|
3259
|
+
| `loadingSlot?` | `ReactNode` | — | 로딩 중 표시를 직접 지정한다 (기본: 스피너) |
|
|
3260
|
+
| `errorSlot?` | `ReactNode` | — | 실패·빈 상태 표시를 직접 지정한다 (기본: 빈 이미지 아이콘) |
|
|
3261
|
+
| `imgProps?` | `ImgHTMLAttributes<HTMLImageElement>` | — | 안쪽 `<img>` 로 넘길 네이티브 속성 (srcSet · sizes · crossOrigin · draggable 등) |
|
|
3262
|
+
|
|
3263
|
+
#### Events
|
|
3264
|
+
|
|
3265
|
+
| Event | Type | Description |
|
|
3266
|
+
|-------|------|-------------|
|
|
3267
|
+
| `onLoad` | `(src: string) => void` | 로드 완료. 로드된 src 를 넘긴다 |
|
|
3268
|
+
| `onError` | `(event: SyntheticEvent<HTMLImageElement>) => void` | 로드 실패 |
|
|
3269
|
+
|
|
3270
|
+
## Dependencies
|
|
3271
|
+
|
|
3272
|
+
### Depends on
|
|
3273
|
+
|
|
3274
|
+
- [SCircleProgress](../SCircleProgress)
|
|
3275
|
+
- [SIcon](../SIcon)
|
|
3276
|
+
|
|
3277
|
+
### Graph
|
|
3278
|
+
|
|
3279
|
+
---
|
|
3280
|
+
|
|
3087
3281
|
# SInput
|
|
3088
3282
|
|
|
3089
3283
|
> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
|
|
@@ -3159,6 +3353,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
3159
3353
|
| `values?` | `Record<string, unknown>` | `{}` | field name을 key로 하는 값 객체 (`{ [name]: value }`). 지정 시 해당 field의 값으로 사용되며, field별 `options.value`보다 우선합니다. `onChange`의 `detail.values`와 함께 controlled 패턴으로 사용합니다. |
|
|
3160
3354
|
| `search?` | `boolean` | `false` | 우측 검색 패널 |
|
|
3161
3355
|
| `radius?` | `'default' \| 'useTop' \| 'full'` | `'default'` | border-radius 제어 |
|
|
3356
|
+
| `bordered?` | `boolean` | `true` | 바깥 테두리. 기본은 `true`. `SSectionHeaderCard` 의 `padding="none"` 안에 넣어 카드 가장자리까지 채울 때 `false` 로 끈다 — 카드가 이미 바깥 테두리를 그리므로, 켜 두면 1px 두 개가 나란히 놓여 그 변만 2px 로 보인다. |
|
|
3162
3357
|
| `className?` | `string` | — | |
|
|
3163
3358
|
| `style?` | `CSSProperties` | — | |
|
|
3164
3359
|
|
|
@@ -3255,7 +3450,6 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
3255
3450
|
| `children?` | `ReactNode` | — | 리스트 컨테이너 내부에 렌더링할 내용 |
|
|
3256
3451
|
| `useGap?` | `boolean` | `false` | 리스트 아이템 사이 gap 토큰 적용 여부 |
|
|
3257
3452
|
| `usePadding?` | `boolean` | `false` | 리스트 컨테이너 padding 토큰 적용 여부 |
|
|
3258
|
-
| `separator?` | `boolean` | `false` | 아이템 하단 구분선 표시 여부. 테두리를 가진 아이템(`bordered`)에는 쓰지 않는다 |
|
|
3259
3453
|
|
|
3260
3454
|
## Dependencies
|
|
3261
3455
|
|
|
@@ -3790,6 +3984,8 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
|
|
|
3790
3984
|
|------|------|---------|-------------|
|
|
3791
3985
|
| `background?` | `SPageBackground` | `'frame'` | 페이지 배경 표면. frame=흰 콘텐츠 면, neutral=옅은 회색 면, screen=앱 바탕. 스크롤바 처리도 여기 묶여 있다 — 셋 다 구분선+트랙 배경이고, 트랙 색만 neutral 에서 흰색이 된다. |
|
|
3792
3986
|
| `scrollEndSpacing?` | `boolean` | `true` | 스크롤 끝 여백. 마지막 항목이 창 하단에 붙어 "여기서 끝"이 안 읽히는 것을 막는다. 기본으로 켜져 있고, 페이지네이션처럼 끝을 알려주는 것이 이미 있으면 끈다(목록 페이지). |
|
|
3987
|
+
| `overlayScrollbar?` | `boolean` | `false` | true면 네이티브 스크롤바를 숨기고 SPage 위에 오버레이 스크롤바를 얹는다. 스크롤바가 레이아웃 폭을 차지하지 않아 내부 콘텐츠 폭이 줄어들지 않는다. |
|
|
3988
|
+
| `contentHeight?` | `SPageContentHeight` | `'auto'` | 본문 높이 모드. 기본은 `auto` — 콘텐츠가 흐르고 넘치면 페이지가 스크롤한다. `fill` 은 본문이 남은 높이를 정확히 채우고 페이지는 스크롤하지 않는다. 표가 자기 안에서 스크롤하고 페이지네이션이 하단에 고정되는 목록 화면용이다. 본문 루트에 `h-full` 이 먹으므로 `<div className="flex h-full min-h-0 flex-col">` + `<STable className="min-h-0 flex-1" />` 구성이 성립한다. `fill` 에서는 페이지가 스크롤하지 않으므로 `scrollEndSpacing` 이 무시된다. |
|
|
3793
3989
|
| `header?` | `SPageHeaderProps` | — | 페이지 타이틀 영역(pageHeader 포팅). 주면 스크롤·페이지 패딩 밖으로 빼내 상단에 고정 배치한다. `children` 은 항상 본문이다 — header 유무와 무관하게 같은 자리에 같은 뜻으로 들어간다. |
|
|
3794
3990
|
|
|
3795
3991
|
## Dependencies
|
|
@@ -4077,33 +4273,52 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
|
|
|
4077
4273
|
|
|
4078
4274
|
---
|
|
4079
4275
|
|
|
4080
|
-
#
|
|
4276
|
+
# SSearchInput
|
|
4081
4277
|
|
|
4082
4278
|
> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
|
|
4083
4279
|
|
|
4084
|
-
###
|
|
4280
|
+
### SSearchInput
|
|
4085
4281
|
|
|
4086
4282
|
#### Props
|
|
4087
4283
|
|
|
4088
4284
|
| Prop | Type | Default | Description |
|
|
4089
4285
|
|------|------|---------|-------------|
|
|
4090
|
-
| `
|
|
4091
|
-
| `
|
|
4286
|
+
| `value?` | `string \| number` | — | 값 (제어) |
|
|
4287
|
+
| `size?` | `SSearchInputSize` | `'sm'` | 크기 |
|
|
4288
|
+
| `placeholder?` | `string` | `'결과 내 검색'` | 플레이스홀더 |
|
|
4289
|
+
| `clearable?` | `boolean` | `false` | 지우기 버튼 — 값이 있을 때만 나타난다 |
|
|
4290
|
+
| `disabled?` | `boolean` | `false` | 비활성 |
|
|
4291
|
+
| `width?` | `number \| string` | — | 컨트롤 너비 (숫자=px). 미지정 시 부모 폭을 채운다 |
|
|
4292
|
+
| `focused?` | `boolean` | — | 포커스 상태 (제어/반영) |
|
|
4293
|
+
| `hovered?` | `boolean` | — | 호버 상태 (제어/반영) |
|
|
4294
|
+
| `inputClass?` | `string` | — | 내부 input 요소 className |
|
|
4295
|
+
| `inputStyle?` | `CSSProperties` | — | 내부 input 요소 style |
|
|
4296
|
+
| `className?` | `string` | — | |
|
|
4297
|
+
| `style?` | `CSSProperties` | — | |
|
|
4092
4298
|
|
|
4093
|
-
|
|
4299
|
+
#### Events
|
|
4094
4300
|
|
|
4095
|
-
|
|
4301
|
+
| Event | Type | Description |
|
|
4302
|
+
|-------|------|-------------|
|
|
4303
|
+
| `onValueChange` | `(value: string) => void` | 값 변경 — 문자열 전달 |
|
|
4304
|
+
| `onChange` | `InputHTMLAttributes<HTMLInputElement>['onChange']` | 네이티브 onChange (form-agnostic 연동용, RHF 등) |
|
|
4305
|
+
| `onSearch` | `(value: string) => void` | 검색 실행 — Enter 키에서 현재 값과 함께 호출된다. 한글 조합 중의 Enter(IME 확정)는 검색으로 치지 않는다. |
|
|
4096
4306
|
|
|
4097
|
-
|
|
4098
|
-
|
|
4099
|
-
|
|
4100
|
-
|
|
4101
|
-
|
|
4102
|
-
|
|
4103
|
-
|
|
4104
|
-
|
|
4105
|
-
|
|
4106
|
-
|
|
4307
|
+
## Dependencies
|
|
4308
|
+
|
|
4309
|
+
### Depends on
|
|
4310
|
+
|
|
4311
|
+
- [SField](../SField)
|
|
4312
|
+
- [SGhostButton](../SGhostButton)
|
|
4313
|
+
- [SIcon](../SIcon)
|
|
4314
|
+
|
|
4315
|
+
### Graph
|
|
4316
|
+
|
|
4317
|
+
---
|
|
4318
|
+
|
|
4319
|
+
# SSectionHeaderCard
|
|
4320
|
+
|
|
4321
|
+
> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
|
|
4107
4322
|
|
|
4108
4323
|
### SSectionHeaderCard
|
|
4109
4324
|
|
|
@@ -4111,7 +4326,18 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
|
|
|
4111
4326
|
|
|
4112
4327
|
| Prop | Type | Default | Description |
|
|
4113
4328
|
|------|------|---------|-------------|
|
|
4114
|
-
| `
|
|
4329
|
+
| `title?` | `ReactNode` | — | 헤더 제목 |
|
|
4330
|
+
| `titleSize?` | `SSectionHeaderCardTitleSize` | — | 제목 크기 |
|
|
4331
|
+
| `marker?` | `boolean` | — | 제목 앞 점 표시 여부 |
|
|
4332
|
+
| `required?` | `boolean` | — | 제목 뒤 필수 별 표시 여부 |
|
|
4333
|
+
| `helpText?` | `string[]` | — | 도움말 툴팁 메시지 |
|
|
4334
|
+
| `subtitle?` | `ReactNode` | — | 부제 |
|
|
4335
|
+
| `slot?` | `ReactNode` | — | 헤더 우측 슬롯 |
|
|
4336
|
+
| `thickness?` | `SSectionHeaderCardThickness` | — | 상단 border 색상 타입. false면 표시하지 않습니다. |
|
|
4337
|
+
| `headerClassName?` | `string` | — | 헤더 영역 클래스 |
|
|
4338
|
+
| `padding?` | `SSectionHeaderCardBodyPadding` | — | 바디 안쪽 여백. 기본은 `default`. 성격이 다른 요소가 세 종류 이상 섞인 영역에만 `wide`, 표를 가장자리까지 채울 때만 `none`. |
|
|
4339
|
+
| `background?` | `SSectionHeaderCardBodyBackground` | — | 본문 배경. 기본은 `frame` — 카드가 깐 흰 면을 그대로 쓴다. `neutral` 은 바탕을 한 단계 눌러앉혀, 흰 면 덩어리(표·리스트)가 여럿일 때 그것들이 **"면 위에 놓인 객체"로 읽히게** 한다. 위계를 한 단계 더 주고 싶을 때 고르는 선택지이며, **기본값이 틀린 것은 아니다** — 표·리스트는 테두리·라운드·헤더 줄과 간격을 이미 갖고 있어 흰 바탕에서도 경계가 읽힌다. 깔아도 **효과가 없는** 자리가 있다 — 덩어리가 가장자리까지 차는 경우(`padding="none"` 으로 표를 채우면 바탕이 완전히 가려진다), 덩어리에 회색 면이 섞인 경우(그 덩어리가 바탕에 묻힌다), 맨 텍스트나 폼 컨트롤만 있는 본문(떠오를 흰 면이 없다). |
|
|
4340
|
+
| `children?` | `SSectionHeaderCardChildren` | — | 바디 콘텐츠. 특정 컴포넌트 타입으로 제한하지 않습니다. |
|
|
4115
4341
|
|
|
4116
4342
|
## Dependencies
|
|
4117
4343
|
|
|
@@ -4182,6 +4408,7 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
|
|
|
4182
4408
|
|
|
4183
4409
|
### Used by
|
|
4184
4410
|
|
|
4411
|
+
- [SChipFilter](../SChipFilter)
|
|
4185
4412
|
- [SKeyValueTable](../SKeyValueTable)
|
|
4186
4413
|
- [STable](../STable)
|
|
4187
4414
|
|
|
@@ -4315,6 +4542,7 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
|
|
|
4315
4542
|
| `stickyHeader?` | `boolean` | — | |
|
|
4316
4543
|
| `stickyColumn?` | `STableStickyColumn` | — | 고정할 좌/우 컬럼 수 |
|
|
4317
4544
|
| `radius?` | `'default' \| 'useTop' \| 'full'` | `'default'` | border-radius 제어 |
|
|
4545
|
+
| `bordered?` | `boolean` | `true` | 바깥 테두리. 기본은 `true`. `SSectionHeaderCard` 의 `padding="none"` 안에 넣어 카드 가장자리까지 채울 때 `false` 로 끈다 — 카드가 이미 바깥 테두리를 그리므로, 켜 두면 1px 두 개가 나란히 놓여 그 변만 2px 로 보인다. 페이지네이션 바의 테두리와 1px 겹침(`-mt-px`)도 함께 꺼진다. 본문 테두리가 없으면 겹칠 대상이 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다. |
|
|
4318
4546
|
| `noDataLabel?` | `string` | `'데이터가 없습니다.'` | |
|
|
4319
4547
|
| `noDataSlot?` | `ReactNode` | — | 데이터가 없을 때 body 영역 전체를 대체하는 슬롯. 지정하면 `noDataLabel` 대신 이 콘텐츠가 헤더 아래 영역을 채우며, 버튼 등 인터랙션도 동작한다. |
|
|
4320
4548
|
| `isLoading?` | `boolean` | `false` | |
|
|
@@ -4406,7 +4634,6 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
|
|
|
4406
4634
|
|------|------|---------|-------------|
|
|
4407
4635
|
| `value` | `string` | — | 현재 선택된 탭 value |
|
|
4408
4636
|
| `tabs` | `STabOption[]` | — | 탭 옵션 목록 |
|
|
4409
|
-
| `size?` | `STabSize` | `'md'` | 탭 크기 (main 전용) |
|
|
4410
4637
|
| `isSub?` | `boolean` | `false` | 서브 탭(밑줄형) 스타일 |
|
|
4411
4638
|
| `vertical?` | `boolean` | `false` | 세로 배치 (sub 전용 — main 폴더형은 항상 가로) |
|
|
4412
4639
|
| `className?` | `string` | — | |
|
|
@@ -4758,6 +4985,7 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
|
|
|
4758
4985
|
| `value?` | `boolean` | `false` | 선택(on/off) 상태 |
|
|
4759
4986
|
| `label?` | `string` | `''` | 라벨 |
|
|
4760
4987
|
| `disabled?` | `boolean` | `false` | 비활성 |
|
|
4988
|
+
| `size?` | `SToggleSize` | `'sm'` | 크기 |
|
|
4761
4989
|
| `className?` | `string` | — | |
|
|
4762
4990
|
| `style?` | `CSSProperties` | — | |
|
|
4763
4991
|
|
|
@@ -4850,6 +5078,7 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
|
|
|
4850
5078
|
| `border?` | `boolean` | `true` | 아이템 하단 border 표시 여부 |
|
|
4851
5079
|
| `indeterminate?` | `boolean` | `false` | 일부 선택 상태 |
|
|
4852
5080
|
| `selectable?` | `boolean` | `true` | 체크박스 표시 여부 |
|
|
5081
|
+
| `size?` | `STreeSize` | `'sm'` | 타이포그래피 크기 |
|
|
4853
5082
|
| `leading?` | `ReactNode \| ((state: STreeItemRenderState) => ReactNode)` | — | 사용자 지정 leading 콘텐츠 |
|
|
4854
5083
|
| `trailing?` | `ReactNode \| ((state: STreeItemRenderState) => ReactNode)` | — | 사용자 지정 trailing 콘텐츠 |
|
|
4855
5084
|
|
|
@@ -4872,6 +5101,8 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
|
|
|
4872
5101
|
| `expandedIds?` | `string[]` | — | 펼쳐진 노드 ID 목록 |
|
|
4873
5102
|
| `defaultExpandedIds?` | `string[]` | — | 비제어 펼침 초기값 |
|
|
4874
5103
|
| `selectable?` | `boolean` | `true` | 체크박스 표시 여부 |
|
|
5104
|
+
| `size?` | `STreeSize` | `'sm'` | 타이포그래피 크기 |
|
|
5105
|
+
| `useAll?` | `boolean` | `false` | 체크박스 사용 시 최상단 전체 선택 아이템 표시 여부 |
|
|
4875
5106
|
| `guideline?` | `boolean` | `true` | depth 연결선 표시 여부 |
|
|
4876
5107
|
| `border?` | `boolean` | `true` | 아이템 하단 border 표시 여부 |
|
|
4877
5108
|
| `cascadeSelection?` | `boolean` | `true` | 부모 선택 시 하위 노드까지 함께 토글 |
|