@x-plat/design-system 0.16.1 → 0.16.3

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.
@@ -34,6 +34,7 @@ const [guide, setGuide] = useState(true);
34
34
  | prevLabel | `string` | `"이전"` | |
35
35
  | skipLabel | `string` | `"건너뛰기"` | |
36
36
  | doneLabel | `string` | `"다 봤어요"` | |
37
+ | width | `number \| string` | `380` | 말풍선 너비. 숫자면 px. 화면이 좁으면 그만큼 줄어든다 |
37
38
 
38
39
  ### TourStep
39
40
 
@@ -58,11 +59,18 @@ const [guide, setGuide] = useState(true);
58
59
 
59
60
  ## 스크롤
60
61
 
61
- 대상이 화면 밖이면 데려온다. **페이지가 스크롤하든 안쪽 상자가 스크롤하든**
62
- 브라우저가 알아서 한다.
62
+ **그 단계 차례가 되면 대상을 화면 안으로 데려온다.** 페이지가 스크롤하든 안쪽
63
+ 상자가 스크롤하든 브라우저가 알아서 한다(`scrollIntoView`). 부드럽게 움직이는
64
+ 동안 구멍과 말풍선이 **프레임마다 따라붙고**, 멎으면 따라붙기도 멈춘다.
63
65
 
64
- 그 뒤 사용자가 굴리면 구멍이 **한 프레임 늦게** 따라온다. 화면 전체가 어두운
65
- 상태라 눈에 잘 띄지 않지만, 알고는 있어야 한다.
66
+ 대상이 아직 안 그려졌으면 **1초까지 기다린다.** 앞 단계에서 눌러야 나타나는
67
+ 요소를 가리키는 경우가 있어서다. 그래도 없으면 구멍 없이 말풍선만 띄운다.
68
+
69
+ 안내 중에 사용자가 직접 굴리면 구멍이 **한 프레임 늦게** 따라온다. 화면 전체가
70
+ 어두운 상태라 눈에 잘 띄지 않지만, 알고는 있어야 한다.
71
+
72
+ > `steps` 를 인라인 배열로 넘겨도 된다. 단계 바뀜은 **차례(index)** 로만
73
+ > 판단하므로 배열이 매 렌더 새로 만들어져도 스크롤이 다시 시작되지 않는다.
66
74
 
67
75
  ## 다시 보지 않기
68
76
 
@@ -70,10 +78,26 @@ const [guide, setGuide] = useState(true);
70
78
  (건너뜀) 인지만 알려 주고, 저장할지·어디에 할지는 쓰는 쪽이 정한다 —
71
79
  화면마다 다르고 저장 자리(로컬·서버)도 제각각이다.
72
80
 
73
- ## 눌림
81
+ ## 말풍선
82
+
83
+ 설명이 길면 **설명 칸만 구른다.** 머리말(차례·제목)과 버튼은 제자리에 있다.
84
+
85
+ 크기는 **내용만큼** 잡고 화면보다 길 때만 화면에 맞춘다. 대상 둘레에 자리가
86
+ 모자라도 말풍선을 줄이지 않는다 — 자리를 옮겨서 피한다. 줄이면 읽을 수가 없다.
87
+
88
+ 너비는 `width` 로 바꾼다.
89
+
90
+ ## 눌림과 스크롤
91
+
92
+ 안내 중에는 **아무것도 안 눌리고 굴러가지도 않는다** — 구멍 안쪽까지 포함해서.
93
+ 가리키는 것만 보여 주고, 실제로 만지는 것은 안내가 끝난 뒤다.
94
+
95
+ 막는 것은 **사용자가 직접 구르는 것**(휠·손가락·키)뿐이다. `body` 에
96
+ `overflow: hidden` 을 거는 흔한 방법은 페이지만 막아서, DS `Layout` 처럼 본문만
97
+ 구르는 화면에서는 아무것도 안 막힌다. 입력을 막으면 어느 상자가 구르든 걸린다.
74
98
 
75
- 안내 중에는 **아무것도 안 눌린다** — 구멍 안쪽까지 포함해서. 가리키는 것만
76
- 보여 주고, 실제로 누르는 것은 안내가 끝난 뒤다.
99
+ 투어가 대상을 데려오는 스크롤은 **그대로 돈다** — 입력만 막기 때문이다.
100
+ 말풍선 안 설명도 구를 수 있다.
77
101
 
78
102
  ## 키보드
79
103
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@x-plat/design-system",
3
- "version": "0.16.1",
3
+ "version": "0.16.3",
4
4
  "description": "XPLAT UI Design System",
5
5
  "author": "XPLAT WOONG",
6
6
  "main": "dist/index.cjs",