Skip to content

整合原生 Standard/Latest 按鈕與必要無障礙回饋 - #95

Merged
perditavojo merged 3 commits into
mainfrom
dev
Nov 15, 2026
Merged

perditavojo merged 3 commits into
mainfrom
dev

Conversation

@perditavojo

@perditavojo perditavojo commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

變更

共用按鈕以原生 Standard/Latest 為基礎,一般、懸停及停用保留原生表面與動態強調色;必要的焦點反轉、粗體、預設動作、按壓及 Dwell 提示集中於 FeedbackButton,不改寫 BackColor/ForeColor 或重設原生渲染器快取。分離 Space 與滑鼠按壓來源,處理 Capture 取消、舊接合與 DPI 字型更新,保留全域 Latest/Deferred、既有輸出與必要重啟提示。

審查補強:生命週期取消獨立於 Timer,滿格或停用 UI 特效後仍清除提示,換權杖與 Dispose 解除舊註冊。初始化偏好尺寸依 Bold 字型與 DPI 為置中文字保留固定空間,避免較矮訊息框按鈕被 Dwell 遮字,互動期間尺寸、Padding、Margin 與 HWND 不變。同步工程規範與測試文件。

驗證

  • Release -warnaserror:0 警告、0 錯誤;修改 C# 的 severity info style/analyzers 報告均為空。
  • 淺色、深色、實際 Windows 高對比各 72/72;96 DPI 隔離渲染 72/72。
  • 實際關閉 UI 特效後,滿格取消/換權杖/Dispose 6/6;高對比與 UI 特效已還原。
  • 非 UI 完整重跑 456/456。新增 20 項回歸,UI 總數 87,其中七語系訊息框大小按鈕逐像素驗證部分與滿格 Dwell 不遮住標題。
  • 文字 ≥4.5:1,互動提示與 Dwell 主填色對可見襯底 ≥3:1;高對比按壓交換系統色並增加內框。保留既有 Blink、主題重啟提示與 RTL 回歸。

本機完整 UI 82/87,5 項 FlaUI 選單/對話框操作受本機觸控鍵盤遮擋等環境因素干擾,保留失敗記錄,不略過測試;最新提交 5fd6256 的 GitHub Runner 完整 CI 為非 UI 456/456、UI 87/87,均無失敗或略過。實際顯示為 125%/120 DPI,96 DPI 為明確驗證 DeviceDpi 的隔離渲染,未切換其他實際顯示器縮放或系統強調色。

首輪 CI 的 4 項 Dwell 假失敗為 96 DPI 下取樣向內偏移,已改驗證四邊實際襯底;前一提交的 CI 為非 UI 456/456、UI 67/67。另有一次既有非 UI 設定檔併發暫存檔偶發失敗,完整重跑及三次獨立程序均通過,詳見測試 README。

本次限定 InputBox 自家視覺回饋,不改變核心剪貼簿輸出、控制器映射或第三方程式行為;部分官方條款頁面僅能取得框架,因此不宣稱完整條款本文審查完成。

最新 CI(5fd6256)全部成功,建置 0 警告/0 錯誤,CodeQL 與相依套件檢查成功,已讀取 UI 真實日誌確認 87/87。兩項 Copilot 問題已修正、回覆並標為已解決。建置與測試。

一般、懸停與停用沿用 Standard/Latest 原生渲染,不假設固定強調色。
集中焦點、預設動作、按壓與 Dwell 提示,移除重複動畫與配色流程。
分離 Space 與滑鼠狀態,處理 Capture 取消、過期接合與 DPI 字型更新。
同步 Dwell 襯底、高對比按壓及回歸測試規範。

淺色、深色與高對比各 52 項通過,完整 UI 67 項通過。
非 UI 完整重跑 456 項通過;首輪併發暫存檔偶發失敗及重驗結果已記錄。
Release 建置零警告零錯誤,資訊層級診斷清零。
96 DPI 襯底只有一像素,舊取樣向內偏移後落在進度填色。
改驗證四邊實際可見襯底,保留主填色與文字對比要求。
加入明確驗證 DeviceDpi 的 96 DPI 隔離模式並同步測試說明。

96 DPI 完整按鈕 52 項通過,三主題與 96/120 DPI 襯底驗證通過。
建置零警告零錯誤,資訊層級診斷清零;正式按鈕渲染未變更。
@perditavojo
perditavojo marked this pull request as ready for review November 15, 2026 06:41
Copilot AI balanced review requested due to automatic review settings November 15, 2026 06:41

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Dwell 襯底會遮住較矮按鈕的標題,且進度填滿或停用 UI 特效後,取消權杖無法清除滿格提示。

2 open issues
What changed in this PR

此 PR 將 InputBox 共用按鈕整合至原生 Standard/Latest 外觀,並將必要的無障礙視覺回饋集中於 FeedbackButton,保留既有輸出與控制器行為。

變更:

  • 一般、懸停及停用狀態保留原生表面,焦點、按壓與 Dwell 改由集中疊層繪製。
  • 分離滑鼠與 Space 按壓狀態,加入過期接合防護,並讓字型更新保留互動進度。
  • 擴充按鈕渲染與生命週期測試,同步工程規範及驗證紀錄。
File Description
tests/​InputBox.Tests/​README.md 更新測試清單、主題與 DPI 驗證紀錄。
tests/​InputBox.Tests/​ButtonFeedbackRenderingTests.cs 擴充原生外觀、Dwell、互動及在地化測試。
src/​InputBox/​Core/​Extensions/​ControlExtensions.cs 移除舊按鈕繪製及 Dwell 動畫輔助方法。
src/​InputBox/​Core/​Extensions/​ButtonEyeTrackerExtensions.cs 將回饋呼叫轉交 FeedbackButton。
src/​InputBox/​Core/​Controls/​PhraseManagerDialog.Layout.cs 動作按鈕改用 Standard。
src/​InputBox/​Core/​Controls/​PhraseManagerDialog.cs 關閉按鈕改用 Standard。
src/​InputBox/​Core/​Controls/​PhraseEditDialog.cs 確認與取消按鈕改用 Standard。
src/​InputBox/​Core/​Controls/​NumericInputDialog.Layout.cs DPI 更新同步一般與粗體回饋字型。
src/​InputBox/​Core/​Controls/​NumericInputDialog.cs 數值對話框按鈕改用 Standard。
src/​InputBox/​Core/​Controls/​HelpDialog.cs 說明視窗關閉按鈕改用 Standard。
src/​InputBox/​Core/​Controls/​GamepadMessageBox.cs 採用 Standard 並同步回饋字型。
src/​InputBox/​Core/​Controls/​GamepadCalibrationDialog.Layout.cs DPI 更新同步校正按鈕回饋字型。
src/​InputBox/​Core/​Controls/​GamepadCalibrationDialog.cs 校正對話框按鈕改用 Standard。
src/​InputBox/​Core/​Controls/​FeedbackButton.cs 集中互動狀態、Dwell 計時與回饋繪製。
docs/​engineering/​a11y-safety.md 更新原生表面、互動清理與對比規範。

Review effort: Balanced

加入獨立的生命週期取消通知,滿格或停用 UI 特效後仍能清除提示。
換權杖與處置時解除舊註冊,防止過期通知影響新生命週期。
初始化偏好尺寸時為原生置中文字預留固定 Dwell 空間,不在互動時改尺寸。
新增二十項七語系小按鈕與取消回歸,同步無障礙規範和測試紀錄。

三主題各七十二項、96 DPI 七十二項及停用 UI 特效六項通過。
本機完整 UI 的五項環境干擾失敗已保留紀錄,交由最新 CI 完整驗證。
建置零警告零錯誤,資訊層級診斷清零。
@perditavojo
perditavojo merged commit 5fd6256 into main Nov 15, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants