feat: Add support for modifying the plugin popup cursor shape via the…#1434
Merged
deepin-bot[bot] merged 1 commit intolinuxdeepin:masterfrom Mar 3, 2026
Merged
Conversation
Reviewer's GuideAdds protocol and implementation support for plugin popups to request cursor shape changes, plumbing the request from the Wayland plugin manager extension through to the QML shell surface proxy and exposing it as a cursorShape property with bounds checking. Sequence diagram for plugin popup cursor shape update flowsequenceDiagram
actor PluginClient
participant WaylandPluginProtocol
participant PluginPopup
participant ShellSurfaceItemProxy_qml as ShellSurfaceItemProxy
participant HoverHandler_qml as HoverHandler
PluginClient->>WaylandPluginProtocol: plugin_popup_set_cursor(cursor_shape)
WaylandPluginProtocol->>PluginPopup: plugin_popup_set_cursor(resource, cursor_shape)
PluginPopup->>PluginPopup: plugin_popup_set_cursor(resource, cursor_shape)
PluginPopup-->>ShellSurfaceItemProxy_qml: cursorShapeRequested(cursor_shape)
ShellSurfaceItemProxy_qml->>ShellSurfaceItemProxy_qml: onCursorShapeRequested(cursor_shape)
ShellSurfaceItemProxy_qml->>ShellSurfaceItemProxy_qml: validate cursor_shape range 0-21,24,25
alt cursor_shape out of range
ShellSurfaceItemProxy_qml->>ShellSurfaceItemProxy_qml: root.cursorShape = Qt.ArrowCursor
else cursor_shape in range
ShellSurfaceItemProxy_qml->>ShellSurfaceItemProxy_qml: root.cursorShape = cursor_shape
end
ShellSurfaceItemProxy_qml->>HoverHandler_qml: cursorShape = root.cursorShape
Class diagram for PluginPopup and ShellSurfaceItemProxy cursor shape supportclassDiagram
class PluginPopup {
+plugin_popup_source_size(resource: Resource, width: int32_t, height: int32_t)
+plugin_popup_set_cursor(resource: Resource, cursor_shape: int32_t)
+plugin_popup_destroy_resource(resource: Resource)
+plugin_popup_destroy(resource: Resource)
+cursorShapeRequested(cursorShape: int)
-m_manager: PluginManager*
}
class ShellSurfaceItemProxy {
+inputEventsEnabled: bool
+hovered: bool
+pressed: bool
+cursorShape: int
+onCursorShapeRequested(cursorShape: int)
}
class HoverHandler_qml {
+hovered: bool
+cursorShape: int
}
ShellSurfaceItemProxy --> HoverHandler_qml: sets cursorShape
PluginPopup --> ShellSurfaceItemProxy: emits cursorShapeRequested
Flow diagram for cursorShape bounds checking in ShellSurfaceItemProxyflowchart TD
A[onCursorShapeRequested cursorShape param received] --> B[Check if cursorShape < 0 or cursorShape > 25]
B -->|yes| C[Set root.cursorShape to Qt.ArrowCursor]
B -->|no| D[Set root.cursorShape to cursorShape]
C --> E[HoverHandler.cursorShape uses root.cursorShape]
D --> E[HoverHandler.cursorShape uses root.cursorShape]
File-Level Changes
Tips and commandsInteracting with Sourcery
Customizing Your ExperienceAccess your dashboard to:
Getting Help
|
![sourcery-ai[bot]](https://avatars.githubusercontent.com/in/48477?s=60&v=4){kind=small}
There was a problem hiding this comment.
Hey - I've found 1 issue, and left some high level feedback:
- The
onCursorShapeRequestedhandler inShellSurfaceItemProxy.qmlis currently just a standalone function; unless it is explicitly connected to thePluginPopup::cursorShapeRequestedsignal elsewhere, this callback will never run—consider wiring the signal to this handler or using aConnectionsobject in the QML to make the linkage explicit. - The
console.log("onCursorShapeRequested:", cursorShape)in QML will spam logs on every cursor update; consider removing it or guarding it behind a runtime debug flag to avoid excessive logging in normal operation.
Prompt for AI Agents
Please address the comments from this code review:
## Overall Comments
- The `onCursorShapeRequested` handler in `ShellSurfaceItemProxy.qml` is currently just a standalone function; unless it is explicitly connected to the `PluginPopup::cursorShapeRequested` signal elsewhere, this callback will never run—consider wiring the signal to this handler or using a `Connections` object in the QML to make the linkage explicit.
- The `console.log("onCursorShapeRequested:", cursorShape)` in QML will spam logs on every cursor update; consider removing it or guarding it behind a runtime debug flag to avoid excessive logging in normal operation.
## Individual Comments
### Comment 1
<location> `panels/dock/tray/ShellSurfaceItemProxy.qml:117-122` </location>
<code_context>
})
}
+
+ function onCursorShapeRequested(cursorShape)
+ {
+ console.log("onCursorShapeRequested:", cursorShape)
+ // Qt::CursorShape range is 0-21, plus 24 (BitmapCursor) and 25 (CustomCursor).
+ // We set a default if the value is out of logical bounds.
+ if (cursorShape < 0 || cursorShape > 25) {
+ root.cursorShape = Qt.ArrowCursor
+ } else {
</code_context>
<issue_to_address>
**issue (bug_risk):** The cursorShape bounds check lets invalid enum values 22 and 23 through.
The check only filters values < 0 or > 25, so 22 and 23 are still accepted even though the comment marks them as invalid. If Wayland ever sends 22 or 23, this could cause undefined cursor behavior. Please tighten the condition to only accept 0–21, 24, and 25 (e.g. `if ((cursorShape >= 0 && cursorShape <= 21) || cursorShape == 24 || cursorShape == 25)`), or map any other value to a safe default.
</issue_to_address>Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.
Contributor
Author
|
linuxdeepin/dde-tray-loader#424 |
yixinshark
force-pushed
the
feat-addCursorShape
branch
from
a8691e7 to
1447b43
Compare
18202781743
approved these changes
Feb 5, 2026
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: 18202781743, yixinshark The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
|
TAG Bot New tag: 2.0.29 |
There was a problem hiding this comment.
Pull request overview
This PR adds support for plugin popups to request cursor shape changes via the Wayland protocol. The feature allows plugins to communicate their desired cursor shape to the compositor, which then updates the UI accordingly.
Changes:
- Added protocol support for cursor shape requests in plugin popups
- Implemented cursor shape handling in the QML UI layer with validation
- Updated dependency version to require protocol support in dde-tray-loader-dev
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| panels/dock/tray/ShellSurfaceItemProxy.qml | Added cursorShape property and signal handler to process cursor shape requests from plugins |
| panels/dock/pluginmanagerextension_p.h | Declared new protocol method and signal for cursor shape requests |
| panels/dock/pluginmanagerextension.cpp | Implemented plugin_popup_set_cursor to emit cursorShapeRequested signal |
| debian/control | Updated dde-tray-loader-dev dependency to require version > 2.0.24 for protocol support |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
TAG Bot New tag: 2.0.30 |
… protocol. add support in plugin-manager-v1.xml Log: Add support for modifying the plugin popup cursor shape via the protocol.
yixinshark
force-pushed
the
feat-addCursorShape
branch
from
1447b43 to
ec06e49
Compare
deepin pr auto review经过对提供的 git diff 的审查，以下是关于语法逻辑、代码质量、代码性能和代码安全的详细审查意见和改进建议： 1. 依赖版本修改 (
|
Contributor
Author
|
/forcemerge |
|
This pr force merged! (status: blocked) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
… protocol.
add support in plugin-manager-v1.xml
Log: Add support for modifying the plugin popup cursor shape via the protocol.
Summary by Sourcery
Add protocol and UI support for plugin popups to request and update the cursor shape.
New Features: