Skip to content

Commit 9d8a767

Browse files
committed
docs(ui): 更正 Button 首创断言(首个 focus-visible 在 Surface)
1 parent 930c0a5 commit 9d8a767

2 files changed

Lines changed: 4 additions & 4 deletions

File tree

‎app/src/ui/primitives/Button.css‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
* 四态与本文件的对应(验收逐条打勾):
1212
* ① hover → `.ed-btn--{primary,secondary,ghost}:hover:not(...)`(三档各自成立)
1313
* ② active 按下微陷 → `.ed-btn:active:not(...)` 的 `translateY(1px)`
14-
* ③ focus-visible → `.ed-btn:focus-visible` 的 2px `--ed-ink-1` 焦点环(全仓首个 `:focus-visible`)
14+
* ③ focus-visible → `.ed-btn:focus-visible` 的 2px `--ed-ink-1` 焦点环(本批第二个;全仓首个在 `Surface.css`)
1515
* ④ disabled/busy → `.ed-btn:disabled, .ed-btn[aria-disabled="true"]` 的视觉降级
1616
*
1717
* 边界:
@@ -75,7 +75,7 @@
7575
「收到了」= 悬停变色,「正在按」= 下沉 1px;松开即回到 hover 值(transition 自动回程)。 */
7676
.ed-btn:active:not(:disabled):not([aria-disabled="true"]) { transform: translateY(1px); }
7777

78-
/* ③ focus-visible:全仓首个焦点环。`--ed-ink-1` 亮档是墨黑、暗档是纸白 ⇒ 自动反相,无需第二条规则。
78+
/* ③ focus-visible:本批的焦点环(全仓首个在 `Surface.css:73`,本文件非首创)。`--ed-ink-1` 亮档是墨黑、暗档是纸白 ⇒ 自动反相,无需第二条规则。
7979
用 `:focus-visible` 而非 `:focus`:鼠标点击不该留环,键盘 Tab 必须看得见。
8080
outline 不吃 hover 背景 ⇒ 与 hover 同时成立时**焦点环永远可见**(§8.6.1 第 4 条:无障碍优先于「活」)。 */
8181
.ed-btn:focus-visible { outline: 2px solid var(--ed-ink-1); outline-offset: 2px; }

‎app/src/ui/primitives/Button.tsx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,8 @@
77
* 用户对动效纲领的答复是「我希望我在对其进行交互时,它是活的」(规格 §8.6.1)⇒ 本组件是那条
88
* 纲领落地的第一块基石:悬停有反应、按下有回执、焦点看得见、禁用看得出来。
99
*
10-
* 副作用:`import "./Button.css"` —— 首个引入本原语的模块会带上该样式表;它含**全仓首个
11-
* `:focus-visible`** 与首条按钮 `:disabled` 视觉降级。类规则只作用于 `.ed-btn` 元素,现存组件
10+
* 副作用:`import "./Button.css"` —— 首个引入本原语的模块会带上该样式表;它含**本批第二个
11+
* `:focus-visible`**(全仓首个在 `Surface.css:73`,本原语非首创)与首条按钮 `:disabled` 视觉降级。类规则只作用于 `.ed-btn` 元素,现存组件
1212
* 没有该类 ⇒ 批 0-D 期间**界面零变化**(本批不迁移任何调用点)。组件本身不读 store、不发请求、
1313
* 不写磁盘。
1414
*

0 commit comments

Comments
 (0)