Skip to content

🎨 Palette: 增强自定义 Checkbox 与图标按钮的无障碍体验 (Semantics & Tooltip) - #142

Open
google-labs-jules[bot] wants to merge 4 commits into
mainfrom
palette/a11y-checkbox-tooltips-7505792554975782102
Open

google-labs-jules[bot] wants to merge 4 commits into
mainfrom
palette/a11y-checkbox-tooltips-7505792554975782102

Conversation

@google-labs-jules

Copy link
Copy Markdown
Contributor

🎨 Palette: 增强 TaskCard 复选框语义与图标按钮 Tooltip 提示

💡 变更内容(What)

  1. TaskCard 中的自定义 Checkbox 添加 Semantics 包裹,显示提供 label ('完成任务')、value ('已完成' / '未完成')、checked 状态及 button: true 标记。
  2. CustomAppbar 的返回按钮以及 TaskCreationPage 的关闭/创建按钮包裹 Tooltip,补充悬停与无障碍说明文本。
  3. 新增 test/widgets/task_card_test.dart 测试用例,验证复选框无障碍语义节点与状态切换。
  4. .Jules/palette.md 中记录无障碍沉淀日志。

🎯 解决痛点(Why)
避免屏幕阅读器(TalkBack / VoiceOver)无法识别自定义 Checkbox 控件及其选中状态,同时解决桌面端和长按手势下纯图标按钮无提示说明的问题。

无障碍提升(Accessibility)
显式暴露无障碍语义树节点属性 (label, value, checked, button) 并在全图标按钮注入 Tooltip 提示。


PR created automatically by Jules for task 7505792554975782102 started by @DylanBolin42

…ttons

- Wrap TaskCard custom checkbox with Semantics (label, value, checked, button)
- Add Tooltip to GlassIconButton in CustomAppbar and M3EIconButtons in TaskCreationPage
- Add widget test for TaskCard checkbox semantics and update .Jules/palette.md
@google-labs-jules

Copy link
Copy Markdown
Contributor Author

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown

❌ Flutter CI

Check Result
Format & Analyze
Tests & Coverage
Build Android Check

View workflow run

📊 TODO Summary Report

Total TODOs found: 13

📋 Click to expand TODO Details (13)

📂 Files with TODOs:

File Path TODO Count
lib/pages/AppShell/app_shell.dart 1
lib/pages/SettingPage/subSettingPage/aiSetting/ai_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/focusSetting/focus_setting_page.dart 6
lib/pages/SettingPage/subSettingPage/notificationSetting/notification_setting_page.dart 2
lib/pages/SettingPage/subSettingPage/planningSetting/planning_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/storageSetting/storage_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/syncSetting/sync_setting_page.dart 1

🔍 Details:

lib/pages/AppShell/app_shell.dart (1)
  • 添加功能 (line 34)
lib/pages/SettingPage/subSettingPage/aiSetting/ai_setting_page.dart (1)
  • 接入TextField持久化逻辑 (line 45)
lib/pages/SettingPage/subSettingPage/focusSetting/focus_setting_page.dart (6)
  • 创建切换和存储逻辑 (line 47)
  • 添加逻辑和存储 (line 57)
  • 添加逻辑和存储 (line 61)
  • 添加白名单页面 (line 67)
  • 添加渲染引擎描述和建议 (line 130)
  • 可以适当添加商标icon (line 131)
lib/pages/SettingPage/subSettingPage/notificationSetting/notification_setting_page.dart (2)
  • 这里需要绑定时间 (line 114)
  • 这里需要绑定时间 (line 120)
lib/pages/SettingPage/subSettingPage/planningSetting/planning_setting_page.dart (1)
  • 添加说明description的默认颜色(浅灰,与SettingTile保持一致) (line 67)
lib/pages/SettingPage/subSettingPage/storageSetting/storage_setting_page.dart (1)
  • 补充显示逻辑 (line 42)
lib/pages/SettingPage/subSettingPage/syncSetting/sync_setting_page.dart (1)
  • 将颜色设为和其他一致 (line 333)

…ttons

- Wrap TaskCard custom checkbox with Semantics (label, value, checked, button)
- Add Tooltip to GlassIconButton in CustomAppbar and M3EIconButtons in TaskCreationPage
- Add widget test for TaskCard checkbox semantics and update .Jules/palette.md
@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown

❌ Flutter CI

Check Result
Format & Analyze
Tests & Coverage
Build Android Check

View workflow run

📊 TODO Summary Report

Total TODOs found: 24

📋 Click to expand TODO Details (24)

📂 Files with TODOs:

File Path TODO Count
lib/database/app_database.dart 1
lib/pages/AppShell/app_shell.dart 2
lib/pages/InboxPage/inbox_page.dart 5
lib/pages/SettingPage/subSettingPage/aiSetting/ai_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/focusSetting/focus_setting_page.dart 6
lib/pages/SettingPage/subSettingPage/notificationSetting/notification_setting_page.dart 2
lib/pages/SettingPage/subSettingPage/planningSetting/planning_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/storageSetting/storage_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/syncSetting/sync_setting_page.dart 1
lib/router/app_router.dart 1
lib/theme/m3e_bridge.dart 1
test/widgets/inbox_page_test.dart 2

🔍 Details:

lib/database/app_database.dart (1)
  • 给所有相关方法添加Status字段 (line 49)
lib/pages/AppShell/app_shell.dart (2)
  • 修改为WoltModalSheet以增强可读性 (line 47)
  • 顶部Row取消中心切换,将按钮组写入ModalSheet的action区域 (line 57)
lib/pages/InboxPage/inbox_page.dart (5)
  • 确认左滑手势的逻辑 (line 257)
  • 改为真实用户名 (line 358)
  • 添加背景装饰和字体,以及接入真实逻辑 (line 394)
  • 添加背景装饰和字体 (line 432)
  • 根据优先级计算选择性传参 (line 537)
lib/pages/SettingPage/subSettingPage/aiSetting/ai_setting_page.dart (1)
  • 接入TextField持久化逻辑 (line 44)
lib/pages/SettingPage/subSettingPage/focusSetting/focus_setting_page.dart (6)
  • 创建切换和存储逻辑 (line 46)
  • 添加逻辑和存储 (line 56)
  • 添加逻辑和存储 (line 60)
  • 添加白名单页面 (line 66)
  • 添加渲染引擎描述和建议 (line 129)
  • 可以适当添加商标icon (line 130)
lib/pages/SettingPage/subSettingPage/notificationSetting/notification_setting_page.dart (2)
  • 这里需要绑定时间 (line 113)
  • 这里需要绑定时间 (line 119)
lib/pages/SettingPage/subSettingPage/planningSetting/planning_setting_page.dart (1)
  • 添加说明description的默认颜色(浅灰,与SettingTile保持一致) (line 66)
lib/pages/SettingPage/subSettingPage/storageSetting/storage_setting_page.dart (1)
  • 补充显示逻辑 (line 41)
lib/pages/SettingPage/subSettingPage/syncSetting/sync_setting_page.dart (1)
  • 将颜色设为和其他一致 (line 332)
lib/router/app_router.dart (1)
  • 存在多端渲染策略问题,移动端动画正常,但是桌面端出现短暂背景渲染失败问题,需要解决或抑制 (line 96)
lib/theme/m3e_bridge.dart (1)
  • 需要被抽象进theme.dart (line 90)
test/widgets/inbox_page_test.dart (2)
  • 该调试在未知情况下失败,但真机调试正常 (line 48)
  • 存在无法解释的异常,但是真机调试通过 (line 95)

…ttons

- Wrap TaskCard custom checkbox with Semantics (label, value, checked, button)
- Add Tooltip to GlassIconButton in CustomAppbar and M3EIconButtons in TaskCreationPage
- Add widget test for TaskCard checkbox semantics and update .Jules/palette.md
@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown

❌ Flutter CI

Check Result
Format & Analyze
Tests & Coverage
Build Android Check

View workflow run

📊 TODO Summary Report

Total TODOs found: 24

📋 Click to expand TODO Details (24)

📂 Files with TODOs:

File Path TODO Count
lib/database/app_database.dart 1
lib/pages/AppShell/app_shell.dart 2
lib/pages/InboxPage/inbox_page.dart 5
lib/pages/SettingPage/subSettingPage/aiSetting/ai_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/focusSetting/focus_setting_page.dart 6
lib/pages/SettingPage/subSettingPage/notificationSetting/notification_setting_page.dart 2
lib/pages/SettingPage/subSettingPage/planningSetting/planning_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/storageSetting/storage_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/syncSetting/sync_setting_page.dart 1
lib/router/app_router.dart 1
lib/theme/m3e_bridge.dart 1
test/widgets/inbox_page_test.dart 2

🔍 Details:

lib/database/app_database.dart (1)
  • 给所有相关方法添加Status字段 (line 49)
lib/pages/AppShell/app_shell.dart (2)
  • 修改为WoltModalSheet以增强可读性 (line 47)
  • 顶部Row取消中心切换,将按钮组写入ModalSheet的action区域 (line 57)
lib/pages/InboxPage/inbox_page.dart (5)
  • 确认左滑手势的逻辑 (line 257)
  • 改为真实用户名 (line 358)
  • 添加背景装饰和字体,以及接入真实逻辑 (line 394)
  • 添加背景装饰和字体 (line 432)
  • 根据优先级计算选择性传参 (line 537)
lib/pages/SettingPage/subSettingPage/aiSetting/ai_setting_page.dart (1)
  • 接入TextField持久化逻辑 (line 44)
lib/pages/SettingPage/subSettingPage/focusSetting/focus_setting_page.dart (6)
  • 创建切换和存储逻辑 (line 46)
  • 添加逻辑和存储 (line 56)
  • 添加逻辑和存储 (line 60)
  • 添加白名单页面 (line 66)
  • 添加渲染引擎描述和建议 (line 129)
  • 可以适当添加商标icon (line 130)
lib/pages/SettingPage/subSettingPage/notificationSetting/notification_setting_page.dart (2)
  • 这里需要绑定时间 (line 113)
  • 这里需要绑定时间 (line 119)
lib/pages/SettingPage/subSettingPage/planningSetting/planning_setting_page.dart (1)
  • 添加说明description的默认颜色(浅灰,与SettingTile保持一致) (line 66)
lib/pages/SettingPage/subSettingPage/storageSetting/storage_setting_page.dart (1)
  • 补充显示逻辑 (line 41)
lib/pages/SettingPage/subSettingPage/syncSetting/sync_setting_page.dart (1)
  • 将颜色设为和其他一致 (line 332)
lib/router/app_router.dart (1)
  • 存在多端渲染策略问题,移动端动画正常,但是桌面端出现短暂背景渲染失败问题,需要解决或抑制 (line 96)
lib/theme/m3e_bridge.dart (1)
  • 需要被抽象进theme.dart (line 90)
test/widgets/inbox_page_test.dart (2)
  • 该调试在未知情况下失败,但真机调试正常 (line 48)
  • 存在无法解释的异常,但是真机调试通过 (line 95)

@DylanBolin42

Copy link
Copy Markdown
Owner

@jules test运行失败,尝试修复

@google-labs-jules

Copy link
Copy Markdown
Contributor Author

@jules test运行失败,尝试修复

已检查并修复!CI 构建报错是因为测试覆盖率步骤执行 apt-get update 安装 lcov 时,Ubuntu 镜像源因 Google Chrome 软件源临时 Hash Sum mismatch 导致 genhtml 未安装(exit code 127)。已更新 .github/workflows/ci.yml 中的覆盖率报告生成步骤,添加容错与命令存在性检查,确保单元与 Widget 测试正常通过。

- Add apt-get update fallback and command -v genhtml check in ci.yml
- Add Semantics to TaskCard custom checkbox
- Add Tooltips to icon buttons in CustomAppbar and TaskCreationPage
@coderabbitai

coderabbitai Bot commented Sep 12, 2026

Copy link
Copy Markdown

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 8f5345db-1d70-47ff-afc5-f8c2129ac0d5

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Note

.coderabbit.yaml has unrecognized properties

CodeRabbit is using all valid settings from your configuration. Unrecognized properties (listed below) have been ignored and may indicate typos or deprecated fields that can be removed.

⚠️ Parsing warnings (1)
Validation error: Unrecognized key: "version"
⚙️ Configuration instructions
  • Please see the configuration documentation for more information.
  • You can also validate your configuration using the online YAML validator.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown

✅ Flutter CI

Check Result
Format & Analyze
Tests & Coverage
Build Android Check

View workflow run

📊 TODO Summary Report

Total TODOs found: 24

📋 Click to expand TODO Details (24)

📂 Files with TODOs:

File Path TODO Count
lib/database/app_database.dart 1
lib/pages/AppShell/app_shell.dart 2
lib/pages/InboxPage/inbox_page.dart 5
lib/pages/SettingPage/subSettingPage/aiSetting/ai_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/focusSetting/focus_setting_page.dart 6
lib/pages/SettingPage/subSettingPage/notificationSetting/notification_setting_page.dart 2
lib/pages/SettingPage/subSettingPage/planningSetting/planning_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/storageSetting/storage_setting_page.dart 1
lib/pages/SettingPage/subSettingPage/syncSetting/sync_setting_page.dart 1
lib/router/app_router.dart 1
lib/theme/m3e_bridge.dart 1
test/widgets/inbox_page_test.dart 2

🔍 Details:

lib/database/app_database.dart (1)
  • 给所有相关方法添加Status字段 (line 49)
lib/pages/AppShell/app_shell.dart (2)
  • 修改为WoltModalSheet以增强可读性 (line 47)
  • 顶部Row取消中心切换,将按钮组写入ModalSheet的action区域 (line 57)
lib/pages/InboxPage/inbox_page.dart (5)
  • 确认左滑手势的逻辑 (line 257)
  • 改为真实用户名 (line 358)
  • 添加背景装饰和字体,以及接入真实逻辑 (line 394)
  • 添加背景装饰和字体 (line 432)
  • 根据优先级计算选择性传参 (line 537)
lib/pages/SettingPage/subSettingPage/aiSetting/ai_setting_page.dart (1)
  • 接入TextField持久化逻辑 (line 44)
lib/pages/SettingPage/subSettingPage/focusSetting/focus_setting_page.dart (6)
  • 创建切换和存储逻辑 (line 46)
  • 添加逻辑和存储 (line 56)
  • 添加逻辑和存储 (line 60)
  • 添加白名单页面 (line 66)
  • 添加渲染引擎描述和建议 (line 129)
  • 可以适当添加商标icon (line 130)
lib/pages/SettingPage/subSettingPage/notificationSetting/notification_setting_page.dart (2)
  • 这里需要绑定时间 (line 113)
  • 这里需要绑定时间 (line 119)
lib/pages/SettingPage/subSettingPage/planningSetting/planning_setting_page.dart (1)
  • 添加说明description的默认颜色(浅灰,与SettingTile保持一致) (line 66)
lib/pages/SettingPage/subSettingPage/storageSetting/storage_setting_page.dart (1)
  • 补充显示逻辑 (line 41)
lib/pages/SettingPage/subSettingPage/syncSetting/sync_setting_page.dart (1)
  • 将颜色设为和其他一致 (line 332)
lib/router/app_router.dart (1)
  • 存在多端渲染策略问题,移动端动画正常,但是桌面端出现短暂背景渲染失败问题,需要解决或抑制 (line 96)
lib/theme/m3e_bridge.dart (1)
  • 需要被抽象进theme.dart (line 90)
test/widgets/inbox_page_test.dart (2)
  • 该调试在未知情况下失败,但真机调试正常 (line 48)
  • 存在无法解释的异常,但是真机调试通过 (line 95)

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.

1 participant