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.txt
CHANGED
|
@@ -36,12 +36,12 @@
|
|
|
36
36
|
| 분류 | 컴포넌트 |
|
|
37
37
|
| --- | --- |
|
|
38
38
|
| **버튼·링크** | `SButton` `SGhostButton` `SDropdownButton` `STextLink` `SSwitch` `SToggle` |
|
|
39
|
-
| **입력 (폼)** | `SForm` `SField` `SInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
|
|
40
|
-
| **날짜·시간** | `SCalendar` `SDatePicker` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
|
|
39
|
+
| **입력 (폼)** | `SForm` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
|
|
40
|
+
| **날짜·시간** | `SCalendar` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
|
|
41
41
|
| **표·목록** | `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SListItem` `SExpansionList` `SDraggableList` `SDraggableItem` `STree` |
|
|
42
42
|
| **레이아웃** | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) `SSectionHeaderCard` `SCard` `SDivider` `SSplitter` `SScrollArea` `SExpansionItem` |
|
|
43
43
|
| **내비게이션** | `STabs` `SPagination` `SStepper` |
|
|
44
|
-
| **표시·상태** | `STag` `SBadge` `SIcon` `SCallout` `SGuide` |
|
|
44
|
+
| **표시·상태** | `STag` `SBadge` `SIcon` `SImage` `SCallout` `SGuide` |
|
|
45
45
|
| **진행·로딩** | `SLinearProgress` `SCircleProgress` `SLoadingContainer` `SLoadingModal` |
|
|
46
46
|
| **오버레이** | `STooltip` `SPopover` `SPopup` `SDrawer` `SPortal` |
|
|
47
47
|
| **모달** | `SModal.confirm()` `SModal.create()` + `SActionModal` `SConfirmModal` `SModalOutlet`(앱 루트 1회) |
|
|
@@ -69,6 +69,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
|
|
|
69
69
|
| --- | --- |
|
|
70
70
|
| `<button>` | `SButton`, `SGhostButton`, `SDropdownButton`, `STextLink` |
|
|
71
71
|
| `<input type="text/password/...">` | `SInput` |
|
|
72
|
+
| `<input type="search">` | `SSearchInput` |
|
|
72
73
|
| `<input type="number">` | `SNumberInput` |
|
|
73
74
|
| `<input type="checkbox">` | `SCheckbox`, `SToggle`, `SSwitch` |
|
|
74
75
|
| `<input type="radio">` | `SRadio`, `SRadioButton` |
|
|
@@ -81,7 +82,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
|
|
|
81
82
|
| `alert()`, `confirm()` | `SToast`, `SModal.confirm(...)` |
|
|
82
83
|
| 직접 만든 탭/페이지네이션/스텝퍼 | `STabs`, `SPagination`, `SStepper` |
|
|
83
84
|
| `<ul>`/`<li>` 로 만든 목록 UI | `SList` + `SListItem` (드래그 정렬은 `SDraggableItem`) |
|
|
84
|
-
| 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard`
|
|
85
|
+
| 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard` 의 `title` / `padding` props |
|
|
85
86
|
| `<svg>` 직접 삽입, 이모지 아이콘 | `SIcon` |
|
|
86
87
|
| `<hr>` | `SDivider` |
|
|
87
88
|
| `<details>` / `<summary>` | `SExpansionItem` |
|
|
@@ -147,7 +148,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
147
148
|
| --- | --- | --- |
|
|
148
149
|
| **셸** | 앱 전체 뼈대. 페이지가 바뀌어도 남는다 | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) |
|
|
149
150
|
| **블록** | `SPage` 의 직계 자식. 페이지를 세로로 쌓는 단위 | `SSectionHeaderCard` `SCard` `SForm` `SSplitter` `SScrollArea` `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SExpansionList` `SDraggableList` `STree` `SCallout` `STabs` `SStepper` `SPagination` `SDivider` |
|
|
150
|
-
| **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `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` |
|
|
151
|
+
| **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `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` |
|
|
151
152
|
| **인라인** | 텍스트 흐름·셀·라벨 안에 섞인다. 혼자 블록이 되지 않는다 | `STag` `SBadge` `SIcon` `STextLink` `SChip` |
|
|
152
153
|
| **레이어** | 문서 흐름 **밖**에 떠서 그려진다. 어느 층에서 띄우든 레이아웃에 영향이 없다 | `SModal` `SActionModal` `SConfirmModal` `SPopup` `SDrawer` `SPopover` `STooltip` `SPortal` `SToast` `SLoadingModal` `SLoadingContainer` `SGuide` |
|
|
153
154
|
|
|
@@ -167,7 +168,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
167
168
|
| 담는 것 | 올 수 있는 것 | 오면 안 되는 것 |
|
|
168
169
|
| --- | --- | --- |
|
|
169
170
|
| `SPage` | **블록만** | **요소를 직접** — 버튼 하나도 블록에 담아 놓는다 |
|
|
170
|
-
| `SSectionHeaderCard
|
|
171
|
+
| `SSectionHeaderCard` 의 `children` | 그리는 블록 · 요소 | `SSectionHeaderCard` · `SCard` (카드 겹침, §3-7-8) |
|
|
171
172
|
| `SCard` | 그리는 블록 · 요소 | `SCard` · `SSectionHeaderCard` |
|
|
172
173
|
| `SForm` | 블록 (보통 `SKeyValueTable` + 하단 액션) | — |
|
|
173
174
|
| `SSplitter.Before` / `.After` | 블록 | — |
|
|
@@ -231,7 +232,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
231
232
|
|
|
232
233
|
페이지 제목만 18px 로 크게 두고 그 아래는 14 / 12 로 촘촘하게 간다. 중간 크기(16px)는 기본 골격에서 쓰지 않는다.
|
|
233
234
|
|
|
234
|
-
- **페이지·섹션 제목의 타이포를 직접 주지 않는다.** `SPage` 의 `header.title`, `SSectionHeaderCard
|
|
235
|
+
- **페이지·섹션 제목의 타이포를 직접 주지 않는다.** `SPage` 의 `header.title`, `SSectionHeaderCard` 의 `header.title` 이 이미 넣는다 — 그 위에 `typo-heading-lg`/`typo-heading-sm` 을 또 씌우지 않는다.
|
|
235
236
|
- **하위 제목이 필요하면 먼저 섹션을 나눌 수 없는지 본다.** 한 섹션 안에서 제목이 두 단으로 갈린다는 것은 대개 섹션이 둘이라는 뜻이다 (§3-7-8).
|
|
236
237
|
- 본문 안에서 한 단어를 강조할 때는 `typo-body-sm-medium` 을 쓴다. `typo-body-sm-bold` 는 제목 성격의 짧은 라벨에만 쓴다. <!-- TODO(디자인): 강조 굵기 기준 확정 -->
|
|
237
238
|
|
|
@@ -301,7 +302,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
301
302
|
|
|
302
303
|
**페이지 프레임은 예외 없이 `SPage` 가 넣는다.** 아래 규칙은 그 안의 **섹션·패널 레벨에만** 적용된다.
|
|
303
304
|
|
|
304
|
-
**컴포넌트가 자체 여백을 가지면 컴포넌트 기준이 우선한다.** `SKeyValueTable`·`STable` 처럼 자기 여백을 토큰으로 갖고 있는 컴포넌트에는 이 판정을 적용하지 않는다 — 손댈 것이 없다. 아래 판정이 필요한 자리는 **직접 만든 컨테이너**와 **`SSectionHeaderCard
|
|
305
|
+
**컴포넌트가 자체 여백을 가지면 컴포넌트 기준이 우선한다.** `SKeyValueTable`·`STable` 처럼 자기 여백을 토큰으로 갖고 있는 컴포넌트에는 이 판정을 적용하지 않는다 — 손댈 것이 없다. 아래 판정이 필요한 자리는 **직접 만든 컨테이너**와 **`SSectionHeaderCard` 의 `padding`** 두 곳뿐이다.
|
|
305
306
|
|
|
306
307
|
판정은 **그 영역이 담고 있는 콘텐츠 덩어리의 종류 수**로 한다.
|
|
307
308
|
|
|
@@ -336,14 +337,47 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
336
337
|
|
|
337
338
|
**중첩되면 안쪽 여백을 주지 않는다.** 24 영역 안에 또 여백을 주면 가장자리가 40 으로 벌어져 한 면적처럼 읽힌다. 안쪽 카드·목록이 **배경색이 다르거나 테두리가 있어** 경계가 스스로 보이는 경우에만 자기 여백을 유지한다.
|
|
338
339
|
|
|
339
|
-
`SSectionHeaderCard
|
|
340
|
+
`SSectionHeaderCard` 는 이 규칙을 **`padding` prop 으로 받는다** — 직접 `p-sd-*` 를 주지 않는다.
|
|
340
341
|
|
|
341
342
|
```tsx
|
|
342
|
-
<SSectionHeaderCard
|
|
343
|
-
<SSectionHeaderCard
|
|
344
|
-
<SSectionHeaderCard
|
|
343
|
+
<SSectionHeaderCard title="기본 정보">…</SSectionHeaderCard> {/* 기본 = 16 */}
|
|
344
|
+
<SSectionHeaderCard title="기본 정보" padding="wide">…</SSectionHeaderCard> {/* 3종류 이상 */}
|
|
345
|
+
<SSectionHeaderCard title="기본 정보" padding="none">…</SSectionHeaderCard> {/* 표를 가장자리까지 */}
|
|
345
346
|
```
|
|
346
347
|
|
|
348
|
+
##### 카드 가장자리까지 채우는 표는 자기 테두리를 끈다
|
|
349
|
+
|
|
350
|
+
여기서 "표"는 **`STable` 과 `SKeyValueTable` 둘 다**다. 두 컴포넌트 모두 자기 바깥 테두리를 그리는데, 카드도 바깥 테두리를 그린다. `padding="none"` 으로 붙이면 **1px 두 개가 나란히 놓여 그 변만 2px** 로 보인다(카드의 다른 변은 1px 그대로라 굵기가 어긋난다).
|
|
351
|
+
|
|
352
|
+
```tsx
|
|
353
|
+
<SSectionHeaderCard title="발주 내역" padding="none">
|
|
354
|
+
<SKeyValueTable fields={…} bordered={false} radius="useTop" />
|
|
355
|
+
<STable columns={…} rows={…} bordered={false} radius="useTop" />
|
|
356
|
+
</SSectionHeaderCard>
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
- **`bordered={false}`** 로 표의 테두리를 끈다. 카드가 이미 그린다.
|
|
360
|
+
- **`radius="useTop"`** 으로 위쪽 모서리를 죽인다. 아래쪽 라운드는 카드가 처리한다.
|
|
361
|
+
- `STable` 은 **페이지네이션 바의 테두리와 `-mt-px` 겹침도 함께 꺼진다** — 본문 테두리가 없으면 겹칠 대상이 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다.
|
|
362
|
+
|
|
363
|
+
#### 본문 바탕 눌러앉히기 (선택)
|
|
364
|
+
|
|
365
|
+
`SSectionHeaderCard` 는 **`background="neutral"`** 로 본문 바탕을 한 단계 눌러앉힐 수 있다. 흰 면 덩어리(표·리스트)가 여럿일 때 그 덩어리들이 **"면 위에 놓인 객체"로 읽혀 묶음이 더 강하게 보인다.**
|
|
366
|
+
|
|
367
|
+
```tsx
|
|
368
|
+
<SSectionHeaderCard title="발주 상세" background="neutral">…흰 면 표 여럿…</SSectionHeaderCard>
|
|
369
|
+
```
|
|
370
|
+
|
|
371
|
+
**기본값(`frame`, 흰 면)이 틀린 것이 아니다.** 이 저장소의 표·리스트는 테두리·라운드·헤더 줄과 `gap-sd-12` 를 이미 갖고 있어 흰 바탕에서도 경계가 읽힌다. 위계를 한 단계 더 주고 싶을 때 고르는 수단이지, 덩어리가 둘 이상이면 반드시 깔아야 하는 규칙이 아니다.
|
|
372
|
+
|
|
373
|
+
깔아도 **효과가 없는** 자리는 있다.
|
|
374
|
+
|
|
375
|
+
- **덩어리가 가장자리까지 차는 경우** — `padding="none"` 으로 표를 채우면 깐 바탕이 표에 완전히 가려 보이지 않는다.
|
|
376
|
+
- **덩어리에 회색 면이 섞인 경우** — 그 덩어리가 바탕과 같은 색이 되어 묻힌다.
|
|
377
|
+
- **맨 텍스트·폼 컨트롤만 있는 본문** — 떠오를 흰 면이 없다.
|
|
378
|
+
|
|
379
|
+
바탕을 깐 경우, 표 사이 구분선(`SDivider`)은 대개 불필요해진다 — 색이 이미 경계를 만든다.
|
|
380
|
+
|
|
347
381
|
#### 스크롤 영역의 하단 여백
|
|
348
382
|
|
|
349
383
|
스크롤을 끝까지 내렸을 때 마지막 항목이 화면 경계에 붙으면 **목록이 끝난 것인지 더 있는 것인지** 읽히지 않는다. 그래서 스크롤 영역은 **하단만** 넓게 둔다. 나머지 세 방향은 위 16 / 24 규칙 그대로다.
|
|
@@ -353,7 +387,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
353
387
|
| **패널 자체 스크롤** (좌측 목록, 중앙 대화 등) | 그 패널 안쪽 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` — `SPage` 와 같은 토큰이라 값이 바뀌어도 함께 따라간다 |
|
|
354
388
|
| **페이지 단위 스크롤** | **`SPage` 가 넣는다. 직접 주지 않는다** |
|
|
355
389
|
|
|
356
|
-
`SPage` 는 기본으로 넣으므로 **아무것도 하지 않으면 맞다.**
|
|
390
|
+
`SPage` 는 기본으로 넣으므로 **아무것도 하지 않으면 맞다.** 직접 끌 일은 없다 — **페이지네이션이 붙은 테이블**은 `contentHeight="fill"` 을 쓰고, 이 모드에서는 페이지가 스크롤하지 않아 스크롤 끝 여백이 **자동으로 무시**된다 (§4-2 목록 페이지).
|
|
357
391
|
|
|
358
392
|
### 2-3. 색상
|
|
359
393
|
|
|
@@ -415,6 +449,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
415
449
|
| --- | --- | --- |
|
|
416
450
|
| 한 줄 텍스트를 받는다 | `SInput` | §3-7-1 |
|
|
417
451
|
| 여러 줄 텍스트를 받는다 | `STextarea` | §3-7-1 |
|
|
452
|
+
| 목록·결과를 검색어로 좁힌다 | `SSearchInput` | §3-7-1 |
|
|
418
453
|
| 숫자(수량·금액)를 받는다 | `SNumberInput` | |
|
|
419
454
|
| 바코드를 스캔해 받는다 | `SBarcodeInput` | |
|
|
420
455
|
| 목록에서 하나 고르게 한다 | `SSelect` | §3-7-2 |
|
|
@@ -428,6 +463,8 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
428
463
|
| 입력된 값 하나를 지우거나 고치게 한다 | `SChip` | §3-1 |
|
|
429
464
|
| 파일을 받는다 | `SFilePicker` | |
|
|
430
465
|
| 날짜 하나를 받는다 | `SDatePicker` | §3-7-4 |
|
|
466
|
+
| 연도 선택 리스트만 커스텀 조합에 넣는다 | `SDatePickerYearListbox` | §3-7-4 |
|
|
467
|
+
| 연도+월 선택 리스트만 커스텀 조합에 넣는다 | `SDatePickerMonthListbox` | §3-7-4 |
|
|
431
468
|
| 날짜 기간을 받는다 | `SDateRangePicker` | §3-7-4 |
|
|
432
469
|
| 시각 하나를 받는다 | `STimePicker` | |
|
|
433
470
|
| 시각 범위를 받는다 | `STimeRangePicker` | |
|
|
@@ -451,6 +488,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
451
488
|
| 상태·분류를 라벨로 찍는다 | `STag` | §3-1 |
|
|
452
489
|
| 색 점만으로 상태를 찍는다 | `SBadge` | §3-1 |
|
|
453
490
|
| 아이콘을 넣는다 | `SIcon` | |
|
|
491
|
+
| 사진·썸네일을 보여준다 (로딩·실패 상태 포함) | `SImage` | §3-7-12 |
|
|
454
492
|
| 문장 안에서 다른 화면으로 보낸다 | `STextLink` | §3-5-6 |
|
|
455
493
|
|
|
456
494
|
#### C. 동작을 실행시킨다
|
|
@@ -558,9 +596,26 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
558
596
|
| | 무엇인가 | 크기 |
|
|
559
597
|
| --- | --- | --- |
|
|
560
598
|
| **SPopup** | **별도 브라우저 창** (`window.open` 으로 여는 전용 라우트) | 창 크기 = 콘텐츠 크기 |
|
|
561
|
-
| **SActionModal** | 같은 창 위 오버레이 카드 | `width`
|
|
599
|
+
| **SActionModal** | 같은 창 위 오버레이 카드 | `width` prop. **높이는 주지 않는다** (아래) |
|
|
562
600
|
| **SModal.confirm** (`SConfirmModal`) | 같은 창 위 확인창 | 고정 |
|
|
563
601
|
|
|
602
|
+
##### 모달 높이는 내용이 정하고, 상한은 시스템이 건다
|
|
603
|
+
|
|
604
|
+
**`height` 를 주지 않는다.** 높이는 내용이 정하고, 카드는 **뷰포트의 85%** 에서 멈춘다(시스템이 모든 모달에 건다). 데이터가 적으면 내용만큼 작아지고, 많으면 85% 에서 멈춘다.
|
|
605
|
+
|
|
606
|
+
가로는 좌우 24px 씩을 뺀 값으로 클램핑하는데 **세로만 비율**인 이유는, 모달이 화면을 거의 다 덮으면 뒤 맥락이 사라져 "떠 있는 것"으로 읽히지 않기 때문이다.
|
|
607
|
+
|
|
608
|
+
**상한에 닿았을 때 스크롤되어야 하는 것은 모달 본문이 아니라 표다.**
|
|
609
|
+
|
|
610
|
+
```tsx
|
|
611
|
+
<SActionModal modalTitle="발주 검토" button={{ label: '확정', onClick: submit }}>
|
|
612
|
+
{/* 표가 남은 높이를 먹고 자기 안에서 스크롤한다 — 헤더·합계·푸터는 늘 보인다 */}
|
|
613
|
+
<STable className="min-h-0 flex-1" columns={columns} rows={rows} />
|
|
614
|
+
</SActionModal>
|
|
615
|
+
```
|
|
616
|
+
|
|
617
|
+
본문(`overflow-auto` 영역)이 통째로 스크롤되면 표 헤더와 합계 줄이 위로 밀려 사라진다. `SActionModal` 의 본문은 이미 `min-h-0 flex-1` 이므로, 표에 `min-h-0 flex-1` 을 주면 세로 축이 이어져 표만 스크롤한다 (§4-2 목록 페이지와 같은 사슬이다).
|
|
618
|
+
|
|
564
619
|
**성격이 먼저 둘로 갈린다.**
|
|
565
620
|
|
|
566
621
|
| 성격 | 정의 | 컴포넌트 |
|
|
@@ -748,6 +803,7 @@ const columns: STableColumn[] = [
|
|
|
748
803
|
|
|
749
804
|
컬럼 폭은 `width` 로 **고정**되고, `<td>` 는 그 폭을 넘는 내용을 잘라낸다(`overflow: hidden`). 텍스트라면 말줄임으로 끝나지만, 셀에 `STag` · `SButton` · `SGhostButton` · `SSelect` · `SInput` · `SNumberInput` 처럼 **자기 폭을 가진 요소**를 넣으면 요소 자체가 잘려 **누르거나 읽거나 입력할 수 없게 된다.** `width` 를 생략해도 내용에 맞춰 늘어나지 않고 `STable` 의 기본 폭이 될 뿐이므로, 컨트롤이 들어가는 컬럼은 폭을 직접 판단해서 준다.
|
|
750
805
|
|
|
806
|
+
- **컨트롤이 들어가는 컬럼에는 `contentType: 'control'` 을 함께 준다.** 좌우 패딩이 텍스트용(넓게)에서 컨트롤용(좁게)으로 바뀌어, 같은 컬럼 폭에서도 요소가 쓸 폭이 넓어진다. 기본값은 `text` 다.
|
|
751
807
|
- 기준은 **요소가 온전히 보이는 폭 + 셀 좌우 패딩**이다. 좌우 패딩은 `STable` 이 토큰으로 넣으므로(직접 주지 않는다) 그만큼을 뺀 나머지가 요소 몫이라는 점을 계산에 넣는다.
|
|
752
808
|
- 요소가 둘 이상이면 요소 폭의 합에 **`gap` 까지** 더한다 (행 내부 인라인 액션 간격은 `gap-sd-4` 고정, §3-5-5).
|
|
753
809
|
- 값에 따라 폭이 달라지는 요소(`STag` 라벨, 라벨 있는 버튼)는 **가장 긴 값** 기준으로 잡는다. `판매중` 에 맞춰두면 `판매중지 요청` 에서 잘린다.
|
|
@@ -755,6 +811,13 @@ const columns: STableColumn[] = [
|
|
|
755
811
|
- 폭을 넉넉히 줄 수 없는 자리는 폭을 줄이는 게 아니라 **요소를 바꾼다** — 라벨 버튼 대신 아이콘만 있는 `SGhostButton`, `size="xs"` (§3-5-2, §3-5-5).
|
|
756
812
|
- **`autoWidth` 는 해법이 아니다.** 내용에 맞춰 늘어나는 게 아니라 고정폭 컬럼들이 가져가고 **남은 폭을 나눠 갖는 것**이라, 테이블이 좁으면 역시 잘린다. 컨트롤 컬럼은 `width` 로 직접 확보한다.
|
|
757
813
|
|
|
814
|
+
```tsx
|
|
815
|
+
{ name: 'normal', label: '정상', field: 'normal', width: '96px',
|
|
816
|
+
align: 'center', contentType: 'control', render: row => <SNumberInput … /> },
|
|
817
|
+
```
|
|
818
|
+
|
|
819
|
+
**셀 좌우 여백은 내용이 정한다.** 텍스트는 넓게, 컨트롤은 좁게다 — `SKeyValueTable` 은 `field.type` 으로 이 판정을 스스로 하지만, `STable` 의 셀은 소비 앱이 넘긴 임의의 `render` 결과라 컴포넌트가 알 수 없다. 그래서 `contentType` 으로 알려준다. 여백 값 자체는 토큰이 정하므로 `tdClass` 로 패딩을 직접 덮어쓰지 않는다.
|
|
820
|
+
|
|
758
821
|
**`resizable` 테이블이면 `minWidth` 를 함께 준다.** resize 하한 기본값은 어떤 컨트롤도 담지 못할 만큼 작아, 사용자가 끝까지 끌면 그대로 잘린다. `width` 를 정한 근거와 같은 값을 하한으로 둔다 — 텍스트 컬럼과 달리 여기서는 더 줄일 여지가 없다.
|
|
759
822
|
|
|
760
823
|
```tsx
|
|
@@ -967,16 +1030,19 @@ const columns: STableColumn[] = [
|
|
|
967
1030
|
|
|
968
1031
|
> §3-0 라우팅에서 이 절을 가리키는 자리들이다. <!-- TODO(디자인): 전체 검수·확정 -->
|
|
969
1032
|
|
|
970
|
-
#### 3-7-1. SInput vs STextarea
|
|
1033
|
+
#### 3-7-1. SInput vs STextarea vs SSearchInput
|
|
971
1034
|
|
|
972
|
-
|
|
1035
|
+
**먼저 "그 값이 저장되는가"를 본다.** 저장되면 폼 필드(`SInput`·`STextarea`), 화면을 좁히기만 하고 사라지면 `SSearchInput` 이다.
|
|
973
1036
|
|
|
974
1037
|
| 값 | 사용 |
|
|
975
1038
|
| --- | --- |
|
|
976
1039
|
| 이름·코드·전화번호·URL 처럼 형식이 정해진 값 | `SInput` |
|
|
977
1040
|
| 메모·사유·설명처럼 길이가 예측되지 않는 문장 | `STextarea` |
|
|
1041
|
+
| 지금 보이는 목록·결과를 좁히는 검색어 | `SSearchInput` |
|
|
1042
|
+
|
|
1043
|
+
폼 필드 둘은 **줄 수가 아니라 값의 성격으로** 갈린다. 값이 길어질 수 있는데 `SInput` 을 쓰면 사용자가 자기가 쓴 것을 다시 읽지 못한다 — 한 줄 안에서 좌우로 스크롤해야 하기 때문이다. 반대로 짧은 값에 `STextarea` 를 쓰면 빈 공간이 남아 입력량을 잘못 기대하게 한다.
|
|
978
1044
|
|
|
979
|
-
|
|
1045
|
+
`SSearchInput` 은 폼 필드가 아니다 — 라벨·힌트·유효성 규칙·에러 메시지를 받지 않고, `SForm` 의 제출 검증 대상에도 들어가지 않는다. 돋보기 아이콘이 항상 앞에 붙어 "여기는 검색"임을 스스로 밝히므로 라벨을 따로 붙이지 않는다. 검색 실행은 `onSearch`(Enter) 로 받고, 값이 바뀔 때마다 좁히는 실시간 필터라면 `onValueChange` 만 쓴다. 반대로 검색어를 **저장하거나 검증해야 한다면** 그것은 폼 값이므로 `SInput` 이다.
|
|
980
1046
|
|
|
981
1047
|
#### 3-7-2. 하나를 고르게 하는 다섯 — SSelect vs SRadioGroup vs SRadioButton vs STabs vs SRadio
|
|
982
1048
|
|
|
@@ -1013,11 +1079,25 @@ const columns: STableColumn[] = [
|
|
|
1013
1079
|
| 판별 | 사용 |
|
|
1014
1080
|
| --- | --- |
|
|
1015
1081
|
| 날짜 **하나**를 값으로 받는다 | `SDatePicker` |
|
|
1082
|
+
| 연도 선택 리스트만 필요하다 (트리거·팝오버는 직접 조합) | `SDatePickerYearListbox` |
|
|
1083
|
+
| 연도+월 선택 리스트만 필요하다 (트리거·팝오버는 직접 조합) | `SDatePickerMonthListbox` |
|
|
1016
1084
|
| **시작~종료** 를 값으로 받는다 | `SDateRangePicker` |
|
|
1017
1085
|
| 달력 격자 **자체가 화면 콘텐츠** 다 (일정·이벤트 보기) | `SCalendar` |
|
|
1018
1086
|
|
|
1019
1087
|
- **기간을 `SDatePicker` 두 개로 만들지 않는다.** 시작이 종료보다 뒤인 입력을 막는 검증과 한쪽만 고른 중간 상태 처리가 `SDateRangePicker` 안에 이미 있다. 두 개로 쪼개면 그게 전부 앱 몫이 된다.
|
|
1020
1088
|
- `SDatePicker`·`SDateRangePicker` 는 내부적으로 `SCalendar` 를 팝오버로 띄운다. 값을 받는 자리에 `SCalendar` 를 직접 쓰지 않는다.
|
|
1089
|
+
- `SDatePickerYearListbox`·`SDatePickerMonthListbox` 는 `SDatePicker` 의 mode listbox 조각만 떼어낸 컴포넌트다. 일반 폼 입력에는 `SDatePicker mode="year" | "month"` 를 우선 쓰고, 다른 트리거·팝오버 안에 리스트만 끼워 넣을 때만 직접 쓴다.
|
|
1090
|
+
|
|
1091
|
+
**날짜·시간 피커는 폭 상한을 스스로 갖는다 — `width` 를 주지 않는다.** 값 길이가 `YYYY-MM-DD` 처럼 정해져 있어 컴포넌트가 사이즈별 상한을 안다. `SKeyValueTable` 이 모든 컨트롤에 `width="100%"` 를 넘기지만, 이 상한 덕분에 행 전체로 늘어나지 않고 제 폭에서 멈춘다.
|
|
1092
|
+
|
|
1093
|
+
| 컴포넌트 | `size="sm"` | `size="md"` |
|
|
1094
|
+
| --- | --- | --- |
|
|
1095
|
+
| `SDatePicker` | md | lg |
|
|
1096
|
+
| `SDateRangePicker` | lg | xl |
|
|
1097
|
+
| `STimePicker` | md | lg |
|
|
1098
|
+
| `STimeRangePicker` | md | lg (오전/오후 표시는 두 사이즈 모두 lg) |
|
|
1099
|
+
|
|
1100
|
+
`SDateRangePicker` 가 한 등급씩 위인 것은 값이 `YYYY-MM-DD ~ YYYY-MM-DD` 로 두 배가 넘기 때문이다. 같은 이유로 `STimeRangePicker` 의 오전/오후 모드도 sm 에서 한 등급 위를 쓴다 — 그 모드의 최소 폭이 md 등급을 이미 넘어, 그대로 두면 하한이 상한을 넘어 상한이 무력해진다.
|
|
1021
1101
|
|
|
1022
1102
|
#### 3-7-5. SField 를 직접 쓰는 경우
|
|
1023
1103
|
|
|
@@ -1065,7 +1145,7 @@ const columns: STableColumn[] = [
|
|
|
1065
1145
|
|
|
1066
1146
|
- 페이지 골격에서 콘텐츠를 묶는 섹션은 **사실상 전부 `SSectionHeaderCard`** 다 (§4-4·§4-5). 제목·필수 표시·도움말·헤더 우측 액션이 전부 여기 붙는다.
|
|
1067
1147
|
- **카드 안에 카드를 겹치지 않는다.** 섹션 안을 더 나눠야 하면 `SDivider` 로 끊거나(§3-6) 섹션을 둘로 분리한다.
|
|
1068
|
-
- 안쪽 여백은 `SSectionHeaderCard
|
|
1148
|
+
- 안쪽 여백은 `SSectionHeaderCard` 의 `padding` prop 으로 준다 — `p-sd-*` 를 직접 주지 않는다 (§2-2).
|
|
1069
1149
|
|
|
1070
1150
|
#### 3-7-9. SLinearProgress vs SCircleProgress
|
|
1071
1151
|
|
|
@@ -1094,6 +1174,23 @@ const columns: STableColumn[] = [
|
|
|
1094
1174
|
- 검색 실행 시점이 다르다 — `SKeyValueTable` 필터는 앱이 검색 버튼을 직접 놓지만, `SChipFilter` 는 편집 팝오버가 닫히거나 "검색" 을 누를 때 `onSearch` 가 값 맵과 함께 호출된다. 값이 바뀌지 않았으면 호출되지 않는다.
|
|
1095
1175
|
- 함께 걸어야 하는 조건(예: 기간 중 하나는 필수)이 있으면 `fields` 를 그룹으로 넘긴다. 규칙을 못 채운 동안 경고 툴팁이 떠 있고 `onSearch` 가 막힌다.
|
|
1096
1176
|
|
|
1177
|
+
#### 3-7-12. 이미지 — SImage
|
|
1178
|
+
|
|
1179
|
+
사진·썸네일은 `<img>` 를 직접 쓰지 않고 `SImage` 를 쓴다. **로딩·실패 상태를 컴포넌트가 이미 처리하기 때문이다.**
|
|
1180
|
+
|
|
1181
|
+
- **로딩 스피너와 실패 표시를 앱이 만들지 않는다.** `src` 가 없거나 로드에 실패하면 빈 이미지 아이콘이, 로딩 중에는 스피너가 자동으로 놓인다. 크기는 상자 높이에 비례하므로 썸네일이든 큰 미리보기든 따로 맞출 것이 없다.
|
|
1182
|
+
- **크기는 `ratio` 와 너비로 준다.** `ratio` 기본값이 `1`(정사각형)이라 너비만 주면 정사각형이 된다. `className`/`style` 로 높이를 직접 주면 그쪽이 이기고 `ratio` 는 무시된다.
|
|
1183
|
+
- 상자를 채우는 방식은 `fit`(기본 `cover`), 붙는 위치는 `position` 이다. 안쪽 `<img>` 에 네이티브 속성이 필요하면 `imgProps` 로 넘긴다 — 목록에서 고스트 드래그를 막는 `imgProps={{ draggable: false }}` 가 대표적이다.
|
|
1184
|
+
- 썸네일이 많은 목록에서는 `loadingShowDelay` 를 준다. 캐시된 이미지가 즉시 로드될 때 스피너가 한 프레임 번쩍이는 것을 막는다.
|
|
1185
|
+
|
|
1186
|
+
```tsx
|
|
1187
|
+
✅ <SImage src={item.thumbnailUrl} alt={item.name} style={{ width: 64 }} /> {/* 정사각 썸네일 */}
|
|
1188
|
+
✅ <SImage src={banner} ratio={16 / 9} className="w-full" /> {/* 가로형 배너 */}
|
|
1189
|
+
|
|
1190
|
+
❌ <img src={item.thumbnailUrl} /> {/* 로딩·실패 상태가 없다 */}
|
|
1191
|
+
❌ {loading ? <SCircleProgress indeterminate /> : <SImage src={url} />} {/* SImage 가 이미 한다 */}
|
|
1192
|
+
```
|
|
1193
|
+
|
|
1097
1194
|
---
|
|
1098
1195
|
|
|
1099
1196
|
## 4. 페이지 레시피 — 표준 골격
|
|
@@ -1120,15 +1217,27 @@ export default function AppShell({
|
|
|
1120
1217
|
children,
|
|
1121
1218
|
header,
|
|
1122
1219
|
scrollEndSpacing,
|
|
1123
|
-
|
|
1220
|
+
contentHeight,
|
|
1221
|
+
}: {
|
|
1222
|
+
children: React.ReactNode;
|
|
1223
|
+
header?: SPageHeaderProps;
|
|
1224
|
+
scrollEndSpacing?: boolean;
|
|
1225
|
+
contentHeight?: SPageContentHeight;
|
|
1226
|
+
}) {
|
|
1124
1227
|
return (
|
|
1125
1228
|
<SLayout type="box" header="fix">
|
|
1126
1229
|
{/* type/header/folded 는 SLayout 에만 준다 — SGnb 는 context 에서 읽는다 */}
|
|
1127
1230
|
<SGnb items={MENU} value={current} onValueChange={navigate} logo={<Logo />} />
|
|
1128
1231
|
{/* 콘텐츠 패딩은 SPage 가 토큰으로 넣는다 — p-sd-* 로 덮어쓰지 않는다 */}
|
|
1129
1232
|
{/* 스크롤 끝 여백도 SPage 가 넣는다. 끄는 건 페이지네이션 있는 목록뿐이라 페이지가 정한다 */}
|
|
1233
|
+
{/* 본문이 남은 높이를 채우는 목록 페이지는 contentHeight="fill" 을 넘긴다 (§4-2) */}
|
|
1130
1234
|
{/* header 는 페이지마다 달라 AppShell 이 그대로 받아 넘긴다 — 페이지 제목은 여기서 만들지 않는다 */}
|
|
1131
|
-
<SPage
|
|
1235
|
+
<SPage
|
|
1236
|
+
background="frame"
|
|
1237
|
+
scrollEndSpacing={scrollEndSpacing}
|
|
1238
|
+
contentHeight={contentHeight}
|
|
1239
|
+
header={header}
|
|
1240
|
+
>
|
|
1132
1241
|
{children}
|
|
1133
1242
|
</SPage>
|
|
1134
1243
|
</SLayout>
|
|
@@ -1170,7 +1279,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
1170
1279
|
|
|
1171
1280
|
**최소 너비는 `SLayout` 이 보장한다 — 앱이 `min-w-*` 를 직접 주지 않는다.** 창이 최소 너비(`SLAYOUT_MIN_WIDTH`, GNB 포함한 전체 기준)보다 좁아지면 GNB·상단바는 제자리에 남고 **`SPage` 안에만 가로 스크롤이 생긴다.** 문서(브라우저 창)에는 가로 스크롤이 생기지 않는다. 그래서 셸을 감싸는 요소에 `min-width` 나 `overflow-x` 를 걸지 않는다 — 걸면 창 전체가 스크롤되어 GNB 가 화면 밖으로 밀린다.
|
|
1172
1281
|
|
|
1173
|
-
**셸의 `SPage` 는 모든 페이지가 공유하므로,
|
|
1282
|
+
**셸의 `SPage` 는 모든 페이지가 공유하므로, 페이지마다 달라지는 것은 페이지가 셸에 알려야 한다.** 위처럼 프레임 컴포넌트가 `scrollEndSpacing` · `contentHeight` 를 받아 그대로 넘기고, 페이지네이션이 있는 목록 페이지만 `contentHeight="fill"` 을 준다 (§4-2). 나머지 페이지는 넘기지 않으면 기본값(`auto`, 스크롤 끝 여백 켬)이 적용된다.
|
|
1174
1283
|
|
|
1175
1284
|
**상단바 배치는 `header` 가 정한다.** 요소 순서가 달라지므로 슬롯을 채우기 전에 어느 쪽인지부터 정한다.
|
|
1176
1285
|
|
|
@@ -1192,7 +1301,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
1192
1301
|
topContent={
|
|
1193
1302
|
/* 남는 폭 전체를 받는다 — 왼쪽은 그대로, 오른쪽 끝은 ml-auto */
|
|
1194
1303
|
<div className="flex w-full items-center gap-sd-8">
|
|
1195
|
-
<
|
|
1304
|
+
<SSearchInput value={keyword} onValueChange={setKeyword} onSearch={runSearch} placeholder="통합 검색" />
|
|
1196
1305
|
<SButton size="sm" color="neutral" outline label="내 계정" className="ml-auto" onClick={openAccount} />
|
|
1197
1306
|
</div>
|
|
1198
1307
|
}
|
|
@@ -1209,7 +1318,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
1209
1318
|
{/* 접히면 menuTop·menuFooter 가 함께 빠지므로, 폴드 레일에 남길 것만 foldedTop 으로 따로 준다 */}
|
|
1210
1319
|
<SGnb
|
|
1211
1320
|
items={MENU} value={current} onValueChange={navigate} useRail
|
|
1212
|
-
menuTop={<
|
|
1321
|
+
menuTop={<SSearchInput value={keyword} onValueChange={setKeyword} placeholder="메뉴 검색" />}
|
|
1213
1322
|
menuFooter={<AccountRow />}
|
|
1214
1323
|
foldedTop={<SGhostButton icon="search" size="sm" ariaLabel="메뉴 검색" onClick={openSearch} />}
|
|
1215
1324
|
/>
|
|
@@ -1228,7 +1337,9 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
1228
1337
|
- **페이지 제목 줄에는 이 페이지의 주요 액션을 두지 않는다.** 부가적인 것만 `header.slot` 에 `SButton size="sm"` 으로 온다 (§4-1 "페이지 헤더 사용 규칙").
|
|
1229
1338
|
- **주요 액션(등록 등)은 `STableBar` 의 `rightActions`** 에 둔다.
|
|
1230
1339
|
- **선택 상태 액션(선택 삭제 등)은 `STableBar` 의 `actions`** 에 둔다. `actions` 슬롯은 건수 요약이 있으면 앞에 구분선(`SDivider`)을 **자동으로** 넣으므로 직접 구분선을 만들지 않는다.
|
|
1231
|
-
- **페이지네이션이 있으면
|
|
1340
|
+
- **페이지네이션이 있으면 본문이 남은 높이를 채우게 한다** — `AppShell` 에 `contentHeight="fill"` 을 넘긴다. 페이지가 통째로 스크롤되면 페이지네이션이 화면 밖으로 밀려 "여기서 끝"이 읽히지 않는다. `fill` 이면 **표만 자기 안에서 스크롤하고 페이지네이션은 하단에 고정**된다.
|
|
1341
|
+
- 본문 루트에 `h-full min-h-0` 으로 세로 축을 잇고, 남은 높이를 먹을 `STable` 에 `min-h-0 flex-1` 을 준다. 이 사슬이 하나라도 끊기면 표가 높이를 못 잡는다.
|
|
1342
|
+
- `fill` 에서는 페이지가 스크롤하지 않으므로 **`scrollEndSpacing` 은 무시된다** — 따로 끄지 않는다 (§2-2).
|
|
1232
1343
|
|
|
1233
1344
|
```tsx
|
|
1234
1345
|
import {
|
|
@@ -1276,9 +1387,10 @@ export default function ProductListPage() {
|
|
|
1276
1387
|
// 이 페이지의 주요 액션이 아니라 부가 액션 — slot 은 sm 버튼으로만 채운다
|
|
1277
1388
|
slot: <SButton size="sm" color="neutral" outline label="이용 가이드" onClick={openGuide} />,
|
|
1278
1389
|
}}
|
|
1279
|
-
|
|
1390
|
+
contentHeight="fill" // 표가 남은 높이를 채우고 페이지네이션이 하단에 고정된다
|
|
1280
1391
|
>
|
|
1281
|
-
|
|
1392
|
+
{/* h-full min-h-0 → STable 의 min-h-0 flex-1 로 세로 축이 이어진다 */}
|
|
1393
|
+
<div className="flex h-full min-h-0 flex-col gap-sd-12">
|
|
1282
1394
|
{/* 필터 — search 를 켜면 우측에 검색 패널이 붙는다 */}
|
|
1283
1395
|
<SKeyValueTable
|
|
1284
1396
|
fields={filterFields}
|
|
@@ -1303,7 +1415,9 @@ export default function ProductListPage() {
|
|
|
1303
1415
|
}
|
|
1304
1416
|
/>
|
|
1305
1417
|
|
|
1418
|
+
{/* 남은 높이를 채우고 본문만 스크롤한다 — 페이지네이션 바는 표 안에서 하단 고정 */}
|
|
1306
1419
|
<STable
|
|
1420
|
+
className="min-h-0 flex-1"
|
|
1307
1421
|
columns={columns}
|
|
1308
1422
|
rows={rows}
|
|
1309
1423
|
rowKey="id"
|
|
@@ -1389,7 +1503,7 @@ export default function ProductCreatePage() {
|
|
|
1389
1503
|
|
|
1390
1504
|
- 조회 값은 `type: 'text'` 행으로 표시한다. **상태·분류 태그도 별도 영역이 아니라 표의 한 행**으로 넣는다 (`render` 에 `STag`).
|
|
1391
1505
|
- 행이 많아지면 **유형별로 섹션을 나누고, 각 섹션을 `SSectionHeaderCard` 로 감싼다.**
|
|
1392
|
-
|
|
1506
|
+
섹션 제목은 `title` prop 으로, 바디 여백은 `padding` prop 으로 준다.
|
|
1393
1507
|
- **수정·삭제 버튼은 하단에 둔다.** 내용이 짧아 우측 상단에 두는 변형도 있으나 기본은 하단이다.
|
|
1394
1508
|
|
|
1395
1509
|
```tsx
|
|
@@ -1422,24 +1536,18 @@ export default function ProductDetailPage() {
|
|
|
1422
1536
|
// 목록에서 들어온 상세 페이지 — onBack 으로 뒤로가기를 준다
|
|
1423
1537
|
<AppShell header={{ fix: true, title: '클래식 셔츠', onBack: goList }}>
|
|
1424
1538
|
<div className="flex flex-col gap-sd-12">
|
|
1425
|
-
<SSectionHeaderCard>
|
|
1426
|
-
<
|
|
1427
|
-
<SSectionHeaderCard.Body>
|
|
1428
|
-
<SKeyValueTable fields={basicFields} values={product} />
|
|
1429
|
-
</SSectionHeaderCard.Body>
|
|
1539
|
+
<SSectionHeaderCard title="기본 정보" marker thickness="accent">
|
|
1540
|
+
<SKeyValueTable fields={basicFields} values={product} />
|
|
1430
1541
|
</SSectionHeaderCard>
|
|
1431
1542
|
|
|
1432
|
-
|
|
1433
|
-
|
|
1434
|
-
|
|
1435
|
-
|
|
1436
|
-
|
|
1437
|
-
|
|
1438
|
-
|
|
1439
|
-
/>
|
|
1440
|
-
<SSectionHeaderCard.Body>
|
|
1441
|
-
<SKeyValueTable fields={priceFields} values={product} />
|
|
1442
|
-
</SSectionHeaderCard.Body>
|
|
1543
|
+
{/* 헤더 우측에 액션이 필요하면 slot 을 쓴다 */}
|
|
1544
|
+
<SSectionHeaderCard
|
|
1545
|
+
title="가격 정보"
|
|
1546
|
+
marker
|
|
1547
|
+
helpText={['부가세 포함 금액입니다.']}
|
|
1548
|
+
slot={<SButton size="sm" color="secondary" label="이력" onClick={openHistory} />}
|
|
1549
|
+
>
|
|
1550
|
+
<SKeyValueTable fields={priceFields} values={product} />
|
|
1443
1551
|
</SSectionHeaderCard>
|
|
1444
1552
|
|
|
1445
1553
|
{/* 액션은 하단 — 목록(되돌리기)은 왼쪽 끝, 실행 액션은 오른쪽 끝 */}
|
|
@@ -1488,8 +1596,8 @@ export default function ProductDetailPage() {
|
|
|
1488
1596
|
- [ ] 텍스트 회색 위계를 순차 적용했는가 (기본 → `text-fg-secondary` → `text-fg-tertiary`, 단계 건너뛰기 ❌)
|
|
1489
1597
|
- [ ] `SPage`·`SPopup` 의 기본 패딩을 `p-sd-*` 로 덮어쓰지 않았는가, 블록·섹션 **간격**이 `gap-sd-12` 인가 (`gap-sd-16`/`gap-sd-24` ❌ — 24 는 안쪽 여백에만 열린다)
|
|
1490
1598
|
- [ ] 섹션·패널의 안쪽 **여백**이 §2-2 판정과 맞는가 (덩어리 두 종류 → 16 / 세 종류 이상 → 24, 서면 16)
|
|
1491
|
-
- [ ] `SSectionHeaderCard
|
|
1492
|
-
- [ ] 자체 스크롤하는 패널의 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` 이 있는가, 페이지네이션 있는 목록에서 `
|
|
1599
|
+
- [ ] `SSectionHeaderCard` 의 여백을 `p-sd-*` 가 아니라 `padding` prop 으로 줬는가
|
|
1600
|
+
- [ ] 자체 스크롤하는 패널의 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` 이 있는가, 페이지네이션 있는 목록에서 `contentHeight="fill"` 을 넘기고 `h-full min-h-0` → `STable` 의 `min-h-0 flex-1` 사슬을 이었는가
|
|
1493
1601
|
- [ ] 같은 컴포넌트를 나열할 때 §2-2 그룹 간격을 썼는가 (체크박스 가로 `gap-sd-24` 등)
|
|
1494
1602
|
- [ ] 페이지가 §4의 표준 골격에서 시작했는가
|
|
1495
1603
|
- [ ] `header.fix` 가 프로젝트 전체와 같은 값인가 (다른 페이지와 다르게 섞어 쓰지 않았는가, §4-1)
|
|
@@ -1576,7 +1684,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
1576
1684
|
- oceanblue: 15 25 50 60 65 70 75 80 85 90 95 99
|
|
1577
1685
|
- brilliantblue: 10 20 25 40 50 60 70 75 80 85 90 95 99 05
|
|
1578
1686
|
- bg: screen frame brand subtle accent accentLight accentBright accentFaint deep danger dangerLight warning caution progress success successLight neutralLight neutralBright tableHeader
|
|
1579
|
-
- fg: primary secondary tertiary quaternary brand subtleWarm subtleCool deep success dangerLight accent accentLight danger warning inverse
|
|
1687
|
+
- fg: primary secondary tertiary quaternary brand subtleWarm subtleCool deep success successLight dangerLight accent accentLight danger warning inverse
|
|
1580
1688
|
- border: default strong bold accent accentLight danger warning success
|
|
1581
1689
|
- disabled: bg text icon border
|
|
1582
1690
|
- link: accent
|
|
@@ -1702,6 +1810,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
1702
1810
|
--sys-color-fg-subtleCool
|
|
1703
1811
|
--sys-color-fg-subtleWarm
|
|
1704
1812
|
--sys-color-fg-success
|
|
1813
|
+
--sys-color-fg-successLight
|
|
1705
1814
|
--sys-color-fg-tertiary
|
|
1706
1815
|
--sys-color-fg-warning
|
|
1707
1816
|
--sys-color-field-bg-default
|
|
@@ -1723,7 +1832,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
1723
1832
|
--sys-color-link-accent
|
|
1724
1833
|
--sys-color-navigation-gnb-bg-dark
|
|
1725
1834
|
|
|
1726
|
-
## 3. 컴포넌트 인덱스 (
|
|
1835
|
+
## 3. 컴포넌트 인덱스 (66종)
|
|
1727
1836
|
|
|
1728
1837
|
**Props 는 이 문서에 없다.** 쓸 컴포넌트를 정했으면 그 컴포넌트의 README 를 읽는다.
|
|
1729
1838
|
|
|
@@ -1732,4 +1841,4 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
|
|
|
1732
1841
|
예) SButton 을 쓴다면 `dist/components/SButton/README.md`.
|
|
1733
1842
|
prop 을 추측해서 쓰지 말고 반드시 README 로 확인한다 (분류별 용도는 §1 의 "전체 컴포넌트 인덱스" 참조).
|
|
1734
1843
|
|
|
1735
|
-
SActionModal · SBadge · SBarcodeInput · SButton · SCalendar · SCallout · SCard · SCheckbox · SChip · SChipFilter · SChipInput · SCircleProgress · SConfirmModal · SDatePicker · SDateRangePicker · SDivider · SDraggableItem · SDraggableList · SDrawer · SDropdownButton · SExpansionItem · SExpansionList · SField · SFilePicker · SForm · SGhostButton · SGnb · SGuide · SIcon · SInput · SKeyValueTable · SLayout · SLinearProgress · SList · SListItem · SLoadingContainer · SLoadingModal · SModal · SNumberInput · SPage · SPagination · SPopover · SPopup · SPortal · SRadio · SRadioButton · SScrollArea · SSectionHeaderCard · SSelect · SSplitter · SStepper · SSwitch · STable · STableBar · STabs · STag · STextLink · STextarea · STimePicker · STimeRangePicker · SToast · SToggle · STooltip · STree
|
|
1844
|
+
SActionModal · SBadge · SBarcodeInput · SButton · SCalendar · SCallout · SCard · SCheckbox · SChip · SChipFilter · SChipInput · SCircleProgress · SConfirmModal · SDatePicker · SDateRangePicker · SDivider · SDraggableItem · SDraggableList · SDrawer · SDropdownButton · SExpansionItem · SExpansionList · SField · SFilePicker · SForm · SGhostButton · SGnb · SGuide · SIcon · SImage · SInput · SKeyValueTable · SLayout · SLinearProgress · SList · SListItem · SLoadingContainer · SLoadingModal · SModal · SNumberInput · SPage · SPagination · SPopover · SPopup · SPortal · SRadio · SRadioButton · SScrollArea · SSearchInput · SSectionHeaderCard · SSelect · SSplitter · SStepper · SSwitch · STable · STableBar · STabs · STag · STextLink · STextarea · STimePicker · STimeRangePicker · SToast · SToggle · STooltip · STree
|