Files
Store.Management/.agents/rules/icon-usage.md
T
2026-10-27 19:01:56 +08:00

1022 B

图标使用规则

当前仓库没有独立 Resources 项目,也没有已建立的 IconNameEnum、IconGlyphEnum、IconHelper 或 FontGeometries.xaml 图标系统。

  • 添加前搜索实际 XAML、资源和已引用控件库,优先复用已有资源。
  • 新资源选择与页面一致且许可明确的图标,放所属项目并配置 WPF Build Action 和 pack URI。
  • 不虚构枚举、扩展、字体、资源键;不把其他项目路径简单改名后当作现有实现。
  • ImageSource 使用 Image,字体图标遵循字体实际契约;不对所有资源强制使用一种控件。
  • 菜单图标避免同一个 UIElement 被多个父节点复用,可共享 ImageSource 并创建独立元素。
  • Foreground 能否改色取决于资源类型,不承诺可重染位图或固定色 DrawingImage。
  • 图标按钮提供可访问名称和必要的 ToolTip,关键操作不只靠颜色或图标区分。
  • 建立统一图标方案后再记录真实位置与 API;不为规则迁移新增图标依赖。