@ihabdevteam/core 0.425.0 → 0.428.0
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/CHANGELOG.md +1080 -0
- package/dist/components.cjs.js +178 -173
- package/dist/components.esm.css +2 -2
- package/dist/hooks.cjs.js +5 -5
- package/dist/i18n.cjs.js +3 -3
- package/dist/ihabdevteam-core-tokens.css +1 -1
- package/dist/ihabdevteam-core.cjs.js +194 -189
- package/dist/ihabdevteam-core.css +1 -1
- package/dist/ihabdevteam-core.d.ts +111 -8
- package/dist/packages/core/src/components/BarChart.css +13 -0
- package/dist/packages/core/src/components/BarChart.js +21 -1
- package/dist/packages/core/src/components/BulkBar.css +6 -2
- package/dist/packages/core/src/components/DatePicker.d.ts +17 -1
- package/dist/packages/core/src/components/DatePicker.js +9 -2
- package/dist/packages/core/src/components/Dropdown.js +32 -8
- package/dist/packages/core/src/components/FileUpload.js +1 -1
- package/dist/packages/core/src/components/Landing/Landing.css +8 -2
- package/dist/packages/core/src/components/Landing/LandingCard.js +1 -1
- package/dist/packages/core/src/components/PanelRow.d.ts +8 -0
- package/dist/packages/core/src/components/PanelRow.js +2 -2
- package/dist/packages/core/src/components/PassCard/PassCardBgIHAB.js +6 -2
- package/dist/packages/core/src/components/PassCard/PassCardBgLeftColorGrid.js +3 -0
- package/dist/packages/core/src/components/PassCard/PassCardBgSoundLine.js +2 -2
- package/dist/packages/core/src/components/PassCard/PassCardBgSoundLineV1.js +3 -0
- package/dist/packages/core/src/components/PassCard/PassCardBgSoundMove.js +1 -1
- package/dist/packages/core/src/components/PassCard/PassCardBgSoundMoveV1.js +3 -0
- package/dist/packages/core/src/components/PassCard/PassCardBgTalk.js +1 -1
- package/dist/packages/core/src/components/PassCard/PassCardBgTalkV1.js +1 -1
- package/dist/packages/core/src/components/PassCard/PassCardBgTwoCircle.js +1 -1
- package/dist/packages/core/src/components/PaymentPlan.d.ts +15 -0
- package/dist/packages/core/src/components/PaymentPlan.js +4 -2
- package/dist/packages/core/src/components/Popup/DeviceSideTable.js +25 -1
- package/dist/packages/core/src/components/Popup/WordDataUpdatePopup.css +11 -3
- package/dist/packages/core/src/components/Report/ReportInfoPanel.css +12 -1
- package/dist/packages/core/src/components/SideNav.css +44 -0
- package/dist/packages/core/src/components/SoundCompass.js +18 -1
- package/dist/packages/core/src/components/Table.js +30 -1
- package/dist/packages/core/src/components/Tabs.js +1 -1
- package/dist/packages/core/src/components/TextField.js +25 -6
- package/dist/packages/core/src/components/Tooltip/WordImageTooltip.js +14 -5
- package/dist/packages/core/src/components/Training/CategoryIcon.js +8 -1
- package/dist/packages/core/src/components/Training/TrainingWordCard.js +15 -1
- package/dist/packages/core/src/components/UpdateAlert.css +11 -5
- package/dist/packages/core/src/components/Word/WordSearchResultBlock.css +5 -0
- package/dist/packages/core/src/hooks/useWordAttributeFilter.d.ts +22 -1
- package/dist/packages/core/src/hooks/useWordAttributeFilter.js +65 -1
- package/dist/packages/core/src/hooks/useWordTrainingFilter.d.ts +6 -0
- package/dist/packages/core/src/hooks/useWordTrainingFilter.js +6 -2
- package/dist/packages/core/src/hooks/wordTrainingFilterSections.d.ts +3 -0
- package/dist/packages/core/src/hooks/wordTrainingFilterSections.js +9 -3
- package/dist/packages/core/src/i18n/locales/en.json +8 -1
- package/dist/packages/core/src/i18n/locales/ko.json +7 -0
- package/dist/packages/core/src/tokens.css +9 -1
- package/dist/packages/core/src/utils/lucideIconSet.js +6 -0
- package/dist/packages/core/src/utils/phonemePairSearch.d.ts +2 -0
- package/dist/packages/core/src/utils/phonemePairSearch.js +13 -4
- package/dist/packages/core/src/utils/phonemePairSearchTypes.d.ts +5 -6
- package/dist/packages/core/src/utils/wordAttributeFilterCodes.d.ts +79 -3
- package/dist/packages/core/src/utils/wordAttributeFilterCodes.js +238 -33
- package/dist/packages/core/src/version.d.ts +1 -1
- package/dist/packages/core/src/version.js +1 -1
- package/dist/utils.cjs.js +167 -162
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,1086 @@ All notable changes to this project will be documented in this file.
|
|
|
7
7
|
> 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
|
|
8
8
|
> 제 이야기를 못 찾는다.
|
|
9
9
|
|
|
10
|
+
## 0.428.0 — 난이도 묶음이 **이름**을 받는다 (`label`)
|
|
11
|
+
|
|
12
|
+
사장님 지시(2026-11-10): *"아냐 등급을 모두 빼고 3개의 분류로 하자. 미취학, 초등 저학년,
|
|
13
|
+
초등 고학년"*.
|
|
14
|
+
|
|
15
|
+
`WordGradeBand.label?: string` — `showAge: false` 묶음의 칩 이름이 `N등급` 대신 이 글자가 된다.
|
|
16
|
+
**칩 코드는 그대로 `'1'`·`'2'`·`'3'`** 이다. 낱말의 `grade` 와 맞대는 쪽이므로 저장된 표는 고칠
|
|
17
|
+
것이 없다.
|
|
18
|
+
|
|
19
|
+
```ts
|
|
20
|
+
const bands = [
|
|
21
|
+
{ grade: 1, maxAge: 6, showAge: false, label: '미취학' },
|
|
22
|
+
{ grade: 2, maxAge: 9, showAge: false, label: '초등 저학년' },
|
|
23
|
+
{ grade: 3, maxAge: null, showAge: false, label: '초등 고학년' },
|
|
24
|
+
]
|
|
25
|
+
// → 미취학 · 초등 저학년 · 초등 고학년 · 없음
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
- **이름표가 코드로 되읽힌다.** `wordAttributeValueCodeOf` · `toWordAttributeFilterCodes` ·
|
|
29
|
+
`matchesFilters` 가 이름표를 읽는다. 숫자 길보다 먼저 보므로 `초등 3학년` 같은 이름이 3등급으로
|
|
30
|
+
새지 않는다. 거꾸로 `wordAttributeFilterFromCodes` · `wordAttributeValueLabelOf` 는 코드를 이름으로
|
|
31
|
+
낸다. 되읽기 함수들은 묶음을 받지 않으므로 `resolveGradeBands` 가 꼴 맞는 묶음을 볼 때마다 이름표를
|
|
32
|
+
적어 둔다. 묶음이 없거나 어긋나면 적어 둔 것을 비우지 않는다.
|
|
33
|
+
- **겹치는 이름은 안 받는다.** 다른 칩의 글자(`3세` · `10세 이상` · `2등급` · `없음` · `'4'`)와 같거나
|
|
34
|
+
두 묶음이 같은 이름이면 묶음 전체를 꼴 어긋남으로 보고 옛 줄로 선다. 이름표가 곧 열쇠라 겹치면
|
|
35
|
+
칩은 켜져 보이는데 엉뚱한 코드로 걸린다. 빈 글자는 안 준 것으로 본다.
|
|
36
|
+
- **설명도 이름을 쓴다** — `미취학: 1세~6세 낱말입니다.` 나이 칩 묶음과 이름 묶음이 섞이면 나이
|
|
37
|
+
묶음 줄도 `등급` 이라 하지 않는다(`1세~6세: 나이로 나눈 낱말입니다.`, 새 i18n 열쇠
|
|
38
|
+
`wordSearch.filter.difficultyInfoBandAgeNamed`).
|
|
39
|
+
- `showAge: true` 묶음의 `label` 은 읽지 않는다. 이름 없는 옛 묶음은 그대로 `N등급` 이다.
|
|
40
|
+
- 영어 화면에서도 이름은 어드민이 적은 글자 그대로다.
|
|
41
|
+
|
|
42
|
+
## 0.427.0 — 난이도가 어드민의 **등급 묶음**을 받는다 · 나이 칩은 **등급을 안 본다**
|
|
43
|
+
|
|
44
|
+
### 난이도 거르개가 어드민이 정한 **등급 묶음**을 받는다 (청 (389))
|
|
45
|
+
|
|
46
|
+
사장님 지시(2026-11-10): *"데이터는 등급 제거하고 나이만 입력하게 하고 그 나이묶음을 등급으로
|
|
47
|
+
사용하는게 맞을거 같다. 1등급 : 1~6세 · 2등급 : 7, 8세 · 3등급 : 9, 10세 · 4등급 : 11, 12세 ·
|
|
48
|
+
5등급 : 13+"* · *"난이도에서는 등급으로 표현하냐 마냐를 선택해서 1등급은 나이로, 2~5등급은
|
|
49
|
+
등급으로 표현을 선택할 수 있도록"*.
|
|
50
|
+
|
|
51
|
+
이제 낱말마다 **나이(1~99)만 사람이 적고**, 등급은 말귀 DB 트리거가 나이 묶음으로 매긴다(라이브:
|
|
52
|
+
1등급 4,524 · 2등급 2,827 · 3등급 5,850 · 4등급 10,184). 묶음은 말귀 `app_config.word_grade_bands`
|
|
53
|
+
한 줄이고 어드민이 고친다. 코어가 할 일은 **어떻게 보일지**뿐이다.
|
|
54
|
+
|
|
55
|
+
```tsx
|
|
56
|
+
buildGradeSection(t, keys, { bands }) // 단어표·대립쌍표
|
|
57
|
+
useWordTrainingFilter(groupKey, caps, { gradeBands: bands }) // 단어훈련
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
#### ① 묶음으로 칩을 짓는다
|
|
61
|
+
|
|
62
|
+
묶음마다 `showAge` 면 그 나이들이 `N세` 칩으로(위가 열린 묶음이면 `N세 이상` 하나), 아니면
|
|
63
|
+
`N등급` 칩 하나, 맨 끝에 `없음`. 사장님 묶음이면 `1세`…`6세` · `2등급`…`5등급` · `없음` 이다.
|
|
64
|
+
**안 주면 옛 줄 그대로**(`3세`~`7세` · `2`~`4등급` · `없음`) — 묶음을 모르는 소비자는 아무것도 안
|
|
65
|
+
바뀐다.
|
|
66
|
+
|
|
67
|
+
**꼴이 어긋난 묶음은 고쳐 쓰지 않고 통째로 버린다**(옛 줄로 선다). 하나를 건너뛰고 나머지를
|
|
68
|
+
이어 쓰면 칩의 나이와 DB 가 매긴 등급이 어긋나 `5세` 칩이 2등급 낱말을 건지는데, 화면에는 아무
|
|
69
|
+
표시가 없다. 맞는 꼴은 말귀 서버 검사(`admin_set_word_grade_bands`)와 같다 — 다만 꼭 다섯일 것은
|
|
70
|
+
안 따지고, 다섯을 넘으면 안 받는다(코어가 읽을 줄 아는 등급 코드가 `'1'`~`'5'` 다).
|
|
71
|
+
|
|
72
|
+
#### ② **나이 칩은 등급을 안 본다** — `age === n`
|
|
73
|
+
|
|
74
|
+
전에는 `grade === '1' && age === n` 이었다(청 (342)). 나이가 1등급 낱말에만 적혀 있던 때는 맞았는데,
|
|
75
|
+
**7세가 2등급이 되자 `7세` 칩이 한 낱말도 안 건졌다**(말귀 라이브 실측). 거르개는 멀쩡히 켜져
|
|
76
|
+
보이는데 0건인, `없음` 이 2026-10-12 에 밟았던 그 꼴이다. 이제 `age7` 은 `age === 7`, 열린 칩
|
|
77
|
+
`age13plus` 는 `age >= 13` 이다. 저장된 설정 148줄 중 나이 칩을 쥔 줄은 0 이었다(말귀 실측) —
|
|
78
|
+
뜻을 바꿔도 열리던 표가 달리 걸리는 일이 없다. 등급 `'1'` 을 쥔 13줄은 그대로 1등급 전부로 읽힌다.
|
|
79
|
+
|
|
80
|
+
코드: 등급 `'1'`~`'5'`(**5등급이 새로 생겼다**) · 나이 `'age1'`~`'age99'` · 열린 나이 `'age{n}plus'` ·
|
|
81
|
+
`'none'`. `isGradeCode` 가 **목록이 아니라 꼴**로 본다 — 단어훈련이 저장한 고름을 되읽을 때 이것으로
|
|
82
|
+
거르므로, 못 알아보면 고른 칩이 조용히 버려진다.
|
|
83
|
+
|
|
84
|
+
#### ③ 설명도 묶음에서 짓는다
|
|
85
|
+
|
|
86
|
+
`3세~7세: 가장 쉬운 낱말(1등급)…` 은 7세가 2등급이 되면서 **틀린 말**이 되었다. 묶음마다 한 줄 —
|
|
87
|
+
`1세~6세: 1등급 낱말을 나이별로 나눈 것입니다.` · `2등급: 7세~8세 낱말입니다.` … `없음: …`.
|
|
88
|
+
|
|
89
|
+
#### 넷째 자리 — **단어훈련**
|
|
90
|
+
|
|
91
|
+
청에는 부르는 자리가 셋(`useWordSearchPanels` · `useWordPairsFilterLabels` · `quickWordPlan`)으로
|
|
92
|
+
적혀 있었는데, 말귀 단어훈련 화면은 난이도 판을 **코어 훅이 짓게 한다**(`WordTrainingSetting.tsx:227`
|
|
93
|
+
→ `useWordTrainingFilter`). 앱이 `buildGradeSection` 을 직접 안 부르므로 훅에도 길(`gradeBands`)을
|
|
94
|
+
냈다. 안 넘기면 단어훈련만 옛 칩과 **국립국어원 등급 설명**(`1등급 : 학령전기에 습득하여…`)이 남는다
|
|
95
|
+
— 1등급이 1~6세인 지금은 틀린 글이다. 묶음은 앱이 그릴 때마다 새 배열로 넘길 수 있어 **글자로
|
|
96
|
+
견줘** 같으면 다시 짓지 않는다.
|
|
97
|
+
|
|
98
|
+
#### 사전을 거꾸로 찾는 표
|
|
99
|
+
|
|
100
|
+
나이 칩이 1~99 로 넓어지며 등급 사전이 열 줄에서 **이백 줄**이 되었다(나이 99 · 열린 나이 99 ·
|
|
101
|
+
등급 다섯 · 없음). `matchesFilters` 는 낱말마다 등급 라벨을 코드로 바꾸므로, 훑어 찾으면 그 품이
|
|
102
|
+
낱말 수만큼 곱해진다. **세워 재었다** — 2만 낱말 × 칩 셋(`6세` · `13세 이상` · `3등급`)에서 훑어
|
|
103
|
+
찾기 **615.9ms**, 거꾸로 찾는 표 **44.6ms**(같은 11,000건). 열네 배다.
|
|
104
|
+
|
|
105
|
+
#### 나이 꼴이 등급 숫자로 새는 덫 — 꼬리 `이상`·`+`
|
|
106
|
+
|
|
107
|
+
사전 밖의 글자는 숫자만 뽑아 등급으로 읽는 길이 있다(`'Grade 3'` → `'3'`). 옛 자는 **끝이 `세`·`살`
|
|
108
|
+
일 때만** 그 길을 막았는데, 열린 칩이 생기며 `3세 이상` 꼴이 들어왔다 — 끝이 `이상` 이라 옛 자에
|
|
109
|
+
안 걸리고 **3등급**이 된다. `이상`·`+`·`or older` 꼬리와 `Age 3` 머리까지 막는다.
|
|
110
|
+
|
|
111
|
+
> **못 일곱을 깨뜨려 울리는지 확인했다** — 맞추개를 옛 식으로(2건) · 열린 칩을 사전에서 뺌(3) ·
|
|
112
|
+
> 나이 꼴 자를 옛 것으로(6) · `isGradeCode` 를 옛 목록으로(5) · 묶음 검사에서 등급 차례를 안 봄(1) ·
|
|
113
|
+
> 판이 열린 칩을 다른 틀로 지음(3) · 단어훈련이 묶음을 안 넘김(1). 일곱 다 울렸다. 처음부터 아흔셋
|
|
114
|
+
> 다 초록이라 더 의심했다.
|
|
115
|
+
|
|
116
|
+
옛 시험 하나를 고쳤다 — `gradeAgeCodes1028` 이 `age2`·`age8` 을 "나이 아님" 으로 박아 두었는데,
|
|
117
|
+
이제 둘 다 나이다(1~99). 나이가 없는 낱말이 나이 칩에 안 걸린다는 나머지는 그대로 맞아 남겼다.
|
|
118
|
+
|
|
119
|
+
#### 놀이터 — 시연이 바로 그 덫을 쓰고 있었다
|
|
120
|
+
|
|
121
|
+
`use-word-attribute-filter` 쪽의 시연이 난이도를 `g.replace(/\D/g, '') === w.grade` 로 걸렀다 —
|
|
122
|
+
**`3세` 를 3등급으로 읽는** 바로 그 덫이다. 묶음을 넣으면 `6세` 칩이 없는 6등급을 찾았을 것이다.
|
|
123
|
+
이제 공개된 `toWordAttributeFilterCodes` 로 코드를 받아 같은 자(나이 칩은 등급을 안 봄)로 거른다.
|
|
124
|
+
시연 낱말에 나이를 붙이고, 묶음을 켜고 끄는 단추를 두었다. API 설명도 `1~4등급` 으로 낡아 있었다.
|
|
125
|
+
|
|
126
|
+
**화면에서 확인했다**(콘솔 울음 0) — 묶음을 켜면 `1세…6세 · 2등급…5등급 · 없음`, `5세` → 학교,
|
|
127
|
+
`2등급` 을 더하면 달리다·컴퓨터·매우. 묶음을 끄면 옛 줄이 그대로 서고, **그 줄의 `7세` 가 2등급
|
|
128
|
+
일곱 살(달리다·매우)을 건진다**. `i` 설명은 여섯 줄이 묶음대로 선다. 다만 시연의 거르기는 시연
|
|
129
|
+
코드가 같은 규칙을 따라 한 것이다 — 코어 맞추개는 공개가 아니라 놀이터에서 못 부른다. 화면이
|
|
130
|
+
증명하는 것은 칩·설명 짓기와 **칩 글자 → 코드 되읽기**이고, 맞추개 자체는 시험이 잰다.
|
|
131
|
+
|
|
132
|
+
#### 안쪽 도구 하나가 공개로 새었다
|
|
133
|
+
|
|
134
|
+
`gradeBandDescriptions` 를 `useWordAttributeFilter.ts` 에 두었더니 `src/hooks.ts` 가 그 파일을
|
|
135
|
+
**통째로**(`export *`) 내보내 공개 API 가 되었다 — `audit:playground` 가 대응표에 없다고 잡았다.
|
|
136
|
+
옆 함수 `gradeDescriptions` 와 같은 꼴로 대응표에 `internal` 로 적었다. 앱이 부를 일은 없다.
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
### 발행 관문 — **원격에서 어긋난 작업본은 못 잰다** (사장님 결정)
|
|
140
|
+
|
|
141
|
+
이 판을 이 컴퓨터에서 내려다 `audit:consumers` 가 막았다 — 소리방향성·kscan 두 줄. 재어 보니
|
|
142
|
+
**두 세션이 다른 상자를 재고 서로 반대 수를 적어 왔다**:
|
|
143
|
+
|
|
144
|
+
```
|
|
145
|
+
이 컴퓨터 작업본 원격 origin/main
|
|
146
|
+
sound-localization ^0.211.0 (가지 _giihan, 0.416.0
|
|
147
|
+
원격보다 482 앞 · 149 뒤)
|
|
148
|
+
kscan ^0.211.0 (main, 3 앞 · 3 뒤) ^0.338.0
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
이 문은 `path.resolve(root, '..')` — **이 컴퓨터의 옆 폴더**를 잰다. 그래서 같은 표가 컴퓨터마다
|
|
152
|
+
다르게 맞고 틀려, 이 두 줄이 **네 번 뒤집혔다**(10-20 · 10-27 · 10-30 · 10-31). 10-30 에 내가
|
|
153
|
+
`a8663617` 로 "`^0.211.0` 이 실측" 이라 고쳤고, 10-31 에 다른 컴퓨터의 0.413.0 이 "`^0.211.0` 은
|
|
154
|
+
재지 않은 수" 라 되돌렸다. **두 쪽 다 쟀고, 다른 상자를 쟀다.** 0.413.0~0.426.0 열네 판은 옆
|
|
155
|
+
작업본이 새것인 그 컴퓨터에서 나가 문이 초록이었다.
|
|
156
|
+
|
|
157
|
+
이제 작업본이 원격과 **범위가 다르고 원격보다 뒤에 있으면**(뒤처졌거나 갈라졌으면), 심링크 자리처럼
|
|
158
|
+
*"그 프로젝트가 쓰는 판이 아니라 못 잰다"* 고 말하고 넘어간다. 새로 받아 오지 않고 마지막으로 받아 둔
|
|
159
|
+
원격을 쓴다. **범위가 같거나, 앞서기만 했거나(안 밀린 고침이 가장 새것), 원격을 모르면 전처럼
|
|
160
|
+
잰다** — 원격과 같은 말귀 두 줄은 그대로 지킨다. 무뎌지지 않았는지 쟀다: 말귀 줄의 범위·깔린 판을
|
|
161
|
+
일부러 틀리게 적으면 둘 다 운다. 표의 두 줄은 **안 뒤집었다** — 옆 작업본이 원격과 같은 컴퓨터에서만
|
|
162
|
+
고친다(표 밑에 적었다).
|
|
163
|
+
|
|
164
|
+
## 0.426.0 — **글자를 키워도 안 잘린다 · 떠서 붙는 판은 창 안으로 · 밤새 훑어 세운 못들**
|
|
165
|
+
|
|
166
|
+
### 냅 이름표가 글자를 키우면 잘렸다 — **고침**(말귀 요청 371)
|
|
167
|
+
|
|
168
|
+
레일 폭 220px 은 그대로인데 이름표는 `button-1` 을 쓴다 — `large3` 에서 14px → 19px
|
|
169
|
+
(×1.36)이 된다. 아이콘(24px)과 여백은 안 따라가므로 늘어난 글자가 자리를 넘겨
|
|
170
|
+
말줄임표로 잘렸다.
|
|
171
|
+
|
|
172
|
+
실측(폭 1440 · 가장 긴 이름표 「말귀매니저로 이동」):
|
|
173
|
+
|
|
174
|
+
| 글자 크기 | 글자 폭 | 전 | 후 |
|
|
175
|
+
|---|---|---|---|
|
|
176
|
+
| medium | 100.2 | 126 | 126 |
|
|
177
|
+
| large1 | 114.5 | 126 | 126 |
|
|
178
|
+
| large2 | 128.8 | 126 (넘침 3) | **138** |
|
|
179
|
+
| large3 | 136.0 | 126 (넘침 10) | **138** |
|
|
180
|
+
|
|
181
|
+
**레일은 안 넓혔다.** 220 은 코어 바깥까지 묶인 수다 — 발치가 같은 값을 쓰고 소비자
|
|
182
|
+
앱이 본문을 그만큼 밀어 둔다. 글자 크기마다 레일이 넓어지면 앱 레이아웃이 통째로
|
|
183
|
+
움직이는데, 그건 고침이 아니라 제품 결정이라 사람이 정할 몫이다.
|
|
184
|
+
|
|
185
|
+
대신 `large2`·`large3` 에서만 **항목 안 여백을 한 단 낮췄다** — 16 → 12, 사이 12 → 8.
|
|
186
|
+
짧은 구분선과 하위 항목 들여쓰기도 같은 4px 만큼 당겨, 아이콘 왼쪽과 줄을 맞춘
|
|
187
|
+
것이 어긋나지 않는다(실측: 둘 다 레일 왼쪽에서 25px). `medium`·`large1` 은 그대로다.
|
|
188
|
+
|
|
189
|
+
### 후보 목록이 창 아래로 나갔다 — **고침**(자가 검수)
|
|
190
|
+
|
|
191
|
+
`TextField` 의 후보 목록도 같은 꼴이었다 — **위가 통째로 남을 때만**(`r.top > 230 + 8`)
|
|
192
|
+
뒤집었고, 조이는 데가 없었다. 그래서 칸이 창 아래쪽에 있고 후보가 많으면 창 바닥 밖으로
|
|
193
|
+
나갔다(흉내 판 실측: 창 300 · 칸 아래 여백 40 · 목록 120 → **88px 이 밖으로**).
|
|
194
|
+
|
|
195
|
+
**덜 모자라는 쪽으로 펴고 창 안으로 조인다.** 그리고 어림값(230) 대신 **목록의 실제 키**로
|
|
196
|
+
센다 — 밑바닥으로만 조이면 몇 줄짜리 짧은 목록이 칸에서 한참 떠오른다. 후보 수가 바뀌면
|
|
197
|
+
다시 잰다.
|
|
198
|
+
|
|
199
|
+
> **같은 흠을 이 저장소에서 세 번 만났다** — 청 (369) 드롭다운 판 · 그림 풍선 · 후보 목록.
|
|
200
|
+
> `DatePicker` 만 처음부터 제대로 쥐고 있었고, 그 셋이 그 셈을 안 빌려 쓰고 있었다.
|
|
201
|
+
|
|
202
|
+
|
|
203
|
+
### 그림 풍선이 창 아래로 나갔다 — **고침**(자가 검수)
|
|
204
|
+
|
|
205
|
+
`WordImageTooltip` 은 **가로는 창 안으로 조이는데 세로는 안 조였다.** 위가 모자라면 아래로
|
|
206
|
+
뒤집기만 하고, **아래도 모자라면** 그대로 창 바닥 밖으로 나갔다. 그림 풍선은 손가락·마우스
|
|
207
|
+
밑에 뜨므로 글자가 화면 아래쪽에 있으면 바로 그 꼴이다 — **청 (369)(드롭다운 판)와 같은
|
|
208
|
+
흠이 다른 자리에 있었다.**
|
|
209
|
+
|
|
210
|
+
`DatePicker`·`Dropdown` 이 쥔 셈에 맞췄다 — **덜 모자라는 쪽으로 펴고 창 안으로 조인다.**
|
|
211
|
+
위가 넉넉한 평소에는 전과 똑같다(가름이 예전 `top < 8` 과 같은 셈이다).
|
|
212
|
+
|
|
213
|
+
이 컴포넌트에는 못이 하나도 없었다 — 못 여섯을 함께 세웠다.
|
|
214
|
+
|
|
215
|
+
|
|
216
|
+
### `DatePicker` 가 읽히는 이름을 받는다 — **새로 생겼다**(자가 검수)
|
|
217
|
+
|
|
218
|
+
놀이터 예순여섯 쪽의 누를 수 있는 것 전부를 훑어 **이름이 없는 것**을 셌다. 셋이 나왔고
|
|
219
|
+
둘이 실제 흠이었다:
|
|
220
|
+
|
|
221
|
+
| 자리 | 수 | 무엇이 |
|
|
222
|
+
|---|---|---|
|
|
223
|
+
| `date-picker__trigger` | 6 | `<input type="text">` 에 이름이 **아예 없다** — `placeholder` 뿐 |
|
|
224
|
+
| `file-upload__input` | 4 | 1×1 투명 칸이 낭독기 훑어보기에 잡힌다 |
|
|
225
|
+
| `slider--static` | 1 | **흠이 아니다** — 조작할 수 없는 그림이다 |
|
|
226
|
+
|
|
227
|
+
`placeholder` 는 이름이 아니다 — 값이 들어오면 사라지고, 낭독기가 그것을 이름으로 안 읽는
|
|
228
|
+
설정도 흔하다. 그래서 날짜 칸은 *"편집, 비어 있음"* 으로만 읽혔다.
|
|
229
|
+
|
|
230
|
+
`DatePicker` 에 **`ariaLabel`** · **`ariaLabelledBy`** 가 생겼다.
|
|
231
|
+
|
|
232
|
+
```tsx
|
|
233
|
+
<DatePicker ariaLabel="시작일" value={v} onChange={setV} />
|
|
234
|
+
<DatePicker ariaLabelledBy="start-label" value={v} onChange={setV} />
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
**기본 이름을 박지 않았다.** `aria-label` 은 `<label for>`·`aria-labelledby` 로 붙인 **눈에
|
|
238
|
+
보이는 이름을 덮는다** — 코어가 '날짜' 를 박으면 `PanelRow` 로 이름을 붙여 둔 자리가 조용히
|
|
239
|
+
그 글자로 바뀐다. 그래서 `TextField`·`Slider` 와 같은 결로 **개발 모드 알림**을 둔다.
|
|
240
|
+
|
|
241
|
+
`FileUpload` 의 숨은 파일 칸은 `aria-hidden` 으로 감췄다 — 초점이 안 가는 칸이고(`tabIndex`
|
|
242
|
+
-1) 이름은 위 단추가 들고 있다.
|
|
243
|
+
|
|
244
|
+
### 단어 찾기 단추 둘이 폰에서 화면 밖으로 밀렸다 — **고침**(자가 검수)
|
|
245
|
+
|
|
246
|
+
결과 아래 단추 줄이 `display: flex` 에 줄바꿈이 없었다. 두 단추는 각각 **밑바닥
|
|
247
|
+
190px**(`button56--bar`)을 쥐고 있어 `nowrap` 으로는 못 줄어든다.
|
|
248
|
+
|
|
249
|
+
실측(창 375): 줄 **363** · 든 것 **376** → **13px 넘침.** 앱이 주는 폭(약 343)에서는 더
|
|
250
|
+
밀린다. **두 말 모두 그렇다** — 단추 폭이 글자가 아니라 그 밑바닥에서 오므로 한국어도 같다
|
|
251
|
+
(`선택 초기화`·`단어 표 만들기` 둘 다 190).
|
|
252
|
+
|
|
253
|
+
`flex-wrap: wrap` 하나로 고쳤다. 고친 뒤 창 375 에서 넘침 **0**(단추가 두 줄로),
|
|
254
|
+
창 1440 에서는 **한 줄 그대로**다. 가운데 맞춤도 그대로다.
|
|
255
|
+
|
|
256
|
+
|
|
257
|
+
### 보고서 머리의 긴 값이 옆 칸을 덮었다 — **고침**(자가 검수)
|
|
258
|
+
|
|
259
|
+
격자 칸은 `minmax(0, 1fr)` 이라 **줄어들 수 있게** 적혀 있었는데, 그 안의 줄은
|
|
260
|
+
`min-width: auto` 라 제 속만큼 버티고 값은 `white-space: nowrap` 이라 한 줄로 버텼다.
|
|
261
|
+
그래서 넘친 글이 **옆 칸 위에 그려졌다.**
|
|
262
|
+
|
|
263
|
+
실측(폭 900 · 네 칸 — 보고서가 실제로 서는 폭): 칸 **202** 에
|
|
264
|
+
`서울특별시립어린이병원 언어치료실` **293** → **91px 이 옆 칸으로.**
|
|
265
|
+
|
|
266
|
+
**격자 자체는 안 넘친다** — 넘친 것이 다음 칸 자리(격자 안)로 가므로 가로 스크롤도 안
|
|
267
|
+
생긴다. **겹쳐 보이기만 한다.** 그래서 더 늦게 들킨다.
|
|
268
|
+
|
|
269
|
+
`min-width: 0` 과 줄바꿈으로 고쳤다. **말줄임이 아니다** — 보고서는 종이로 나가는 글이라
|
|
270
|
+
이름·기관명이 그대로 읽혀야 한다.
|
|
271
|
+
|
|
272
|
+
| 폭 | 칸 틀 | 넘침 | 줄 높이 |
|
|
273
|
+
|---|---|---|---|
|
|
274
|
+
| 900 | 네 칸 202 | **0** (전 91) | 52 (두 줄) |
|
|
275
|
+
| 375 | 두 칸 144.5 | 0 | 92 |
|
|
276
|
+
|
|
277
|
+
|
|
278
|
+
### 줄 꼴 랜딩 칸이 폰에서 밖으로 나갔다 — **고침**(자가 검수)
|
|
279
|
+
|
|
280
|
+
`LandingCard layout="row"` 는 왼쪽 칸과 오른쪽 판을 나란히 세운다. 틀은 `flex-wrap: wrap`
|
|
281
|
+
이라 안 들어가면 감싸게 돼 있었는데, **두 수가 그 감싸기를 막았다** — 왼쪽 칸의 폭이
|
|
282
|
+
**인라인 `width: 300px`** 이고, 오른쪽 판의 **`min-width: 360px`** 이 칸보다 넓어도 360 을
|
|
283
|
+
쥐었다.
|
|
284
|
+
|
|
285
|
+
실측(폭 343 — 폰에서 앱이 주는 속폭): 카드 속폭 **293** 에 칸 300 · 판 360 → **43px 넘침.**
|
|
286
|
+
**앱 소개 쪽이 `layout="row"` 를 세 자리에서 쓴다** — 살아 있는 화면이다.
|
|
287
|
+
|
|
288
|
+
둘 다 `min(…, 100%)` 으로 바꿨다(칸 폭은 사용자 속성으로 건네고 CSS 가 받는다 — 인라인
|
|
289
|
+
`min()` 은 jsdom 이 버린다).
|
|
290
|
+
|
|
291
|
+
| 폭 | 왼쪽 칸 | 오른쪽 판 | 넘침 |
|
|
292
|
+
|---|---|---|---|
|
|
293
|
+
| 343 | 293 | 293 | **0** (전 43) |
|
|
294
|
+
| 900 | **300** | 526 | 0 |
|
|
295
|
+
|
|
296
|
+
**넓은 화면은 한 치도 안 바뀐다.**
|
|
297
|
+
|
|
298
|
+
|
|
299
|
+
### `PaymentPlan` 에 `titleLevel` 이 생겼다 — **새로 생겼다**(말귀 요청 388)
|
|
300
|
+
|
|
301
|
+
카드 제목 태그가 `h3` 으로 **박혀** 있어 앱이 급을 줄 길이 없었다. 제목은
|
|
302
|
+
`className="payment-plan__title-heading h1"` 으로 크기를 쥐는데 **그 `h1` 은 글자 꼴**이고
|
|
303
|
+
낭독기가 읽는 층은 태그가 정한다. 그래서 말귀 `이용권 구매` 가 이렇게 읽혔다(말귀 실측):
|
|
304
|
+
`H1 이용권 구매` → **`H3 무료`** → **`H3 스탠다드`**. **한 층이 통째로 빈다.**
|
|
305
|
+
|
|
306
|
+
```tsx
|
|
307
|
+
<PaymentPlan plan={plan} titleLevel={2} /> {/* 쪽 제목 바로 아래 자리 */}
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
`ChartSection`·`FilterPanel`·`Panel`·`Section` 이 쓰는 그 이름·그 꼴이다(`0 | 2…6`,
|
|
311
|
+
`0` 이면 `div`). **기본 3 이라 지금 화면은 한 치도 안 바뀐다** — 옛 소개 쪽
|
|
312
|
+
(`LandingPlans`)은 이미 `h2` 구획 아래다. **글자 꼴은 급과 무관하게 그대로다.**
|
|
313
|
+
|
|
314
|
+
> 집안 못 둘이 이 고침을 받아 울었고, 둘 다 제 몫을 했다 — `headingFamily` 의 *"머리글을
|
|
315
|
+
> 박아 둔 조각"* 목록에서 `PaymentPlan` 을 뺐고(그 표가 *"겪은 자리가 나오면 연다"* 라고
|
|
316
|
+
> 적어 둔 그 자리다), `cssClassIntegrity` 는 **내 주석을 마크업으로 읽어** 거짓 빨강을
|
|
317
|
+
> 냈다(`className="… h1"` 이라 적은 글의 `…`). 글을 피하는 대신 **그 자가 주석을 걷도록**
|
|
318
|
+
> 고쳤다 — 안 그러면 다음 사람이 같은 함정을 다시 밟는다.
|
|
319
|
+
|
|
320
|
+
|
|
321
|
+
### 영어로 다시 훑어 셋을 더 찾았다 — **고침**(자가 검수)
|
|
322
|
+
|
|
323
|
+
같은 훑기를 **영어로** 다시 돌렸다(여든여덟 쪽). 한국어에서는 조용했던 것이 셋 나왔다.
|
|
324
|
+
|
|
325
|
+
**① `arrow-up` 이 짝 없이 빠져 있었다.** 정적 목록에 `arrow-down`·`-left`·`-right` 는
|
|
326
|
+
있는데 `-up` 만 없어서, 그 이름을 부르면 **아무것도 안 그려진다**(놀이터 `#training-card`
|
|
327
|
+
의 '검수묶음 위로' 단추 — 아래로는 그려지고 위로만 빈 자리였다). `chevron-` 은 넷이 다
|
|
328
|
+
있다. 담았고, **네 방향이 다 담겼는지 세는 못**을 세웠다.
|
|
329
|
+
|
|
330
|
+
**② `DeviceSideTable` 의 첫 칸·종류 칸이 영어에서 잘렸다.** 바로 아래 절에서 7·8 을
|
|
331
|
+
넓혔는데, 영어로는 1·3 도 모자랐다 — `1번째 열 68px … 70px 필요` · `3번째 열 110px …
|
|
332
|
+
118px 필요`. **72 · 120** 으로 넓혔다.
|
|
333
|
+
|
|
334
|
+
> **까닭은 잰 자가 잉크만 봤다는 것이다.** 청 (368) 이 적어 둔 수(`In use` 34.5 ·
|
|
335
|
+
> `Device Type` 103.7)는 **글자 잉크**다. 칸이 실제로 드는 폭은 코어가 `max-content` 로
|
|
336
|
+
> 재는 값이고, 머리글에는 **정렬 화살표 자리**가 더 붙으며 종류 칸의 내용은 글자가 아니라
|
|
337
|
+
> **배지**(영어 `Hearing Aid`)다. 잉크에 여백만 더해 세면 그만큼 모자란다 — 그래서 청
|
|
338
|
+
> (368) 이 56 → 68 로 올린 그 칸이 **2px 모자란 채** 남아 있었다.
|
|
339
|
+
|
|
340
|
+
**③ 놀이터 데모 둘**(폼 안 `htmlType` 없는 단추 · 정렬 못 하는 열)은 코어가 알림으로
|
|
341
|
+
일러 주는 **그 알림을 보여 주는 자리**다 — 코어 몫이 아니다.
|
|
342
|
+
|
|
343
|
+
|
|
344
|
+
### `DeviceSideTable` 의 두 칸이 내용을 잘랐다 — **고침**(자가 검수)
|
|
345
|
+
|
|
346
|
+
놀이터 **백스물여덟 쪽**을 훑어 콘솔에 나오는 것을 모았다(오류 · 경고 · 안 잡힌 던짐 ·
|
|
347
|
+
안 잡힌 거절). **오류는 0** 이고, 경고 셋 가운데 둘이 **코어가 스스로 내는 알림**이었다 —
|
|
348
|
+
*"정해 둔 폭에 내용이 안 들어갑니다 — 그만큼 잘려 나갑니다."* 그 알림은 2026-10-27 에
|
|
349
|
+
사장님 *"우측 잘리는데?"* 를 보고 넣은 것인데, **코어 자신의 표가 그 알림을 내고 있었고
|
|
350
|
+
아무도 안 봤다.** 한국어에서도 잘린다:
|
|
351
|
+
|
|
352
|
+
| 칸 | 전 | 든 것 | 넘침 |
|
|
353
|
+
|---|---|---|---|
|
|
354
|
+
| 7 착용일 | 110 | `2025년 3월 14일` 146 | **36px** |
|
|
355
|
+
| 8 지우기 | 80 | `삭제` 단추 92 | **12px** |
|
|
356
|
+
|
|
357
|
+
두 말의 **가장 긴 꼴**로 다시 재어 **156 · 108** 로 넓혔다(칸 좌우 여백 16+16):
|
|
358
|
+
|
|
359
|
+
- 착용일 — 한국어 `2025년 10월 28일` 123 → **155** / 영어 `May 28, 2025` 99 → 132
|
|
360
|
+
- 지우기 — 한국어 `삭제` 단추 58 → 90 / 영어 `Delete` 단추 74 → **106**
|
|
361
|
+
|
|
362
|
+
고친 뒤 실측: 잘리는 칸 **0**, 표 속폭 898 → 972(제 가로 스크롤로 보여 준다 — 2026-09-22
|
|
363
|
+
사장님 지시). **첫 칸 56 → 68 과 같은 자리다**(청 (368)) — 그때 그 칸만 재고 나머지는 안 쟀다.
|
|
364
|
+
|
|
365
|
+
그 수를 못으로 박았다 — 글이 길어지거나 칸이 좁아지면 콘솔이 아니라 **관문**이 멎는다.
|
|
366
|
+
**안 잰 네 칸은 표에 안 넣었다** — 짐작한 수가 실측처럼 보이면 안 되므로, 비어 있다는
|
|
367
|
+
것까지 따로 센다.
|
|
368
|
+
|
|
369
|
+
|
|
370
|
+
### 받지만 안 읽는 prop 을 못으로 막는다 — **새로 생겼다**(자가 검수)
|
|
371
|
+
|
|
372
|
+
말귀 청 (352) 가 그 꼴이었다 — `PanelRow` 의 children 갈래가 `required` 를 읽지도 않았고,
|
|
373
|
+
주는 쪽은 **타입검사도 린트도 아무 말을 안 들었다.** 에러도 경고도 없이 아무 일이
|
|
374
|
+
안 일어나는 자리다.
|
|
375
|
+
|
|
376
|
+
같은 꼴이 더 있는지 컴포넌트 전체를 훑었다 — `*Props` 묶음의 **맨 윗단 칸 1,251 개**
|
|
377
|
+
가운데 제 본문에 한 번도 안 나오는 것은 **여섯**이고, **다섯은 이미 `@deprecated 읽지
|
|
378
|
+
않는다` 로 적혀 있다**(소비자 호출을 안 깨뜨리려 받아만 두는 자리 — 적혀 있으니 조용하지
|
|
379
|
+
않다). 나머지 하나는 표식 컴포넌트(`Page`)로, 제 본문이 안 읽는 것이 맞다.
|
|
380
|
+
|
|
381
|
+
**지금 상태를 못으로 얼린다**: 맨 윗단 prop 은 ① 제 본문이 읽거나 ② `@deprecated` 로
|
|
382
|
+
적혀 있거나 ③ 시험의 표에 까닭이 적혀 있어야 한다. 아무 일도 안 하는 prop 이 새로 생기면
|
|
383
|
+
멎는다.
|
|
384
|
+
|
|
385
|
+
> **세 번 자를 고쳤다.** 처음 센 수는 15(중첩 칸 읽기 `brand.link` 를 못 봤다), 다음은
|
|
386
|
+
> **1,251**(정규식을 잘못 적어 전부 "안 쓰인다" 로 나왔다). 수의 **크기**가 터무니없어
|
|
387
|
+
> 둘 다 잡았고, 셋째 자가 맞았다. 그 일을 시험 머리글에 적어 두었다.
|
|
388
|
+
|
|
389
|
+
|
|
390
|
+
### `Tabs` 가 없는 id 를 가리켰다 — **고침**(자가 검수)
|
|
391
|
+
|
|
392
|
+
놀이터 **일흔 쪽**을 훑어 id 로 서로를 가리키는 속성 여덟(`aria-labelledby` ·
|
|
393
|
+
`aria-describedby` · `aria-controls` · `aria-owns` · `aria-activedescendant` ·
|
|
394
|
+
`aria-errormessage` · `aria-details` · `for`)이 **문서에 있는 마디**를 가리키는지 셌다.
|
|
395
|
+
어긋난 것은 **하나**였다.
|
|
396
|
+
|
|
397
|
+
판은 **고른 탭 하나만** 그려지는데 `aria-controls` 는 탭 **모두**에 붙어 있었다 — 탭이
|
|
398
|
+
n 개면 **n−1 개가 늘 없는 id** 를 가리켰다. ARIA 는 그 속성이 있는 마디를 가리켜야 한다고
|
|
399
|
+
정한다. 낭독기의 "가리키는 곳으로 가기" 가 아무 일도 안 하거나 관계를 못 읽는다.
|
|
400
|
+
|
|
401
|
+
이제 **고른 탭에만** 둔다. 판을 다 그려 두고 숨기는 길도 있지만 안 보는 판까지 늘 짓는다.
|
|
402
|
+
|
|
403
|
+
|
|
404
|
+
### 초점 고리를 훑었다 — 빠진 곳은 0, 다만 **밝은 꼴에서 색이 묻는다**(자가 검수)
|
|
405
|
+
|
|
406
|
+
놀이터 열한 쪽에서 **진짜 Tab 키**를 눌러 초점이 가는 것 예순하나를 훑었다.
|
|
407
|
+
**고리가 없는 것은 0 이다**(테두리 선 57 · 그림자 4). 그 자리는 멀쩡하다.
|
|
408
|
+
|
|
409
|
+
그런데 **고리의 색**이 `--focus-ring: var(--color-main)` 이라 밝은 지면에서 묻는다:
|
|
410
|
+
|
|
411
|
+
| 지면 | 대비 |
|
|
412
|
+
|---|---|
|
|
413
|
+
| 흰색 #ffffff | **2.96** |
|
|
414
|
+
| 카드 #fbfdff | **2.90** |
|
|
415
|
+
| 연한 회색 #eef2f6 | **2.63** |
|
|
416
|
+
| 어두운 지면 #1e2227 | 5.41 |
|
|
417
|
+
| 어두운 카드 #252a30 | 4.89 |
|
|
418
|
+
|
|
419
|
+
WCAG 2.2 의 **1.4.11(글자가 아닌 것의 대비)은 초점 표시에 3:1** 을 요구한다 — 어두운
|
|
420
|
+
꼴은 넘기고 **밝은 꼴 셋이 다 못 넘긴다.**
|
|
421
|
+
|
|
422
|
+
**안 바꿨다** — 바로 아래 단추 대비와 **같은 결정**이다(둘 다 `--color-main` 이 뿌리다).
|
|
423
|
+
고칠 길도 같다: `--color-darkMain`(#1e5a8f)은 흰 지면에서 **7.21** 이다.
|
|
424
|
+
|
|
425
|
+
> **두 번 속았다가 자를 고쳤다.** ① 가짜 `keydown` 으로는 `:focus-visible` 이 안 걸린다
|
|
426
|
+
> (명세가 믿을 수 있는 이벤트만 센다) — 진짜 키를 눌러야 한다. ② `transition` 이 도는
|
|
427
|
+
> 중에 읽으면 **옛 값**이 나온다(글자 칸 테두리가 안 바뀐 것처럼 보였다) — 움직임을 끄고
|
|
428
|
+
> 다시 쟀다. 두 번 다 자기점검이 먼저 울어 잡았다.
|
|
429
|
+
|
|
430
|
+
|
|
431
|
+
### 브랜드색 단추 대비를 재어 못 박았다 — **고침 아님, 기록**(자가 검수)
|
|
432
|
+
|
|
433
|
+
놀이터 쉰두 쪽의 글빛/지면 대비를 다 쟀다. 막는 것은 **브랜드색 단추뿐**이다(본문 14px
|
|
434
|
+
기준 4.5 필요):
|
|
435
|
+
|
|
436
|
+
| 단추 | 글빛 / 지면 | 대비 |
|
|
437
|
+
|---|---|---|
|
|
438
|
+
| `variant-main` | 흰색 / #499cdf | **2.96** |
|
|
439
|
+
| `variant-main:hover` | 흰색 / #4dcdc0 | **1.94** |
|
|
440
|
+
| `variant-sub` | 흰색 / #4dcdc0 | **1.94** |
|
|
441
|
+
| `variant-white` | #499cdf / 흰색 | **2.96** |
|
|
442
|
+
| `variant-danger` | #d9534f / #f8fafc | 3.79 |
|
|
443
|
+
|
|
444
|
+
**안 바꿨다 — 브랜드색을 바꾸는 일이라 사람이 정할 몫이다.** 고칠 길은 이미 집 안에 있다:
|
|
445
|
+
`--color-darkMain`(#1e5a8f, 흰 글자 **7.21**) · `--color-darkSub`(#257e76, **4.86**).
|
|
446
|
+
색조를 지키며 가장 밝게만 낮춘 값은 `#3a7bb0`(4.53) · `#31837b`(4.50) 이다.
|
|
447
|
+
|
|
448
|
+
못은 **오늘보다 나빠지지 않는 것**을 지킨다 — 브랜드색이 더 밝아지면 멎고, 안전한
|
|
449
|
+
짝(darkMain·darkSub)이 밝아지면 멎는다.
|
|
450
|
+
|
|
451
|
+
|
|
452
|
+
### '활용도 높은 단어만' 이 아무 일도 안 했다 — **고침**(말귀 요청 345②)
|
|
453
|
+
|
|
454
|
+
청 (342) 로 그 칩이 섰고 `WordEntry.usage` 도 열렸는데 **그 칩을 읽는 자리가 코어에도
|
|
455
|
+
앱에도 없었다**(말귀 실측 2026-10-28: `onlyHighUsage` 를 쓰는 곳은 사전과 칩을 세우는
|
|
456
|
+
줄뿐). 눌러도 결과가 그대로였다 — 칩은 멀쩡히 켜지고 화면에는 아무 말이 없다. 난이도
|
|
457
|
+
칩이 밟았던 그 꼴이다(①).
|
|
458
|
+
|
|
459
|
+
`matchesFilters` 가 읽는다 — 그 하나를 고치면 **단어표·대립쌍표·단어훈련이 한 번에**
|
|
460
|
+
걸린다(말귀가 바란 자리다). `FilterableWord` 에 `usage?: boolean` 을 더했고,
|
|
461
|
+
`applyFilters` 는 낱말을 통째로 넘기므로 저절로 따라온다.
|
|
462
|
+
|
|
463
|
+
**절 이름을 안 본다.** 이 칩은 속성 다섯 절 밖의 '선택' 절에 있고 부르는 자리마다 절
|
|
464
|
+
이름이 다르다(단어표 `선택` · 단어훈련 `제외`). 그래서 **값으로** 알아본다 — 한국어·영어
|
|
465
|
+
라벨과 `highUsage` 코드를 다 읽는다.
|
|
466
|
+
|
|
467
|
+
**빈 `usage` 는 떨어뜨린다**(말귀가 그렇게 골랐다) — 안 들고 오는 낱말을 "높다" 고 볼
|
|
468
|
+
근거가 없다. 칩을 안 켜면 아무것도 안 거른다.
|
|
469
|
+
|
|
470
|
+
> ①(`applyFilters` 가 `age` 를 안 넘기던 것)은 **이미 고쳐져 있었다** — 낱말을 통째로
|
|
471
|
+
> 넘기는 쪽으로 바뀌어, 칸이 늘어도 저절로 따라온다.
|
|
472
|
+
|
|
473
|
+
|
|
474
|
+
### `fit` 모드에서 칸 바닥이 격자에 안 실렸다 — **고침**(말귀 요청 368 의 코어 몫)
|
|
475
|
+
|
|
476
|
+
청 (217) 이 *"머리글자가 드는 폭은 바닥이다"* 를 넣고 `columnFloors` 가 그 바닥을 구한다.
|
|
477
|
+
그런데 **`fit` 모드의 칸은 `${w}fr` 로 격자에 나간다.** 넘침을 감춘 격자 항목
|
|
478
|
+
(`.table-field` 는 `overflow: hidden`)의 **자동 최소 크기는 0** 이라, 통이 좁아지면
|
|
479
|
+
브라우저가 그 칸을 바닥 아래로 눌렀다 — 구한 바닥이 **비율을 셀 때만** 쓰였다. 게다가
|
|
480
|
+
`.table-field` 는 `text-overflow: clip` 이라 **끊긴 표시조차 없다.**
|
|
481
|
+
|
|
482
|
+
이제 `minmax(바닥px, w fr)` 로 내보낸다. 바닥은 **선언된 밑값과 머리글자가 드는 폭 가운데
|
|
483
|
+
넓은 쪽**이다. 바닥 합이 통보다 넓어지면 표가 제 가로 스크롤로 보여 준다(2026-09-22
|
|
484
|
+
사장님이 고르신 답 — *"접는 꼴은 넣지 않는다"*).
|
|
485
|
+
|
|
486
|
+
**손으로 끌어 둔 표에는 안 싣는다.** 끄는 동안의 바닥은 `MIN_COL_W` 라고 일부러 정해 둔
|
|
487
|
+
자리다 — 사람이 정한 폭에 코어가 바닥을 끼우면 끌어 둔 칸이 제자리로 튄다. `grow` 모드는
|
|
488
|
+
px 로 나가므로 애초에 안 눌린다(전과 똑같다).
|
|
489
|
+
|
|
490
|
+
> 청 (368) 의 다른 코어 몫 — `DeviceSideTable` 의 `In use` 칸 — 은 **이미 고쳐져 있었다**
|
|
491
|
+
> (첫 칸 56 → 68, 그 실측이 그 줄에 적혀 있다).
|
|
492
|
+
|
|
493
|
+
|
|
494
|
+
### `PanelRow` 의 children 갈래가 `required` 를 버렸다 — **고침**(말귀 요청 352)
|
|
495
|
+
|
|
496
|
+
`variant` 를 주는 갈래는 별표(`.required-mark`)를 다는데 **children 하위 호환 갈래만
|
|
497
|
+
`required` 를 읽지도 않았다.** `PanelRowChildren` 타입에도 없어서 **주는 쪽이 틀렸는지조차
|
|
498
|
+
알 수 없었다** — 타입검사도 린트도 조용히 버렸다. 별표가 들어온 2026-09-08 에 이 갈래만
|
|
499
|
+
빠진 것으로 보인다.
|
|
500
|
+
|
|
501
|
+
```tsx
|
|
502
|
+
<PanelRow label="이름" required> {/* 이제 별표가 선다 */}
|
|
503
|
+
<TextField … required />
|
|
504
|
+
</PanelRow>
|
|
505
|
+
```
|
|
506
|
+
|
|
507
|
+
타입에 `required?: boolean` 을 더하고, 이름표를 `variant` 갈래와 **같은 줄**로 맞췄다.
|
|
508
|
+
읽히는 이름은 칸 자신의 `required`(`aria-required`)가 맡는다 — 이 별표는 그림만 맡는다.
|
|
509
|
+
|
|
510
|
+
### 막대그래프 눈금 숫자가 서로 포개졌다 — **고침**
|
|
511
|
+
|
|
512
|
+
판이 납작해지면 눈금 사이가 숫자 상자보다 좁아져 글자끼리 겹쳤다. 말귀 실측
|
|
513
|
+
(2026-11-10, **375×812 · 기본 글자**): 대시보드 자료실 카드의 판이 **14px** 로 눌려 눈금
|
|
514
|
+
사이가 7px 이 되고, `10` 과 `5` 가 가로 6.6 · 세로 0.9px 겹쳤다. **큰 글자에서만의 일이
|
|
515
|
+
아니다 — 폰으로 보면 아무것도 안 바꿔도 이 꼴이다.**
|
|
516
|
+
|
|
517
|
+
자리가 좁으면 **숫자만 뺀다 — 선은 남는다.** 위에서부터 훑어 앞서 남긴 숫자와 14px 이상
|
|
518
|
+
떨어진 것만 남긴다(숫자 상자 실측 13px + 1). 넉넉한 판에서는 전과 똑같이 다 선다.
|
|
519
|
+
|
|
520
|
+
곁들여 **눈금 숫자 상자의 줄 높이를 17px 로 못 박았다.** 글자 크기는 `font-size: 11px` 가
|
|
521
|
+
이기는데 **줄 높이는 `caption-1` 이 이겨** 17 → 20 → 21 → 24 로 늘어, 글자는 그대로인데
|
|
522
|
+
상자만 커져 숫자가 제 선에서 아래로 밀렸다(잉크 위 틈 2 → 5.5px). `17px` 은 기본 글자에서
|
|
523
|
+
나오던 그 값이라 **기본 화면은 한 치도 안 바뀐다.**
|
|
524
|
+
|
|
525
|
+
> **판이 14px 로 눌리는 것 자체는 안 건드렸다.** 카드 높이 260 은 사장님이 2026-11-02 에
|
|
526
|
+
> 못 박으신 수다(`small` 120 × 2 + 틈 20). 자료실 카드만 먼저 터지는 까닭은 **범례 항목이
|
|
527
|
+
> 셋이라 줄이 꺾여** 밑줄·범례가 33px 을 더 먹기 때문이다(말귀 실측). 그 수를 다시 볼지는
|
|
528
|
+
> 사장님께 올려 뒀다.
|
|
529
|
+
|
|
530
|
+
|
|
531
|
+
### 드롭다운 판이 창 밖으로 나갔다 — **고침**(말귀 요청 369)
|
|
532
|
+
|
|
533
|
+
판 자리를 `left: rect.left` 로만 적고 오른쪽을 안 봤다. 판은 `min-width: 트리거 폭` 이라
|
|
534
|
+
**항목 글이 길면 트리거보다 넓어지는데**, 트리거가 창 오른쪽 가에 있으면 그만큼 화면
|
|
535
|
+
밖으로 나가 고를 수 없었다. 세로도 같다 — 아래가 모자라고 **위도 모자라면**
|
|
536
|
+
(`rect.top > 260` 이 거짓) 늘 아래로 펴서 창 바닥 밖으로 나갔다.
|
|
537
|
+
|
|
538
|
+
`DatePicker` 는 같은 셈을 이미 쥐고 있었다 — 그 둘이 갈려 있던 것이 이 흠이다. 넷을
|
|
539
|
+
그쪽에 맞춘다:
|
|
540
|
+
|
|
541
|
+
- 판 **실제 폭·높이**로 센다(열린 뒤 다시 잰다 — 어림값이 작으면 밖으로 나간 채 아무도 안 잰다)
|
|
542
|
+
- `left` 를 창 안으로 조인다(여백 8px)
|
|
543
|
+
- 위도 아래도 모자라면 **덜 모자라는 쪽**으로 편다
|
|
544
|
+
- 쓰지 않는 쪽을 **`auto` 로 지운다** — 비워 두면 스타일시트에 남은 값이 자리를 가로채
|
|
545
|
+
높이가 `top`·`bottom` 사이로 눌린다
|
|
546
|
+
- 판이 창보다 넓어지지 않게 `max-width` 를 건다
|
|
547
|
+
|
|
548
|
+
놀이터 실측(1440×900, `#dropdown` 의 트리거 여덟): 고친 뒤 **여덟 모두 창 안**이고,
|
|
549
|
+
아래가 모자란 넷은 `bottom: 8px` 으로 바닥 여백에 붙었다.
|
|
550
|
+
|
|
551
|
+
|
|
552
|
+
### 합격 카드 글빛이 어두운 꼴에서 죽어 있었다 — **고침**(말귀 요청 370)
|
|
553
|
+
|
|
554
|
+
배경 아홉 가운데 **여덟이 글빛을 박은 16진수로** 넘겼다(`'#1a1a1a'` 다섯, `'#ffffff'` 셋).
|
|
555
|
+
지면 쪽은 토큰이라 어두운 꼴에서 뒤집히는데 글자는 검정에 머물렀다 — 말귀_3 실측
|
|
556
|
+
(0.423.0 · `/usage` · 폭 375 · `data-theme=dark`): `.pass-card__plan-number` rgb(26,26,26)
|
|
557
|
+
가 `.pass-card-bg` rgb(15,18,21) 위에서 **1.08:1**. 토큰을 쓰던 `two-circle` 하나만
|
|
558
|
+
16.75:1 이었다 — 한 화면 안에서 갈렸다.
|
|
559
|
+
|
|
560
|
+
**지면이 테마를 따르는 배경 여섯**(`ihab`·`sound-line`·`sound-move`·`talk`·`talk-v1`·
|
|
561
|
+
`two-circle`)의 글빛을 `var(--color-text-primary)` 로 적는다. 고친 뒤 실측(놀이터
|
|
562
|
+
`#pass-card` · 1440×900):
|
|
563
|
+
|
|
564
|
+
| 배경 | 라이트 | 다크 |
|
|
565
|
+
|---|---|---|
|
|
566
|
+
| `sound-move` | 18.88 | **16.75** (전 1.08) |
|
|
567
|
+
| `talk` | 18.88 | **16.75** |
|
|
568
|
+
| `ihab` | 18.52 | **14.26** |
|
|
569
|
+
| `two-circle` | 21.00 | 16.75 (전부터 멀쩡) |
|
|
570
|
+
|
|
571
|
+
**브랜드 그라디언트 배경 셋은 흰색을 그대로 둔다**(`sound-line-v1`·`sound-move-v1`·
|
|
572
|
+
`left-color-grid`). 그 지면은 `--color-main`·`--color-sub` 이고 **그 둘은 어두운 꼴에서
|
|
573
|
+
안 바뀐다**(실측 `#499cdf`·`#4dcdc0` 그대로) — 지면이 안 뒤집히는데 글자만 뒤집으면 같은
|
|
574
|
+
결함이 거울처럼 생긴다. 까닭을 `PassCardBgTheme.ts` 머리글에 적었다.
|
|
575
|
+
|
|
576
|
+
곁들여 `ihab` 의 저작권 글빛 `#c9c9c9` 도 토큰으로 바꿨다 — 밝은 꼴 1.62:1 / 어두운 꼴
|
|
577
|
+
9.66:1 로 두 꼴이 크게 어긋나 있었다. 이제 2.48 / 2.89 로 같은 흐림이다.
|
|
578
|
+
|
|
579
|
+
### `--color-onDark-title` 이 어두운 꼴에서 거의 검정이 됐다 — **고침**
|
|
580
|
+
|
|
581
|
+
그 토큰은 **제 바탕을 늘 어둡게 쥐는 면**(게임 시트) 위에 얹는 흰색이라 테마를 따르면 안
|
|
582
|
+
된다 — 토큰 파일이 그 뜻을 적어 두었는데 값이 `var(--color-pureWhite)` 였다. 사용자 정의
|
|
583
|
+
속성은 **선언한 원소에서** 확정되고 그 줄도 다크 블록도 같은 `<html>` 에 있으므로, 어두운
|
|
584
|
+
꼴에서 `#0f1215` 가 됐다.
|
|
585
|
+
|
|
586
|
+
실측(놀이터 `#game-intro`): 어두운 꼴에서 `.game-intro__title` 이 rgb(15,18,21), 바로 옆
|
|
587
|
+
`.game-intro__description` 은 흰색 58% — 어두운 게임 지면(#0d0b1e·#070f09) 위에서 제목만
|
|
588
|
+
안 보였다(대비 약 1.0:1). 형제 `-text`·`-muted` 는 rgba 를 그대로 적어 멀쩡했다.
|
|
589
|
+
|
|
590
|
+
흰색 리터럴로 못 박았다. **값이 바뀌는 소비자는 없다** — 라이트에서 나오던 값과 같고,
|
|
591
|
+
다크에서만 검정이 아니라 흰색이 된다.
|
|
592
|
+
|
|
593
|
+
|
|
594
|
+
### 영어 모드 바꾸기 이름표가 칸을 넘쳤다 — **고침**(말귀 요청 387)
|
|
595
|
+
|
|
596
|
+
곁줄이 **제 글로** 그리는 이름표는 맨 아래 모드 바꾸기 칸 하나뿐이다(나머지는 앱이
|
|
597
|
+
`items` 로 준다). 그 하나가 영어에서 넘쳤다 — `Go to Malgwi Manager` 143.1px, 칸 126px.
|
|
598
|
+
|
|
599
|
+
`nav.goToManager` 영어를 **`Go to Manager`** 로 줄였다. 한국어는 그대로다.
|
|
600
|
+
|
|
601
|
+
| 글 | medium 14px | large1 16px | large2 18px | large3 19px |
|
|
602
|
+
|---|---|---|---|---|
|
|
603
|
+
| 칸 | 126 | 126 | 138 | 138 |
|
|
604
|
+
| `Go to Malgwi Manager` (전) | 143.1 ✗ | 163.5 ✗ | 184.0 ✗ | 194.2 ✗ |
|
|
605
|
+
| `Malgwi Manager` | 105.3 | 120.4 | 135.4 | **142.9 ✗** |
|
|
606
|
+
| `Go to Manager` (후) | 94.2 | 107.7 | 121.1 | **127.9** |
|
|
607
|
+
|
|
608
|
+
말귀는 `Malgwi Manager` 를 바랐는데 **글자를 가장 키운 자리에서 4.9px 넘친다** — 네
|
|
609
|
+
자리를 다 재 보고 `Go to Manager` 로 골랐다. 한국어 「…로 이동」의 뜻이 남고
|
|
610
|
+
`Go to Malgwi` 와 짝이 맞는다.
|
|
611
|
+
|
|
612
|
+
|
|
613
|
+
### 꼬리가 붙은 조상 선택자가 죽어 있었다 — **고침**
|
|
614
|
+
|
|
615
|
+
코어 CSS 는 `.ihabdevteam-core-scope` 로 가둔다. `<html>` 에 다는
|
|
616
|
+
`data-theme`·`data-font-scale` 은 그 **위**라서, 프리픽스를 조상 자리에도 한 벌 더
|
|
617
|
+
내보낸다. 그런데 뒤에 무엇이 더 붙은 선택자에는 스코프를 **통째로 뒤에** 붙여서
|
|
618
|
+
이런 것이 나갔다:
|
|
619
|
+
|
|
620
|
+
```
|
|
621
|
+
[data-theme=dark] .pass-card--expired .ihabdevteam-core-scope
|
|
622
|
+
```
|
|
623
|
+
|
|
624
|
+
스코프 이름은 그 카드의 **조상**에 달리므로 한 번도 안 맞는 꼴이다. 0.425.0 꾸러미를
|
|
625
|
+
열어 확인했다 — `dist/components.esm.css` 에 그대로 들어 있었다.
|
|
626
|
+
|
|
627
|
+
보이는 결과: **어두운 테마 만료 합격 카드**의 도형 색이 덮이지 않아 8% 흰색으로 남고,
|
|
628
|
+
짙은 바탕(#2d3238) 위에서 대비가 **1.28:1** 이었다. 이제 18% 가 걸려 **1.77:1** 이다.
|
|
629
|
+
|
|
630
|
+
머리(첫 복합 선택자)와 꼬리를 갈라 스코프를 **그 사이**에 끼운다. 속성만 적힌 선택자
|
|
631
|
+
(`[data-theme="dark"] { … }`)는 나오는 것이 전과 똑같다.
|
|
632
|
+
|
|
633
|
+
**OS 자동 다크(`:root:not(…)`)는 일부러 그대로 둔다** — 같은 갈래로 고치면 OS 를
|
|
634
|
+
다크로 둔 모든 사용자의 화면이 한꺼번에 뒤집힌다. 그건 사람이 정할 몫이다.
|
|
635
|
+
|
|
636
|
+
### 수그린 글빛을 다 재어 수를 올립니다 — **보기 결정**(자가 검수, 안 고침)
|
|
637
|
+
|
|
638
|
+
앞 절에서 "뿌리는 토큰이다" 까지 갔으니 **쓰는 자리를 다 세어** 수를 쥐었다.
|
|
639
|
+
|
|
640
|
+
`--color-text-muted` 자체는 거의 안 쓰인다(여섯 자리). 문제는 그 뿌리인
|
|
641
|
+
**`--color-lightGray` 를 글빛으로 직접 쓰는 자리가 예순다섯**이라는 것이다. 토큰만으로
|
|
642
|
+
셈하면:
|
|
643
|
+
|
|
644
|
+
| 토큰 | 흰 면 | 어두운 면(뒤집힌 값으로) |
|
|
645
|
+
|---|---|---|
|
|
646
|
+
| `--color-lightGray` (수그린 글) | **2.48** | **2.89** |
|
|
647
|
+
| `--color-gray` (둘째 글) | 4.67 | 5.26 |
|
|
648
|
+
| `--color-darkGray` | 8.46 | — |
|
|
649
|
+
|
|
650
|
+
**수그린 글은 두 꼴에서 다 4.5 아래다.** 바로 위 칸의 `--color-gray` 는 두 꼴에서 다
|
|
651
|
+
통과한다.
|
|
652
|
+
|
|
653
|
+
화면에서도 재었다(폭 1440, 113쪽). 1,460 자리가 걸렸는데 **1,182 는 놀이터 살림**이고
|
|
654
|
+
(오른쪽 목차·이름표), 코어에서 되풀이를 걷어 내면 **열 자리 남짓**이다:
|
|
655
|
+
|
|
656
|
+
| 자리 | 대비 | 글 크기 |
|
|
657
|
+
|---|---|---|
|
|
658
|
+
| `badge--default badge--small` | 2.48~2.53 | 12px |
|
|
659
|
+
| `word-table-cell__caption-tail` | 2.53 | 15px |
|
|
660
|
+
| **`sound-compass__speaker-number`** | **2.42** | **8px** |
|
|
661
|
+
| `footer-link` | 2.42 | 13px |
|
|
662
|
+
| `dropdown__trigger-label` | 2.42 | 16px |
|
|
663
|
+
| `calendar-day-header` | 2.48 | 14px |
|
|
664
|
+
| `trp-row__no` · `dlp-date` · `ring-chart__label` | 2.48 | 12~16px |
|
|
665
|
+
|
|
666
|
+
다 작은 글이라 **4.5 가 걸리는 자리**다(큰 글 면제가 안 된다).
|
|
667
|
+
|
|
668
|
+
**공교롭게 그 가운데 하나가 오늘 밤 제가 이름에 넣은 그 번호다** — 스피커 단추의 보이는
|
|
669
|
+
번호가 **8px 에 2.42:1** 이다. 이름으로는 읽히게 해 두었는데, **눈으로 보기에는 거의 안
|
|
670
|
+
보인다.**
|
|
671
|
+
|
|
672
|
+
**안 고쳤습니다.** 열 자리의 글빛을 한꺼번에 옮기는 일이고, `--color-gray` 로 올리면 수는
|
|
673
|
+
통과하지만(4.67 / 5.26) **"수그린 글" 이라는 뜻이 옅어집니다.** 앞서 올린 브랜드색 대비와
|
|
674
|
+
**같은 통의 보기 결정**이라 수만 올립니다. 고르실 길은 둘로 보입니다 —
|
|
675
|
+
① 수그린 글을 `--color-gray` 로 올린다(두 꼴 다 통과, 열 자리의 톤이 조금 진해진다)
|
|
676
|
+
② 지금 톤을 지키고 **작은 글에만**(12px 아래) 올린다.
|
|
677
|
+
|
|
678
|
+
### 어두운 꼴에서 글이 사라지던 자리 둘 — **고침**(자가 검수 · 청 370 과 같은 꼴)
|
|
679
|
+
|
|
680
|
+
앞 절에서 "`--color-bg-secondary` 가 아예 없다" 를 찾은 끝을 당겼다. **없는 토큰은
|
|
681
|
+
`var(--없는것, 되돌림)` 의 되돌림이 늘 서므로 밝은 꼴에서는 멀쩡해 보이고 어두운 꼴에서만
|
|
682
|
+
조용히 죽는다.** 그 꼴로 **거울처럼 짝을 이룬 흠 둘**이 나왔다:
|
|
683
|
+
|
|
684
|
+
| | 바탕 | 글 | 어두운 꼴 대비 |
|
|
685
|
+
|---|---|---|---|
|
|
686
|
+
| `BulkBar` | 뒤집힌다(흰 → rgb(15,18,21)) | **안 뒤집힌다**(`--color-gray900` → `#1a1a1a`) | **1.08:1** |
|
|
687
|
+
| `.wdup-phase-card` | **안 뒤집힌다**(`--color-bg-secondary` → `#f7f9fb`) | 뒤집힌다(→ rgb(240,242,245)) | **1.06:1** |
|
|
688
|
+
|
|
689
|
+
둘 다 **사실상 안 보였다.** 말귀 청 (370)(어두운 합격 카드 1.08:1)과 **똑같은 꼴**이다 —
|
|
690
|
+
한쪽만 뒤집히면 글이 사라진다.
|
|
691
|
+
|
|
692
|
+
고친 뒤(실측):
|
|
693
|
+
|
|
694
|
+
| | 밝은 꼴 | 어두운 꼴 |
|
|
695
|
+
|---|---|---|
|
|
696
|
+
| `BulkBar` | 17.4 → **18.88** | **1.08 → 16.75** |
|
|
697
|
+
| 그림 카드 | 17.89 → **18.05** | **1.06 → 12.89** |
|
|
698
|
+
|
|
699
|
+
밝은 꼴은 사실상 그대로고, 어두운 꼴만 살아났다. `--color-danger`(이 또한 없는 이름 —
|
|
700
|
+
되돌림 `#ef4444` 이 늘 섰다)도 이 집의 잘못 색 `--color-error` 로 맞췄다.
|
|
701
|
+
|
|
702
|
+
**못은 공통 뿌리를 센다**(`test/surfaceAndTextFlipTogether1110.test.ts`): ① 그 자리가
|
|
703
|
+
**있는 토큰**을 쓰는가 ② 그 토큰이 **세 길에서 다** 뒤집히는가 ③ 그 파일에 **없는 `--color-`
|
|
704
|
+
이름을 되돌림과 함께** 쓰는 자리가 없는가. 셋을 다 깨 보았다 — 없는 이름으로 되돌려 보고,
|
|
705
|
+
안 뒤집히는 토큰(`--color-error`)으로 바꿔 보니 그 길을 정확히 짚으며 멎었다.
|
|
706
|
+
|
|
707
|
+
**남은 자리를 적어 둔다.** 없는 이름을 쓰는 자리가 저장소에 **여든**인데, 그 대부분은
|
|
708
|
+
**조각이 밖에서 받는 손잡이**다(`--wt-band-top-height` · `--angle` · `--bar-w` ·
|
|
709
|
+
`--update-alert-stack-offset` 처럼 부모가 인라인으로 심는 값) — 흠이 아니다. 테마를 따라야
|
|
710
|
+
하는 `--color-*` 이름만 골라 보면 남은 것은 `--color-red`(쿠폰 팝업) · `--color-hoverBg`
|
|
711
|
+
(기기 목록) · `--color-primary`(Button) · `--color-code-*`(CodeBox 다섯)이다. 앞의 셋은
|
|
712
|
+
각각 `--color-error` · `--color-deepWhite` · `--color-main` 이 맞는 이름이고, `CodeBox` 의
|
|
713
|
+
문법 색 다섯은 일부러 고정한 자리로 보인다.
|
|
714
|
+
|
|
715
|
+
**그 셋은 재지 못해 안 고쳤다.** 둘은 **상태를 띄워야** 보이는 자리다 —
|
|
716
|
+
`.coupon-input-popup__error` 는 잘못된 쿠폰을 넣어야 뜨고, `.dlp-row` 는 놀이터 어느 쪽에도
|
|
717
|
+
안 떠 있다(일곱 쪽을 찾아봤다). 글과 바탕을 **짝으로 재지 않고** 한쪽만 고치면 이번에
|
|
718
|
+
`BulkBar` 에서 하마터면 그랬듯 **흰 카드에 흰 글**을 심는다. 그래서 수를 못 쥔 자리는
|
|
719
|
+
건드리지 않는다.
|
|
720
|
+
|
|
721
|
+
글로만 아는 것은 이만큼이다 — 세 이름 다 tokens.css 에 없어 **되돌림 값이 늘 선다**:
|
|
722
|
+
|
|
723
|
+
| 자리 | 지금 | 맞는 이름 | 그 이름이 뒤집히나 |
|
|
724
|
+
|---|---|---|---|
|
|
725
|
+
| `.dlp-row:hover` 바탕 | `var(--color-hoverBg, #f5f5f5)` | `--color-deepWhite` | **예**(#f8fafc → #252a30) |
|
|
726
|
+
| 쿠폰 잘못 글 | `var(--color-red, #e84040)` | `--color-error` | 아니오(두 꼴이 같다) |
|
|
727
|
+
| `.button--variant-sub` 바탕 | `var(--color-primary, var(--color-sub))` | **되돌림이 맞다**(아래) | — |
|
|
728
|
+
|
|
729
|
+
#### 그 뒤에 재어 보니 — **제 짐작이 방향까지 틀렸다**
|
|
730
|
+
|
|
731
|
+
위에 *"`--color-hoverBg` 만 어두운 꼴에 걸린다"* 고 적었다. **틀렸다.** 놀이터에 그 줄이
|
|
732
|
+
없어서, 범위 안에 **제가 줄을 지어** 재었다(PromoBannerBg 때 쓴 길이다):
|
|
733
|
+
|
|
734
|
+
| | 밝은 꼴 | 어두운 꼴 |
|
|
735
|
+
|---|---|---|
|
|
736
|
+
| `.dlp-date` 글 | rgb(150,164,184) | rgb(96,105,122) |
|
|
737
|
+
| 팝업 면 | rgb(251,253,255) | rgb(30,34,39) |
|
|
738
|
+
| **손 안 올린 대비** | **2.48** | **2.89** |
|
|
739
|
+
| 손 올린 면 | rgb(245,245,245) | **똑같다**(안 뒤집힌다) |
|
|
740
|
+
| **손 올린 대비** | **2.32** | **5.07** |
|
|
741
|
+
|
|
742
|
+
두 가지가 짐작과 달랐다:
|
|
743
|
+
|
|
744
|
+
1. **걸리는 쪽은 어두운 꼴이 아니라 밝은 꼴이다.** 글(`--color-text-muted`)이 **밝은 꼴에서
|
|
745
|
+
더 밝기** 때문에, 굳은 흰 바탕과 2.32 로 더 가까워진다. 어두운 꼴에서는 글이 어두워져
|
|
746
|
+
**5.07 로 오히려 통과**한다.
|
|
747
|
+
2. **더 큰 것은 손 올림이 아니다.** 손을 안 올려도 **2.48 · 2.89** 로 둘 다 4.5 아래다.
|
|
748
|
+
손 올림은 그 수를 조금 흔들 뿐이다.
|
|
749
|
+
|
|
750
|
+
뿌리는 토큰 자체다 — `--color-text-muted` → `--color-lightGray` = rgb(150,164,184)이고,
|
|
751
|
+
**흰 면 위에서 2.53:1** 이다(지어 본 것과 무관하게 토큰만으로 셈해도 같은 수다). 그러니
|
|
752
|
+
이것은 `--color-hoverBg` 라는 이름 하나의 흠이 아니라, **수그린 글 토큰을 어디까지 쓸
|
|
753
|
+
것인가**라는 보기 결정이다 — 앞서 올린 브랜드색 대비와 같은 통에 넣는다.
|
|
754
|
+
|
|
755
|
+
**그래서 셋 다 안 고쳤다.** 이름 둘을 바로잡는 것(`--color-deepWhite`·`--color-error`)은
|
|
756
|
+
그대로 할 일이지만, **그것으로 대비가 고쳐지지는 않는다.** 고쳐야 할 것은 수그린 글 토큰이고
|
|
757
|
+
그건 사장님 몫이다.
|
|
758
|
+
|
|
759
|
+
**셋째는 흠이 아니었다 — 또 제 짐작이 틀렸다.** 위에 `--color-primary` 의 맞는 이름이
|
|
760
|
+
`--color-main` 이라고 적었는데, 그 자리를 읽어 보니 **`.button--variant-sub`** 였다.
|
|
761
|
+
`var(--color-primary, var(--color-sub))` 에서 `--color-primary` 가 없으니 되돌림인
|
|
762
|
+
`--color-sub` 가 서는데, **`sub` 갈래 단추에 보조색이 서는 것이 맞다.** 보이는 색은 처음부터
|
|
763
|
+
옳았다. 남은 것은 **아무 일도 안 하는 겉껍데기**(`var(--color-primary, …)`)뿐이고, 그것도
|
|
764
|
+
쓰는 쪽이 색을 갈아 끼울 구멍일 수 있어 말없이 걷지 않는다.
|
|
765
|
+
|
|
766
|
+
### 어두운 꼴을 통째로 무시하던 조각 — **고침**(자가 검수)
|
|
767
|
+
|
|
768
|
+
조각 CSS 에 **박힌 색**(토큰이 아닌 값)을 셌다. 160 자리가 걸렸는데 추려 내니 33 이고
|
|
769
|
+
(되돌림 값 `var(--x, #fff)`·그늘·흰검 알파 덧칠·브랜드 면 위의 흰 글자를 뺐다), 그 가운데
|
|
770
|
+
**`UpdateAlert` 하나가 다섯**을 쥐고 있었다. 그래서 그 조각은 어두운 꼴에서 **아무것도
|
|
771
|
+
안 바뀌었다** — 어두운 화면에 **혼자 흰 덩이로** 떴다.
|
|
772
|
+
|
|
773
|
+
| | 밝은 꼴 | 어두운 꼴(고치기 전) | 어두운 꼴(고친 뒤) |
|
|
774
|
+
|---|---|---|---|
|
|
775
|
+
| 쪽 바탕 밝기 | 0.95 | **0.02** | 0.02 |
|
|
776
|
+
| 카드 바탕 밝기 | 0.95 | **0.93 — 안 따라옴** | **0.02 — 따라온다** |
|
|
777
|
+
| 제목 대비 | 18.05 | — | **12.89** |
|
|
778
|
+
| 본문 대비 | 8.24 | — | **7.88** |
|
|
779
|
+
|
|
780
|
+
**`[data-theme="dark"]` 만 덧쓰지 않았다.** 어두운 꼴은 **세 길**로 들어온다 —
|
|
781
|
+
`[data-theme="dark"]` · OS 자동(`:root:not([data-theme="light"])…`) · `[data-theme="auto"]`.
|
|
782
|
+
조각 CSS 에 한 길만 적으면 **나머지 두 길로 들어온 사람은 못 받는다.** 토큰은 그 셋에서 다
|
|
783
|
+
다시 적히므로 **토큰으로 받는 것이 세 길을 한꺼번에 맞추는 유일한 길**이다. 바탕은 흐림
|
|
784
|
+
효과 때문에 투명도가 있어야 해서 `color-mix(in srgb, var(--color-white) 92%, transparent)`
|
|
785
|
+
로 얹었다.
|
|
786
|
+
|
|
787
|
+
못은 두 가지를 센다(`test/updateAlertFollowsTheme1110.test.ts`): ① 면·글에 박힌 색이 없다
|
|
788
|
+
② 쓰는 토큰 넷이 **세 길에서 다** 다시 적힌다. 둘째 줄을 깨 보려고 **OS 자동 길에서만**
|
|
789
|
+
`--color-black` 을 빼 봤더니 그 자리를 정확히 짚으며 멎었다.
|
|
790
|
+
|
|
791
|
+
**어제 못 가린 것을 가렸다.** 어젯밤에는 "어느 토큰이 맞는지 이름 몇이 같은 값을 돌려주어
|
|
792
|
+
못 가렸다" 고 적고 올렸는데, 그건 **계산된 꼴(`getComputedStyle`)로 토큰을 물어본 탓**이었다
|
|
793
|
+
— 없는 토큰은 되돌림 값이 나와 있는 토큰과 구별되지 않는다. `tokens.css` 를 **직접 읽으니**
|
|
794
|
+
한 번에 갈렸다. 그 덕에 하나 더 찾았다 — **`WordDataUpdatePopup.css` 는
|
|
795
|
+
`var(--color-bg-secondary, #f7f9fb)` 를 쓰는데 `--color-bg-secondary` 는 tokens.css 에
|
|
796
|
+
**아예 없다** (`--color-bg-primary`·`--color-cardBg` 도 없다). 늘 되돌림 값이 서므로 그
|
|
797
|
+
자리도 어두운 꼴을 안 따라간다. **다음 바퀴 일거리로 둔다.**
|
|
798
|
+
|
|
799
|
+
나머지 28 자리는 브랜드 면 위의 흰 글자(`Button`·`Calendar`·`ChoiceChips`·`DatePicker`)와
|
|
800
|
+
`CodeBox` 의 문법 색 일곱으로, 둘 다 일부러 고정한 자리로 보인다.
|
|
801
|
+
|
|
802
|
+
### 글자를 가장 크게 키워 113쪽을 훑었다 — **새 흠 없음**(자가 검수)
|
|
803
|
+
|
|
804
|
+
시험 790개를 주제별로 세어 **가장 얇은 자리**를 찾았다: 글자 크기를 보는 시험이 **일곱**
|
|
805
|
+
뿐인데(줄 세우기 6, 움직임 줄이기 8), 글자 크기는 네 단(`medium`~`large3`)이고 거의 모든
|
|
806
|
+
글 조각에 걸린다. 어젯밤 청 (371) 도 바로 그 자리였다. 그래서 `large3` 로 113쪽을 훑었다
|
|
807
|
+
(움직임을 먼저 멈추고 쟀다 — 움직이는 동안을 재면 상자가 끌려간다).
|
|
808
|
+
|
|
809
|
+
**잘린다고 나온 285 자리를 `medium` 과 **견주어** 걸렀다. 그게 갈랐다:**
|
|
810
|
+
|
|
811
|
+
| 자리 | medium | large3 | 뜻 |
|
|
812
|
+
|---|---|---|---|
|
|
813
|
+
| 낱말 칸(`word-table-cell`) | **98/98, 최대 102px** | 95/98, 최대 82px | **글자 크기 탓이 아니다** — medium 이 더 심하다. 칸 구조가 늘 그런 꼴이다(98 칸 **전부**가 걸리는 수치는 자가 틀렸다는 뜻이다) |
|
|
814
|
+
| 표 칸(`table-cell`) | 30/292, 최대 56px | 30/292, 최대 56px | 똑같다 — 글자 크기와 무관(말줄임이 도는 자리) |
|
|
815
|
+
| 인쇄 미리보기 | 105/107 | 105/107 | 똑같다 |
|
|
816
|
+
| **갈래 이름표** | **0/10** | **3/10, 최대 8px** | **이것 하나만 글자 크기 탓이다** |
|
|
817
|
+
|
|
818
|
+
**그 하나도 새 흠이 아니다.** `.training-block-button__type-label` 은
|
|
819
|
+
`text-overflow: ellipsis` 로 **일부러 말줄임을 두는** 자리다 — `large3` 에서 「소음 하 문장
|
|
820
|
+
듣기」가 8px 넘쳐 「소음 하 문장…」이 된다. 늘려 주려면 줄을 바꿔야 하는데 그 이름표는
|
|
821
|
+
`top: 68px` 에 **절대 자리**로 박혀 있어, 줄이 늘면 아래 제목과 겹친다.
|
|
822
|
+
|
|
823
|
+
그래서 이것은 **이미 올려 둔 "상자는 고정인데 글자가 자란다" 결정의 네 번째 자리**다
|
|
824
|
+
(냅 126/138 · 훈련 블록 158/94 · 차트 260 에 이어). 새로 지어 고치지 않고 그 목록에 붙인다.
|
|
825
|
+
|
|
826
|
+
**낭독기 전용 글은 세지 않는다.** 처음에는 `board__caption`·`landing-stat-band__sr` 이
|
|
827
|
+
걸렸는데, 재 보니 1×1 에 `clip-path: inset(50%)` 인 **일부러 가린 글**이었다. 가린 것이
|
|
828
|
+
잘리는 것은 흠이 아니다.
|
|
829
|
+
|
|
830
|
+
### 알림이 낭독기에 가 닿는지 훑었다 — **다 맞았다**(자가 검수, 고친 것 없음)
|
|
831
|
+
|
|
832
|
+
새로 뜨는 알림이 낭독기에 **읽히는지**, 그리고 **끊고 읽을 일인지 뒤에 읽을 일인지**를 봤다.
|
|
833
|
+
여섯 자리 다 맞았다:
|
|
834
|
+
|
|
835
|
+
| 조각 | 꼴 | 맞나 |
|
|
836
|
+
|---|---|---|
|
|
837
|
+
| `Alert` info·success | `role="status"`(뒤에 읽음) | ✓ |
|
|
838
|
+
| `Alert` warning·danger | `role="alert"`(하던 말을 끊음) | ✓ |
|
|
839
|
+
| `Toast` | `aria-live="polite"` + `role="status"` | ✓ |
|
|
840
|
+
| `UpdateAlert` | `role="alert"` | ✓ |
|
|
841
|
+
| `ProgressIndicator` | `role="status"` | ✓ |
|
|
842
|
+
| `NoticeBox` | `role="note"` | ✓ — **살아 있는 자리가 아닌 것이 맞다**(고정 안내글이다) |
|
|
843
|
+
|
|
844
|
+
못도 이미 있다(`test/alertLiveRole0915d.test.tsx` 가 톤→역할 맞춤을 센다). **더할 것이 없어
|
|
845
|
+
아무것도 안 건드렸다.**
|
|
846
|
+
|
|
847
|
+
처음에는 토스트 쪽에서 **아무것도 못 찾았다** — 토스트는 눌러야 뜨므로 가만히 보면 0 이
|
|
848
|
+
나온다. 그 0 은 "맞다" 가 아니라 **안 닿았다**는 뜻이다. 눌러서 띄운 뒤 다시 재어
|
|
849
|
+
`polite`·`status` 를 봤다.
|
|
850
|
+
|
|
851
|
+
### 이름이 겹치는 조작부 — 나머지는 다 맞았다(자가 검수)
|
|
852
|
+
|
|
853
|
+
낱말 카드 말고 겹쳐 보였던 자리들을 다 따라가 봤다. **구획 고르개가 제일 많이 걸렸는데
|
|
854
|
+
(한 판에 셋씩) 올바른 꼴이었다** — 각 고르개가 `role="radiogroup"` 에 제 이름
|
|
855
|
+
(`페이지 번호`·`외곽선`·`절취선` …)을 달고 있고, 그 안의 단추는 **`role="radio"` 에
|
|
856
|
+
`aria-checked`**, 정지점은 하나만 도는 꼴(roving tabindex)이다. 묶음에 이름이 있으니
|
|
857
|
+
`왼쪽/중앙/오른쪽/미표시` 가 되풀이되는 것은 맞는 꼴이다. 라디오 묶음 안의 단추
|
|
858
|
+
**아흔여섯이 모두 라디오**였다(묶음에 라디오 아닌 아이가 섞이면 "넷 중 둘" 을 못 읽는다).
|
|
859
|
+
|
|
860
|
+
나머지 겹침은 **놀이터가 같은 조각을 여러 번 늘어놓은 것**이었다.
|
|
861
|
+
|
|
862
|
+
### 낱말 카드 스물이 다 `소리 듣기` 였다 — **고침**(자가 검수)
|
|
863
|
+
|
|
864
|
+
이름이 **여럿에 겹치는** 조작부를 117쪽에서 훑었다. 놀이터가 같은 조각을 여러 번 늘어놓는
|
|
865
|
+
탓에 겹침은 많았는데(278 묶음), 한 **덩이 안에서** 겹치는 참 흠이 하나 있었다.
|
|
866
|
+
|
|
867
|
+
`TrainingWordCard` 의 '소리 듣기' 단추 이름이 **늘 `소리 듣기`** 였다. 카드가 스무 장이면
|
|
868
|
+
낭독기로 단추 목록을 불렀을 때 `소리 듣기` 가 **스무 번** 잇따라 서고, 어느 것이 `나비` 고
|
|
869
|
+
어느 것이 `떡볶이` 인지 알 길이 없다(실측: 카드마다 낱말이 다 달랐다).
|
|
870
|
+
|
|
871
|
+
**이미 같은 결로 고친 자리가 있었다** — `TrainingBlockButton` 이 말귀 요청 (54)② 에서
|
|
872
|
+
`미리 듣기` 스물넷을 `{{name}} 미리 듣기` 로 고쳤다. 이쪽만 안 따라왔다. 같은 열쇠 꼴로
|
|
873
|
+
맞춘다(`training.playSoundFor` 를 새로 두고, 정지는 이미 있던 `stopFor` 를 쓴다).
|
|
874
|
+
|
|
875
|
+
함께 메운 것: **소리가 나는 중에는 하는 일이 '정지'** 다. 아이콘은 ⏸ 로 바뀌는데 이름은
|
|
876
|
+
그대로 `소리 듣기` 였다. 눈에 보이는 글(`소리 듣기`)을 **품은** 이름이라 WCAG 2.5.3 도
|
|
877
|
+
지킨다. 보기는 안 바뀐다.
|
|
878
|
+
|
|
879
|
+
**남의 시험 넷의 집는 자를 바꿨다.** `button[aria-label="소리 듣기"]` 로 단추를 집던 시험이
|
|
880
|
+
여섯 있었다(묵은 URL·소리 잠금·겹쳐 울림·사라질 때 멈춤). **그 시험들이 묻는 것은 이름이
|
|
881
|
+
아니다** — 집는 자를 `.training-word-card__bottom button` 으로 바꿨다. 뜻을 묻는 줄은
|
|
882
|
+
하나도 안 건드렸다. 거꾸로, `playAllInterrupt0915d` 가 쓰는 **가짜 카드는 이미**
|
|
883
|
+
`` `${item.word} 소리 듣기` `` 였다 — 바라던 꼴이 그쪽에 먼저 적혀 있었다.
|
|
884
|
+
|
|
885
|
+
**깨 보기 하나가 처음에 빨강이 안 났다.** '소리 나는 중' 갈래를 바꿔도 멎지 않았는데, 내
|
|
886
|
+
시험이 **누른 뒤를 아예 안 보고 있었다**. 소리를 흉내 내어 누른 뒤의 이름까지 묻게 하고
|
|
887
|
+
다시 깨 보았다(흉내는 느린 길도 흉내 내야 한다).
|
|
888
|
+
|
|
889
|
+
### 이름 없는 조작부를 다 훑었다 — **코어에 하나, 고침**(자가 검수)
|
|
890
|
+
|
|
891
|
+
단추·링크·입력에 **이름이 아예 없는** 자리를 117쪽에서 훑었다(WCAG 4.1.2). 코어에 남은
|
|
892
|
+
흠은 **하나**였다 — `CategoryIcon`.
|
|
893
|
+
|
|
894
|
+
이 조각은 설명 툴팁을 여는 트리거인데 `role="button"` 과 `tabIndex={0}` 을 **늘** 달고
|
|
895
|
+
있었다. `tooltip` 도 `label` 도 안 준 **장식 아이콘까지** 그랬다. 그러면 그 아이콘은
|
|
896
|
+
**Tab 으로 집히는 이름 없는 단추**가 된다 — 낭독기는 "단추" 라고만 읽고 눌러도 열 것이
|
|
897
|
+
없다(놀이터 랜딩 조각 쪽에서 둘을 쟀다). 그 파일은 이미 *"보여 줄 글이 없으면 올려도
|
|
898
|
+
아무 일이 없으니 표도 없다"* 고 적어 두고 **눈에 보이는 표**만 끄고 있었다 — 같은 까닭이
|
|
899
|
+
`role` 에도 닿아야 했다. 열 것이 있을 때만 단추로 둔다. 보기는 안 바뀐다.
|
|
900
|
+
|
|
901
|
+
**함께 보인 흠 하나는 안 고쳤다 — 못 박아 둔 결정이라.** 툴팁 문구가 **글자가 아닐 때**
|
|
902
|
+
(ReactNode) 이름이 `undefined` 라 "단추, 팝업 있음" 으로만 읽힌다. `설명` 처럼 **하는
|
|
903
|
+
일**을 이름으로 두면 메워지는데, 그렇게 고쳐 보니 **전체 시험이 빨강**이 났다 —
|
|
904
|
+
`test/categoryIconName.test.tsx` 가 *"문구가 글자가 아니면 이름을 안 짓는다 — 전과
|
|
905
|
+
같다"* 고 시험으로 못 박아 둔 결정이었다. 적어 둔 결정을 말없이 뒤집지 않는다.
|
|
906
|
+
**정해 주시면 그 두 줄을 함께 고칩니다.**
|
|
907
|
+
|
|
908
|
+
**제 훑개가 스물둘 가운데 스물하나를 잘못 셌다.** 보이는 글을 **잎 요소만** 훑어 모아,
|
|
909
|
+
`<a>글<svg/></a>` 처럼 **글이 바로 아이에 있는** 자리를 "이름 없음" 으로 셌다(랜딩 단추·표
|
|
910
|
+
머리 단추 등). 글 마디를 직접 걸어 다시 세니 **스물둘 → 하나**가 되었다. 남은 하나는
|
|
911
|
+
`Slider` 의 정적 꼴(`slider--static`)인데, `readOnly` 에 `tabIndex="-1"` 이라 **Tab 에
|
|
912
|
+
집히지 않는 진행률 표시**다 — 조작부가 아니라 그대로 둔다(코어 `Slider` 는 `ariaLabel`
|
|
913
|
+
프롭이 있고, 조작하는 꼴에서 이름이 없으면 이미 개발 경고를 낸다).
|
|
914
|
+
|
|
915
|
+
### 보이는 글과 들리는 이름이 다른 자리 — **고침**(자가 검수)
|
|
916
|
+
|
|
917
|
+
단추에 **보이는 글**과 낭독기가 **읽는 이름**이 같은 말인지 117쪽을 훑었다
|
|
918
|
+
(WCAG 2.5.3 Label in Name). 쉰셋이 걸렸는데 추려 보니 대부분 멀쩡했다:
|
|
919
|
+
|
|
920
|
+
| 걸린 것 | 수 | 판정 |
|
|
921
|
+
|---|---|---|
|
|
922
|
+
| `dropdown__trigger` | 32 | 보이는 글은 **지금 고른 값**이고 이름은 그 조작부의 **일**이다 — ARIA 가 그러라는 꼴 |
|
|
923
|
+
| `×` · `+` · `−` 같은 꼴표 | 5 | 글이 아니라 기호다. 목소리로는 `닫기`·`늘리기` 라 말한다 |
|
|
924
|
+
| 달력 칸 | 3 | 보이는 글은 그 날의 **자료**(날짜·방문)고 이름은 그 **일**이다 |
|
|
925
|
+
| 놀이터 데모 이름표 | 8 | 놀이터 살림(`order`·`bg` 같은 prop 이름) |
|
|
926
|
+
| **소리 나침반 스피커** | **5** | **참 흠** — 아래 |
|
|
927
|
+
|
|
928
|
+
**소리 나침반의 스피커 단추는 보이는 글과 이름이 아무 관계가 없었다.** 눈에 보이는 것은
|
|
929
|
+
**제자리 번호**(`idx + 1`)인데 이름은 쓰는 쪽이 준 `sp.label` 이었다 — 놀이터에서 재니
|
|
930
|
+
**`6` 이라 보이는 단추의 이름이 `스피커 2-1`** 이었다(스무 단추 가운데 다섯). 그래서 둘이
|
|
931
|
+
깨졌다:
|
|
932
|
+
|
|
933
|
+
1. **목소리로 쓰는 사람** — "6" 이라 말해도 그 단추가 안 집힌다(이름에 6 이 없다).
|
|
934
|
+
2. **곁에서 알려 주기** — 듣는 사람은 `스피커 2-1`, 보는 사람은 `6` 이라 부른다.
|
|
935
|
+
*"6번 눌러"* 가 통하지 않는다. 소리 방향 검사는 둘이 함께 하는 자리다.
|
|
936
|
+
|
|
937
|
+
번호를 이름 **앞**에 붙였다(목소리 조작은 앞머리를 먼저 맞춘다). **쓰는 쪽이 이미 그 수를
|
|
938
|
+
준 자리는 그대로 둔다** — 그리고 그 판정은 **글자 품음이 아니라 수 품음**이다:
|
|
939
|
+
`'스피커 2-1'.includes('1')` 은 참이지만 그 `1` 은 `2-1` 의 꼬리다. 번호가 **아이콘으로
|
|
940
|
+
갈아 끼워진 자리**(`showIcon="answered"` 의 들은·정답·오답)에는 보이는 글이 없어 붙이지
|
|
941
|
+
않는다 — 붙이면 화면에 없는 말을 들려주는 셈이다.
|
|
942
|
+
|
|
943
|
+
스무 단추를 다시 재어 **어긋남 0** 을 확인했다. 보기는 하나도 안 바뀐다.
|
|
944
|
+
|
|
945
|
+
**제 시험이 두 번 모자랐다.** ① `showIcon="answered"` 만 주고 "번호가 접힌다" 고 썼는데
|
|
946
|
+
갈아 끼우기는 **상태가 정해진 자리에서만** 일어난다 — 시험이 틀렸고 코드가 맞았다.
|
|
947
|
+
② 글자 품음으로 바꿔 깨 보았는데 **빨강이 안 났다** — 쓰던 보기들이 두 자를 가르지 못했다.
|
|
948
|
+
`스피커 11`(보이는 글은 `1`)을 넣어 가르게 했다.
|
|
949
|
+
|
|
950
|
+
### 눌러서 되는 일이 자판으로도 되는지 다 훑었다 — **깨끗했고, 못은 이미 있었다**(자가 검수)
|
|
951
|
+
|
|
952
|
+
`<div onClick=…>` 는 마우스에게만 열린 문이다 — 초점이 안 닿고 Enter·Space 도 안 듣는다.
|
|
953
|
+
이 저장소에 그런 자리가 **마흔셋**인데 훑어 보니 **다 길이 있었다**:
|
|
954
|
+
|
|
955
|
+
| 갈래 | 수 | 자판 길 |
|
|
956
|
+
|---|---|---|
|
|
957
|
+
| 제 속성으로 길을 낸 자리 | 23 | `pressable(…)` 또는 role+tabIndex+onKeyDown |
|
|
958
|
+
| 막이(`stopPropagation`) | 7 | 아무 일도 안 한다 — 받을 것이 없다 |
|
|
959
|
+
| 뒤막(바깥 누름으로 닫기) | 3 | Esc 가 같은 일을 한다 |
|
|
960
|
+
| 누름감 넓히기 | 6 | 그 일을 하는 **참말 단추가 안에 있다** |
|
|
961
|
+
| 일부러 누르는 자리가 아닌 것 | 4 | 값을 읽는 자리 · ARIA combobox 의 보기 등 |
|
|
962
|
+
|
|
963
|
+
**고칠 것은 없었다. 그리고 못도 이미 있었다 — 내가 하나를 더 쓴 뒤에 알았다.**
|
|
964
|
+
`test/clickNeedsKeyboard.test.ts`(176줄)가 **똑같은 일을 벌써 하고 있었다**: 같은 세 가지
|
|
965
|
+
(role·tabIndex·키 처리)를 묻고, 같은 **까닭 목록**을 쥐고, 같은 닻("시험이 헛돌지
|
|
966
|
+
않는다")까지 두고 있다. 게다가 내 것보다 낫다 — 막이를 **손으로 적는 대신 이름 붙은
|
|
967
|
+
핸들러까지 따라가 걸러 낸다**(그래서 목록이 아홉이고 내 것은 스물이었다).
|
|
968
|
+
|
|
969
|
+
**내 것을 지웠다.** 둘을 같이 두면 눌리는 `div` 를 하나 더 만들 때 **까닭을 두 목록에
|
|
970
|
+
적어야** 한다 — 오늘 밤 내내 고쳐 온 "같은 결정이 두 자리에 적힌" 바로 그 결함을 내가
|
|
971
|
+
새로 만드는 셈이다.
|
|
972
|
+
|
|
973
|
+
**훑개를 손으로 짓다가 두 번 틀렸다.** 처음 regex 는 중괄호가 겹친 자리에서 속성이 잘려
|
|
974
|
+
뒤에 적힌 `role`·`tabIndex` 를 못 보았다 — 멀쩡한 자리가 흠으로 올라오고(24 → 33),
|
|
975
|
+
거꾸로 `BarChart` 의 막대는 **`onClick` 이 아예 없는데도** 목록에 올라왔다. 이 저장소에는
|
|
976
|
+
그 함정을 이미 피한 `test/jsxTagScan.ts` 가 있어서 그것으로 바꿔 다시 셌다.
|
|
977
|
+
|
|
978
|
+
**배운 것: 못을 세우기 전에 그 못이 이미 있는지 먼저 센다.**
|
|
979
|
+
|
|
980
|
+
### 단계 상태 셋이 다섯 자리에 적혀 있다 — **못을 세웠다**(자가 검수)
|
|
981
|
+
|
|
982
|
+
훈련 단계는 `disabled` · `done` · `active` 셋뿐인데, 그 셋이 다섯 자리에 흩어져 있다 —
|
|
983
|
+
본이 되는 `StepState`, 손으로 다시 적은 `computeState` 의 돌려주는 꼴, 그리고 CSS 세
|
|
984
|
+
자리(`.ts-bullet--` · `.training-step__title-row--` · `.training-text-box--`). 넷째
|
|
985
|
+
상태가 생기면 다섯을 다 손대야 하고, CSS 에만 더하면 타입에 없고 타입에만 더하면 화면이
|
|
986
|
+
안 바뀐다. 다섯이 같은 셋을 쥐는지 센다(`test/stepStateSetAgrees1110.test.ts`, 여섯 가지로
|
|
987
|
+
깨 보아 다 빨강 확인).
|
|
988
|
+
|
|
989
|
+
**이 못을 쓰다가 제 못에 걸렸다.** CSS 밑자리 이름을 `.training-step-title--` 로 **짐작해서**
|
|
990
|
+
적었는데 실제 이름은 `.training-step__title-row--` 였다. "그 밑자리가 아직 그 파일에
|
|
991
|
+
있는지" 를 먼저 세는 닻을 같이 두었던 덕에 **빈 셋을 초록으로 넘기지 않고 멎었다.**
|
|
992
|
+
|
|
993
|
+
#### 찾았으나 안 고친 것 — **사장님 결정이 필요하다**
|
|
994
|
+
|
|
995
|
+
`@public` 컴포넌트 **셋이 이 상태를 `state?: string` 으로 받는다** —
|
|
996
|
+
`TrainingStepBullet`(타입이 아예 없어 `string` 으로 미뤄진다) · `TrainingStepTitle` ·
|
|
997
|
+
`TrainingStepTextBox`. 그래서 `state="banana"` 가 **타입 검사를 지나가고** 아무 상태도 안
|
|
998
|
+
걸린 단계가 뜬다.
|
|
999
|
+
|
|
1000
|
+
바른 꼴은 셋 다 `StepState` 를 받는 것인데 **그건 쓰는 쪽을 깨뜨릴 수 있습니다** — 코어는
|
|
1001
|
+
타입을 함께 펴내므로 앱이 `state={someString}` 처럼 넓은 값을 건네고 있으면 좁히는 순간
|
|
1002
|
+
앱 빌드가 멎습니다. 앱 쪽을 함께 보고 정할 일이라 오늘은 안 좁혔고, 그 자리가 **아직
|
|
1003
|
+
셋인 것**을 못이 지키고 있습니다(하나라도 좁혀지면 멎어서 알려 줍니다).
|
|
1004
|
+
|
|
1005
|
+
### 구분선 라벨은 일부러 그대로 둔다 — **이미 적어 둔 결정이다**(자가 검수)
|
|
1006
|
+
|
|
1007
|
+
`Divider` 에 `label` 을 주면 `role="separator"` 안에 글이 들어간다. 낭독기 나무를 읽어
|
|
1008
|
+
보니 그 글은 **이름으로 안 올라간다**(`separator` 로만 뜬다). `aria-label` 을 붙이면
|
|
1009
|
+
올라가지만, 놀이터 그 쪽이 이미 *"구분선의 내용은 표시용으로 다뤄져 낭독기가 라벨을 건너뛸
|
|
1010
|
+
수 있습니다 — 거기에만 정보를 두지 마십시오"* 라고 **적어 둔 결정**이다. 적어 둔 공개
|
|
1011
|
+
움직임을 말없이 바꾸지 않는다.
|
|
1012
|
+
|
|
1013
|
+
### 배너 배경 열넷에 못을 세웠다 — **색은 안 고쳤고, 잰 표를 올린다**(자가 검수)
|
|
1014
|
+
|
|
1015
|
+
시험이 한 번도 안 불리는 컴포넌트가 열여섯인데 **그 가운데 열셋이 `PromoBannerBg*`**
|
|
1016
|
+
한 식구였다. 그 식구를 들여다보니 같은 결정이 **두 자리**에 적혀 있었다 —
|
|
1017
|
+
`promoBannerBg.ts` 의 `textTone: 'light' | 'dark'`(고르개에 "밝은 글" / "어두운 글" 로
|
|
1018
|
+
뜨는 것)과 각 `PromoBannerBg<이름>.tsx` 가 **실제로 주입하는 글 색**이다. 어긋나면
|
|
1019
|
+
고르개의 글과 화면이 다른데, 지금은 열넷이 다 맞다. 그 상태를 셈으로 묶었다
|
|
1020
|
+
(`test/promoBannerBgToneAgrees1110.test.ts` — 파일·보기 목록·그리는 표·테마 **넷이 같은
|
|
1021
|
+
열넷**인지, 글빛이 실제 색과 같은 쪽인지, 열넷이 다 테마를 심고 **떠날 때 거두는지**).
|
|
1022
|
+
|
|
1023
|
+
**못 하나가 거짓 초록이었다 — 깨 보고 잡았다.** 거두는 자리를 `() => {}` 로 비워도
|
|
1024
|
+
*쓰이지 않는 import 줄에 `clearPromoBannerBgTheme` 라는 글자가 남아* 초록이 났다.
|
|
1025
|
+
이름이 아니라 **`useParentBgTheme(…)` 의 셋째 인자**를 세도록 고쳤다.
|
|
1026
|
+
|
|
1027
|
+
**설명 색은 밝기 가름으로 안 센다.** 처음엔 같은 자로 쟀더니 `dark` 배경에서 멎었는데
|
|
1028
|
+
(제목 `--color-white` 0.98 / 설명 `--color-lightGray` 0.365), 그 자리를 실제로 재면
|
|
1029
|
+
**4.63:1 로 통과한다** — 어두운 바탕 위에 일부러 수그린 밝은 글이다. 가름을 0.35 로
|
|
1030
|
+
내리면 지나가지만 그건 지금 값에 맞춰 문을 옮기는 것이라 걷었다.
|
|
1031
|
+
|
|
1032
|
+
#### 잰 대비 — **사장님 결정이 필요한 자리**
|
|
1033
|
+
|
|
1034
|
+
폭 900 배너를 직접 지어 열넷의 제목(24px/500 → 큰 글, 3:1)과 설명(14px/400 → 4.5:1)을
|
|
1035
|
+
각 배경의 **가장 나쁜 그라디언트 끝**에 대고 쟀다. **28 가운데 16 이 기준 아래**다.
|
|
1036
|
+
|
|
1037
|
+
| 배경 | 제목 (3:1) | 설명 (4.5:1) |
|
|
1038
|
+
|---|---|---|
|
|
1039
|
+
| Instagram | **1.51** | **1.42** |
|
|
1040
|
+
| Main | **1.94** | **1.76** |
|
|
1041
|
+
| Radial | **1.94** | **1.76** |
|
|
1042
|
+
| Sub | **1.94** | **1.76** |
|
|
1043
|
+
| Naver | **2.25** | **1.97** |
|
|
1044
|
+
| Success | **2.74** | **2.38** |
|
|
1045
|
+
| Soft | **2.96** | 4.76 |
|
|
1046
|
+
| Diagonal | 5.44 | **3.60** |
|
|
1047
|
+
| Dots | 3.93 | **3.86** |
|
|
1048
|
+
| Deep | 4.86 | **3.99** |
|
|
1049
|
+
| Dark | 11.49 | 4.63 |
|
|
1050
|
+
| Outline | 18.52 | 4.67 |
|
|
1051
|
+
| SoftSub | 4.86 | 4.76 |
|
|
1052
|
+
| Warm | 10.26 | 4.69 |
|
|
1053
|
+
|
|
1054
|
+
까닭은 하나다 — **흰 글이 옅은 브랜드 색 위에 선다.** `--color-sub`(#4DCDC0)는 밝아서
|
|
1055
|
+
(L 0.49) 흰 글을 얹으면 1.94:1 이다. `Soft` 의 2.96 은 앞서 올린 **브랜드 단추 건과 같은
|
|
1056
|
+
뿌리**(`--color-main` 이 흰 바탕에서 2.96)다.
|
|
1057
|
+
|
|
1058
|
+
**색은 안 고쳤다.** 이것은 배너 열넷의 생김새를 통째로 바꾸는 **보기 결정**이고, 흰 글을
|
|
1059
|
+
어두운 글로 돌리면 브랜드 띠의 느낌이 달라진다. Instagram·Naver 는 그 회사 색을 그대로
|
|
1060
|
+
옮긴 것이기도 하다. 고치는 길은 ① 글을 어둡게 ② 배경 색을 짙게(`--color-deepSub` 등)
|
|
1061
|
+
③ 글 뒤에 옅은 그늘을 깔기 — 어느 쪽이든 사장님이 보고 정할 일이라 수만 올린다.
|
|
1062
|
+
|
|
1063
|
+
### 손가락으로 짚기 어려운 자리를 다 훑었다 — **고칠 것이 없었고, 못 하나를 세웠다**(자가 검수)
|
|
1064
|
+
|
|
1065
|
+
WCAG 2.5.8 은 누르는 자리를 **24×24** 로 물어본다. 폭 375 에서 50쪽을 훑어
|
|
1066
|
+
어느 한 변이라도 24 아래인 마디를 모두 세었다 — **69개**. 추려 보니 고칠 것은 없었다:
|
|
1067
|
+
|
|
1068
|
+
| 걸린 것 | 수 | 판정 |
|
|
1069
|
+
|---|---|---|
|
|
1070
|
+
| 놀이터 글 속 링크(`<a>` 15.5px) | 58 | 놀이터 살림이고, 글 속 링크는 면제 대상 |
|
|
1071
|
+
| `checkbox__input` 1×1 | 1 | 숨은 네이티브 입력 — 보이는 상자가 누르는 자리다 |
|
|
1072
|
+
| `tabs__panel` 21px | 2 | 초점 받는 **구역**이지 누름 단추가 아니다 |
|
|
1073
|
+
| `word-table__card-*` 12.9×12.9 | 4 | 폭 1440 에서 **27.2×27.2** 다(폰에서는 `opacity: 0` — 안 떠 있다) |
|
|
1074
|
+
| `table-field__button` 20.6 | 1 | 폭을 칸에 맞추는 단추다 — 좁은 것은 그 칸의 폭이고, 쓰는 쪽이 정한다 |
|
|
1075
|
+
| 표의 네이티브 체크박스 13×13 | 1 | **놀이터 데모 markup** 이다(코어는 `Checkbox` 를 쓴다) |
|
|
1076
|
+
| `top-banner__dot` 12×24 | 2 | 아래에 적는다 — 이미 재어 고쳐 둔 자리다 |
|
|
1077
|
+
|
|
1078
|
+
**띠 점은 전에 이미 고쳐 둔 자리였다.** 6px 점의 누름 자리를 투명한 속 애(`::after`)로
|
|
1079
|
+
키워 두었는데, 그 가로가 `calc(100% + 6px)` 이고 점 사이 틈이 `gap: 6px` 이다 —
|
|
1080
|
+
**같은 수가 두 자리에 적혀 있다.** 어긋나면 전에 났던 결함이 돌아온다: 누름 자리가
|
|
1081
|
+
옆 점의 중심까지 덮으면 겹친 데서 DOM 뒤의 형제가 이겨, **점을 정확히 눌러도 오른쪽
|
|
1082
|
+
배너로 넘어갔다**. 글로 "둘을 함께 바꿔라" 라고 적힌 것을 **셈으로 바꿨다**
|
|
1083
|
+
(`test/topBannerDotHitArea1110.test.ts` — 틈만 10px 로 바꿔 보아 빨강을 확인했다).
|
|
1084
|
+
|
|
1085
|
+
쉰 점의 가로 12 는 24 에 못 미치고 틈 면제도 못 받는다(중심 간 12px). **24 로 가는 길은
|
|
1086
|
+
점 사이 틈을 18px 로 벌리는 것 하나뿐인데**, 눈에 보이는 간격이 바뀌는 보기 결정이라
|
|
1087
|
+
사장님 몫으로 둔다. 지금 꼴이 스스로 어긋나지 않는 것까지만 센다.
|
|
1088
|
+
|
|
1089
|
+
|
|
10
1090
|
## 0.425.0 — **히어로 비주얼: 안 자르기 · 한 바퀴만 돌기**
|
|
11
1091
|
|
|
12
1092
|
### 빈 칸의 `+` 가 **첫 칸에만** 선다 — **바뀜**(말귀 요청 386)
|