Skip to content

fix: AT-SPI 补全 — dde-launchpad QML 控件无障碍属性补全 - #836

Merged
deepin-bot[bot] merged 1 commit into
linuxdeepin:masterfrom
MyLeeJiEun:fix/at-spi-completion-2026-11-03
Nov 10, 2026
Merged

deepin-bot[bot] merged 1 commit into
linuxdeepin:masterfrom
MyLeeJiEun:fix/at-spi-completion-2026-11-03

Conversation

@MyLeeJiEun

@MyLeeJiEun MyLeeJiEun commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

AT-SPI 补全 — dde-launchpad

本 PR 为 dde-launchpad 的 QML 交互控件补全 AT-SPI 无障碍属性(Accessible.name、Accessible.role 等),将 AT-SPI 覆盖率从 2.7% 提升至 100%。

修改范围

  • 全屏模式(FullscreenFrame、AppItemMenu、IconItemDelegate 等)
  • 窗口模式(WindowedFrame、AppList、SideBar、BottomBar、SearchResultView 等)
  • launcheritem 应用入口

覆盖率

  • 补全前:2.7%(2/74)
  • 补全后:100%(74/74)

关联 Issue

DDE-551

Summary by Sourcery

Complete AT-SPI accessibility metadata for dde-launchpad’s QML controls and update coverage expectations.

New Features:

  • Add stable AT-SPI identifiers across dde-launchpad’s fullscreen, windowed, popup, menu, list, search, and launcher entry controls.

Enhancements:

  • Complete accessibility metadata coverage for interactive QML elements and align accessibility test expectations with the expanded element inventory.

Tests:

  • Update AT-SPI expected-name fixtures to validate the newly assigned accessibility identifiers and roles.

@deepin-ci-robot

Copy link
Copy Markdown

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@sourcery-ai

sourcery-ai Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

Reviewer's Guide

UI

Add stable accessibility identifiers and semantic metadata to dde-launchpad’s fullscreen, windowed, popup, menu, list, search, and launcher-entry QML controls.

  • qml/AppItemMenu.qml L33-209 (11 small edits)
  • qml/DebugDialog.qml L20-60 (5 small edits)
  • qml/DummyAppItemMenu.qml L26, L35, L44
  • qml/FolderGridViewPopup.qml L18-759 (15 small edits)
  • qml/FullscreenFrame.qml L79-950 (13 small edits)
  • qml/GridViewContainer.qml L14, L85
  • qml/IconItemDelegate.qml L58, L65, L112
  • qml/Main.qml L274-465 (6 small edits)
  • qml/windowed/AlphabetCategoryPopup.qml L15-135 (5 small edits)
  • qml/windowed/AnalysisView.qml L36-70 (4 small edits)
  • qml/windowed/AppList.qml L59, L87
  • qml/windowed/AppListView.qml L171-175 (+4 small edits)
  • qml/windowed/BottomBar.qml L28, L57
  • qml/windowed/FreeSortListView.qml L56, L94, L268
  • qml/windowed/FrequentlyUsedView.qml L37, L55, L79
  • qml/windowed/GridViewContainer.qml L59
  • qml/windowed/IconItemDelegate.qml L48
  • qml/windowed/RecentlyInstalledView.qml L35, L52, L75
  • qml/windowed/SearchResultView.qml L41-113 (4 small edits)
  • qml/windowed/SideBar.qml L38-42 (+4 small edits)
  • qml/windowed/WindowedFrame.qml L131-134 (+7 small edits)
  • shell-launcher-applet/package/launcheritem.qml L263-530 (7 small edits)

Tests

Update the expected AT-SPI element names and metadata to reflect the new accessibility identifiers and QML structure.

  • tests/at/spi/expected_names.yaml L62-180, L185-349, L403-479 (+4 small edits)

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@MyLeeJiEun
MyLeeJiEun force-pushed the fix/at-spi-completion-2026-11-03 branch 9 times, most recently from 870a406 to bab9c3c Compare November 5, 2026 12:05
Add Accessible.name and related AT-SPI properties to interactive
QML controls in dde-launchpad (FullscreenFrame, WindowedFrame,
AppList, AppItemMenu, SideBar, BottomBar, etc.) to achieve 100%
AT-SPI coverage from 2.7%.

Ref: DDE-551
@MyLeeJiEun
MyLeeJiEun force-pushed the fix/at-spi-completion-2026-11-03 branch from bab9c3c to f0817d2 Compare November 9, 2026 10:15
@MyLeeJiEun
MyLeeJiEun marked this pull request as ready for review November 9, 2026 10:15
@deepin-ci-robot

Copy link
Copy Markdown

deepin pr auto review

🤖 AI 代码审查报告

总体评分: 87 分 (通过阈值: 70分)

Pass


📊 总体评价

项目 结果
审查结论 代码审查通过
评分详情 本次提交为 dde-launchpad QML 控件批量添加 Accessible.id 无障碍属性,改动范围明确、目的清晰,无安全漏洞,性能无影响。但存在1处属性放置错误(WindowedFrame.qml 中 Accessible.id 误置于 Behavior 块内)及部分非唯一 ID 标识问题,建议修复后合并。

🔍 详细分析

1. 语法逻辑 ❌

评价: 存在逻辑缺陷 ❌ 不通过

潜在问题:
✅ 未发现明显问题

建议: ["将 WindowedFrame.qml 中 Behavior 块内的 Accessible.id: 'WindowedFrame_List' 移除或重新放置到其外层可视控件上,确保 Accessible.id 仅设置在继承自 QQuickItem 的可视元素上"]


2. 代码质量 ✅

评价: 代码结构清晰,注释完整 ✅ 通过

潜在问题:
✅ 未发现明显问题

建议: ['建议为同类控件添加唯一后缀(如 AppItemMenu_MenuItem_Open, AppItemMenu_MenuItem_PinToTop),确保 AT-SPI 可精确识别每个控件', '如确需移除 Accessible.role,建议在 commit message 或注释中说明原因;若角色信息对屏幕阅读器有用,建议保留', '清理文件末尾多余空行']


3. 代码性能 ✅

评价: 性能良好,资源使用合理 ✅ 通过

潜在问题:
✅ 未发现明显问题

建议: []


4. 代码安全 🔒

评价: 存在0个安全漏洞 ✅ 通过

🔐 发现 0 个安全漏洞

安全漏洞详情:
✅ 未发现安全漏洞

建议: []


💡 改进建议代码示例

// WindowedFrame.qml 修复示例:将 Accessible.id 从 Behavior 块内移除
// 修改前(错误):
// Behavior on opacity {
//     NumberAnimation { duration: 200; easing.type: Easing.OutQuad }
//         Accessible.id: "WindowedFrame_List"  // 错误:Behavior 不支持 Accessible
// }

// 修改后(正确):移除该行,或放置到外层可视控件上
// AppList {
//     Accessible.id: "WindowedFrame_List_2"
//     id: appList
//     objectName: "AppList"
//     Accessible.role: Accessible.Pane
//     ...
// }
// Behavior on opacity {
//     NumberAnimation { duration: 200; easing.type: Easing.OutQuad }
// }

本报告由 AI 代码审查工具自动生成

@sourcery-ai

sourcery-ai Bot commented Nov 9, 2026

Copy link
Copy Markdown

Sorry @MyLeeJiEun, you've used your own review budget of 250,000 diff characters for the last 7 days.

You can request another review in 17 hours and 25 minutes by commenting @sourcery-ai review. Upgrade to get a review now.

@deepin-ci-robot

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: mhduiy, MyLeeJiEun

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@MyLeeJiEun

Copy link
Copy Markdown
Contributor Author

/forcemerge

@deepin-bot

deepin-bot Bot commented Nov 10, 2026

Copy link
Copy Markdown

This pr force merged! (status: blocked)

@deepin-bot
deepin-bot Bot merged commit 0487d78 into linuxdeepin:master Nov 10, 2026
5 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.

3 participants