sync: from linuxdeepin/dtkdeclarative

[deepin-ci-robot]

Synchronize source files from linuxdeepin/dtkdeclarative.

Source-pull-request: linuxdeepin/dtkdeclarative#526

Summary by Sourcery

Improve ArrowListView by showing navigation arrows only when scrolling is possible and the view is interactive.

Bug Fixes:

• Hide the top arrow button when the list is at its beginning
• Hide the bottom arrow button when the list is at its end

[deepin-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: deepin-ci-robot

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

Details

Needs approval from an approver in each of these files:

• debian/deepin/OWNERS

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

[deepin-ci-robot]

deepin pr auto review

我对这段代码审查如下：

1. 语法逻辑：

• 代码语法正确，符合QML语法规范
• 修改是合理的，增加了对滚动位置的判断条件

2. 代码质量：

• 改进提高了用户体验，只有在列表可交互且不在边界时才显示箭头按钮
• 代码结构清晰，布局合理
• 使用了有意义的命名，如atYBeginning和atYEnd

3. 代码性能：

• 性能影响微乎其微，只是增加了简单的布尔判断
• 这些属性(atYBeginning和atYEnd)是ListView的标准属性，访问效率高

4. 代码安全：

• 代码安全，没有明显安全隐患
• 使用了Qt提供的标准属性，不会导致越界等问题

改进建议：

1. 可以考虑添加注释，说明这两个箭头按钮的显示逻辑，提高代码可读性：

// 仅在列表可交互且不在顶部时显示向上箭头
visible: itemsView.interactive && !itemsView.atYBeginning
// 仅在列表可交互且不在底部时显示向下箭头
visible: itemsView.interactive && !itemsView.atYEnd

2. 如果这是一个可复用的组件，可以考虑将这些显示条件抽取为可配置的属性，以便更灵活地控制按钮的显示逻辑。

3. 可以考虑为按钮添加过渡动画，使显示/隐藏更加平滑，提升用户体验。

4. 建议添加文档注释，说明该组件的用途和使用方法，特别是关于箭头按钮显示逻辑的部分。

总体而言，这是一个合理的改进，通过增加简单的条件判断，优化了用户界面的交互逻辑，使其更加符合用户预期。

[sourcery-ai]

Hey there - I've reviewed your changes and they look great!

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

[sourcery-ai]

Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

This PR synchronizes ArrowListView.qml from the linuxdeepin repository and refines arrow button visibility by adding boundary checks, so the up arrow hides at the top and the down arrow at the bottom.

File-Level Changes

Change	Details	Files
Refine ArrowListViewButton visibility to include boundary conditions	Added !itemsView.atYBeginning to the top arrow’s visible condition Added !itemsView.atYEnd to the bottom arrow’s visible condition	qt6/src/qml/ArrowListView.qml

---

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

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.