Skip to content

fix(ui): 修复下拉框选项悬停色过渡发灰及结束后残留 [Claude-Fable-5.2] - #50

Merged
Chiloven945 merged 1 commit into
PCL-Community:devfrom
zhuzhi-09:fix/38-combobox-hover-color
Nov 16, 2026
Merged

Chiloven945 merged 1 commit into
PCL-Community:devfrom
zhuzhi-09:fix/38-combobox-hover-color

Conversation

@zhuzhi-09

@zhuzhi-09 zhuzhi-09 commented Nov 16, 2026 •

Copy link
Copy Markdown

变更说明 / Summary

下拉框选项(MyComboBoxItem)的背景色过渡有两个问题,对应 issue 中的“滞后”和“残留”:

  1. 过渡途中发灰:选项“无背景”时的目标色是透明黑 (0,0,0,0)。从悬停色淡出时,RGB 与 Alpha 一起插值,中途变成半透明的深灰,在浅色主题的白底上很明显,看起来像高亮拖在鼠标后面。淡入时同理,是从透明黑开始的。
  2. 结束后残留:过渡使用相对值的 ColorAnimation,每帧读回已取整的颜色、加上增量、再取整写回,舍入误差逐帧累积,动画结束时到不了目标值,留下一层淡色。帧数越多(刷新率越高)误差越大。

修改:

  • 透明端保留颜色、仅 Alpha 为 0:淡出目标为“当前颜色、Alpha 0”,淡入起点为“目标颜色、Alpha 0”,过渡中只有透明度变化。
  • 改用绝对值的 NColorFromToAnimation(From 当前色 → To 目标色),每帧直接写入插值结果,不再累加。

动画时长(淡入 100ms、淡出 300ms)、悬停色与选中色均未改动。

关联 Issue / Related Issue

Closes #38

验证方式 / Verification

构建

  • .NET SDK 11.0.100-rc.3.26522.148,dotnet publish PCL.Launcher/PCL.Launcher.csproj -c Debug -r win-x64 --no-self-contained -p:Platform=x64,编译通过

运行测试(Windows 11 x64,60Hz)

展开“设置 → 启动 → 启动器可见性”下拉框,用脚本移动鼠标并截图,读取各选项行的像素颜色。

浅色主题:

鼠标离开约 0.1 秒(淡出中) 鼠标离开 2 秒后
修复前 (205,209,216),比悬停色 (235,243,252) 更深 (253~254),未回到 255
修复后 (240,245,253) (255,255,255)

深色主题:修复前划过的行结束后为 (39,39,39),背景为 (40,40,40);修复后均为 (40,40,40)。

运行测试(Windows 11 x64,240Hz,浅色主题)

同样的步骤在 240Hz 显示器上再测一遍,修复前的偏差比 60Hz 下更大:

场景 修复前 修复后
悬停时的颜色(目标 (235,243,252)) (234,239,255) (235,242,252)
鼠标移到另一项后约 0.1 秒(原项淡出中) (194,197,208) (241,246,253)
快速来回划过后约 0.1 秒 (214,214,214)、(185,188,191) (252,253,254)、(243,247,253)
鼠标离开 2 秒后 (250,250,250) (255,255,255)

60Hz 下结束后的残留为 1~2 个色阶,240Hz 下为 5 个色阶,且悬停色本身也偏离目标值,与“舍入误差随帧数累积”一致。

对比截图见下方(第一张为 60Hz,第二张为 240Hz)。
i38_compare

未覆盖

  • macOS / Linux 未测试
  • 键盘导航下的高亮过渡走同一段代码,未单独测试

说明

  • 相对值颜色动画的舍入累积并非下拉框独有,InputAnimation.AnimateColor 等处使用同样的方式。本 PR 只修改了 issue 涉及的 MyComboBoxItem,未改动公共动画代码。

AI 使用情况 / Generative Artificial Intelligence Usage

  • 使用情况 / Usage:实质性使用 / Substantial
  • 使用工具及模型 / Tools and models:Claude Code(Claude Fable 5.2;前期排查使用 Claude Opus 5.5)
  • 使用目的 / Purpose:分析 issue 视频、复现问题、定位原因、编写修复、编译测试、撰写提交信息与 PR 描述
  • 涉及范围 / Scope:PCL.Launcher/UI/Controls/Inputs/MyComboBoxItem.cs
  • 人工审查与验证 / Human review and verification:本人核对了修复原理与修复前后的对比截图

提交前检查 / Checklist

  • 我已阅读并遵守 技术规范 和 生成式人工智能使用方针。/ I have read and followed the Technical Guidelines and the Generative Artificial Intelligence Usage Policy.
  • 我能解释本次修改的全部内容,包括关键逻辑、异常处理和已知限制。/ I can explain all changes, including key logic, error handling, and known limitations.
  • 我确认未伪造日志、测试结果、基准数据或其他证据。/ I confirm that no logs, test results, benchmarks, or other evidence have been fabricated.
  • 本次提交不包含与修改无关的文件变更,也未提交临时文件或构建产物。/ The PR contains no unrelated changes, temporary files, or build artifacts.
  • 所有提交均已签名,且提交信息符合提交信息规范。/ All commits are signed and follow the commit message convention.
  • 我确认 PR 描述由本人撰写,未直接提交未经核实的 AI 生成内容。/ I confirm that I wrote this PR description myself and have not submitted unverified AI-generated content.

此PR由claude编写,本人已阅读并确认。

选项背景淡出的目标色为透明黑 (0,0,0,0),从悬停色过渡时颜色分量
一并趋向黑色,中途呈现半透明深灰;淡入同理。此外过渡使用相对值
动画,每帧读回取整后的颜色再累加增量,舍入误差逐帧累积,结束时
无法精确回到目标值,留下一层淡色。

透明端改为保留颜色、仅透明度为 0,并改用绝对值的
NColorFromToAnimation,每帧直接写入插值结果。

Closes PCL-Community#38
@Chiloven945
Chiloven945 merged commit 3150eb7 into PCL-Community:dev Nov 16, 2026
4 of 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.

[C#]: 下拉框选项悬停效果滞后/残留

2 participants