Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 13 additions & 10 deletions docs/engineering/a11y-safety.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,22 +22,25 @@
- 鍵盤焦點:強烈靜態視覺回饋 (反轉、字體加粗)。
- 按壓狀態:獨立於焦點的第三層級。深色模式使用飽和暖色 (琥珀色 `255,200,120`),亮度差 **ΔL*≥13**。
- **Tritanopia 調整亮度公式**:$L_{tritan} = (R_{lin} \times 0.2126 + G_{lin} \times 0.7152) / 0.9278$。
- **Dwell 與 Latest 交接**:共用眼動儀回饋按鈕使用 "FeedbackButton";回饋結束先還原 Color.Empty,再清除該按鈕的原生背景動畫快取,讓背景、文字與提示框於同一幀還原。不得為此切換 VisualStylesMode、重建 HWND 或改變版面。
- 視窗未啟用時仍須保持懸停文字與背景成對,不以略過自訂回饋後交回原生懸停取代;這不應啟用視窗或移動焦點。
- Dwell 更新在 UI 寫入前再次檢查動畫識別碼,避免過期更新重啟已結束的視覺。測試須涵蓋三種主題、啟用/未啟用視窗、預設/一般按鈕的整段過渡取樣,不能只檢查最後一幀。
- **Standard/Latest 與必要疊層**:共用回饋使用 `FeedbackButton`,一般、懸停及停用沿用原生 Standard 表面;不得將系統強調色假設為藍色,不以固定黑/白文字取代原生選色。
- 焦點反轉、粗體、按壓及提示框使用必要疊層,不寫入按鈕 BackColor/ForeColor,不切換 VisualStylesMode、不重建 HWND。保留 System 色彩模式、Deferred 顯示與必要重啟提示。
- 高對比焦點使用 Highlight/HighlightText;按壓交換此系統色對並加入固定位置的內框。兩狀態的文字與內框都須通過實際相鄰像素對比,不只依賴色相區分。
- 視窗未啟用時仍提供成對原生懸停與提示,不啟用視窗或移動焦點。滑鼠與 Space 按壓獨立管理;MouseLeave/Capture 取消只清除滑鼠來源,失焦或停用清除所有按壓。
- Dwell 使用控制項自己的 UI Timer。更新字型、DPI、語系或系統色只更新設定與繪圖,不重建互動狀態/重啟進度;取消、表單權杖結束、HandleDestroyed 與 Dispose 終止計時。進度不作為懸停狀態的替代旗標。權杖取消必須有獨立 UI 通知,滿格停止 Timer 或停用 UI 特效時也須清除提示;更換權杖及 Dispose 時解除舊註冊,已排程的舊通知不可影響新生命週期。
- 點擊後接合不得覆蓋更新的互動或明確取消,也不得自動產生點擊。測試涵蓋三主題、啟用/未啟用視窗、預設/一般按鈕、完整過渡與滑鼠/鍵盤交錯。
- **預設動作引導**:當焦點在輸入框時,`AcceptButton` 必須顯示與焦點框一致的情境感知邊框色;強視覺反轉情境使用 **Cyan / MediumBlue**,中性情境使用 **LightBlue / MediumBlue**。
- 輸入框與預設動作提示須共用情境選色,並在輸入框底色/焦點變更時重繪。Latest 的強調色按鈕不得使提示對比下降;可在提示邊框緊鄰處繪製對比襯底,保留按鈕本體與原生主題外觀,不得改變尺寸、Margin 或 Padding。
- 測試須量測實際渲染的邊框與相鄰背景,不得只比對顏色名稱;同時覆蓋反轉及中性情境、三種主題與進度條主填色的對比。文件中對比數值為四捨五入顯示,不取代未取整的最低門檻。
- **眼動儀優化與視覺穩定性**:
- **視覺凍結 (Zero-Jitter)**:狀態變更嚴禁變動物理尺寸、Margin 或 Padding。
- **抗抖動鎖定 (Anti-Jitter Lock)**:初始化時預先計算 **Bold** 狀態最大寬度並鎖定為 `MinimumSize`。
- **懸停進度條對比 (WCAG 1.4.11)**:填色須以按鈕「**實際**底色」為基準,使用 `btn.BackColor.GetBrightness() > 0.5f`(`Color.Empty` 時退回至 `!isDark`)動態選色,**禁止**直接使用 `isDark` 旗標(懸停時 `ApplyStrongVisual` 會反轉底色,`isDark` 與實際底色脫節):
- 底色為淺色(亮度 > 0.5,含懸停反轉後的 White)→ **Green** + CVD 紋理 PaleGreen。
- 底色為深色(亮度 ≤ 0.5,含懸停反轉後的 Black)→ **LimeGreen** + CVD 紋理 DarkGreen。
- 自然狀態對比:淺色模式 Green vs `#DCDCDC` = 3.75:1 ✅;深色模式 LimeGreen vs `#3C3C3C` = 5.21:1 ✅。
- 懸停反轉對比:深色模式 bg→White,Green vs White = 5.14:1 ✅;淺色模式 bg→Black,LimeGreen vs Black = 9.91:1 ✅。
- **抗抖動鎖定 (Anti-Jitter Lock)**:初始化時預先計算 **Bold** 狀態最大寬度並鎖定為 `MinimumSize`。AutoSize 的偏好高度須依 Bold 文字及 DPI 預留原生置中文字上下的固定空間,確保完整 Dwell 襯底與字形不重疊;不得等懸停才擴高或改 Padding。
- **懸停進度條對比 (WCAG 1.4.11)**:以實際相鄰的可見襯底為基準,不以原生按鈕 BackColor 屬性推測已渲染的強調色。填滿至 100% 時襯底仍須在四邊可見(至少 1 個實體像素,依 DPI 縮放)。
- 淺色使用 #DCDCDC 襯底、Green 主填色、PaleGreen 色覺紋理,主填色對比約 3.75:1。
- 深色使用 #3C3C3C 襯底、LimeGreen 主填色、DarkGreen 色覺紋理,主填色對比約 5.21:1。
- 高對比使用 Highlight 襯底與 HighlightText 填色,不硬編碼替代系統色。
- 主填色對襯底須 ≥3:1;紋理不能取代主填色門檻,亦不把裝飾混色像素誤當成主填色。襯底與進度皆在固定範圍內繪製,不變動控制項尺寸、Margin 或 Padding。
- **色覺友善 (CVD) 與亮度計算**:
- **情境感知焦點邊框色**:依 `BackColor` 實際值與主題動態選取(完整 4 情境):
- **情境感知焦點邊框色**:依目前視覺表面/輸入情境與主題動態選取(完整 4 情境):
- `BackColor == Black`(淺色反轉,強視覺)→ `Cyan` (16.75:1 AAA)
- `BackColor == White`(深色反轉,強視覺)→ `MediumBlue` (11.16:1 AAA)
- 深色中性(未反轉,深色主題)→ `LightBlue` (≥7.2:1 AAA)
Expand Down
Loading
Loading