fix: Fixed display issues when switching taskbar positions #1400
+96
−35
Conversation
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
Reviewer's GuideRefines the dock’s position-change handling by decoupling menu actions from animation callbacks and introducing a robust, state-driven animation flow that hides the dock at the old position, switches logical position, and then shows it at the new position without visual glitches. Sequence diagram for dock position change animation flowsequenceDiagram
actor User
participant MenuItem
participant Applet
participant Panel
participant positionChangeConnections
participant dockAnimation
participant dock
participant hideShowAnimation
User->>MenuItem: select new position value
MenuItem->>Applet: set position value
Applet->>Panel: update position
Panel-->>positionChangeConnections: onPositionChanged
activate positionChangeConnections
positionChangeConnections->>positionChangeConnections: check isRestoringPosition
alt isRestoringPosition true
positionChangeConnections-->>positionChangeConnections: return (ignore change)
else isRestoringPosition false
positionChangeConnections->>positionChangeConnections: savedNewPosition = Panel.position
positionChangeConnections->>positionChangeConnections: isRestoringPosition = true
positionChangeConnections->>Applet: position = previousPosition
positionChangeConnections->>positionChangeConnections: isRestoringPosition = false
positionChangeConnections->>dockAnimation: stop
positionChangeConnections->>hideShowAnimation: stop
positionChangeConnections->>dockAnimation: isPositionChanging = true
positionChangeConnections->>Panel: read hideState
positionChangeConnections->>dock: read visible
alt Panel.hideState is Hide and dock not visible
positionChangeConnections->>dockAnimation: isPositionChanging = false
positionChangeConnections->>positionChangeConnections: handlePositionChangeAfterHide
else dock is visible
positionChangeConnections->>dockAnimation: startAnimation(false)
end
end
deactivate positionChangeConnections
rect rgb(230,230,255)
dockAnimation-->>dockAnimation: onStopped
alt isPositionChanging true and isShowing false
dockAnimation->>dockAnimation: isPositionChanging = false
dockAnimation->>positionChangeConnections: handlePositionChangeAfterHide
else isShowing true
dockAnimation->>Panel: read hideState
alt Panel.hideState is Hide
dockAnimation->>hideTimer: start
end
end
end
rect rgb(230,255,230)
positionChangeConnections->>positionChangeConnections: handlePositionChangeAfterHide
positionChangeConnections->>positionChangeConnections: update previousPosition
positionChangeConnections->>Applet: position = savedNewPosition
positionChangeConnections->>positionChangeConnections: savedNewPosition = -1
positionChangeConnections->>Panel: changeDragAreaAnchor
positionChangeConnections->>Panel: requestClosePopup
positionChangeConnections->>dockAnimation: configure dockTransform for hidden offset
positionChangeConnections->>dockAnimation: startAnimation(true)
end
Updated class diagram for dockAnimation and positionChangeConnectionsclassDiagram
class DockAnimation {
bool useTransformBasedAnimation
bool isShowing
bool isPositionChanging
var target
string animProperty
startAnimation(show)
stop()
onStopped()
}
class PositionChangeConnections {
int previousPosition
int savedNewPosition
bool isRestoringPosition
onPositionChanged()
handlePositionChangeAfterHide()
onDockSizeChanged()
onCompleted()
}
class Dock {
bool visible
bool useColumnLayout
int width
int height
}
class DockTransform {
int x
int y
}
class Panel {
int position
int dockSize
int hideState
requestClosePopup()
changeDragAreaAnchor()
}
class Applet {
int position
}
DockAnimation --> Dock : animates
DockAnimation --> DockTransform : uses
PositionChangeConnections --> DockAnimation : controls
PositionChangeConnections --> Panel : updates
PositionChangeConnections --> Applet : restores_and_applies_position
PositionChangeConnections --> DockTransform : sets_hidden_offset
Panel --> Dock : configures_size
Flow diagram for dock position change and animation statesflowchart TD
A[User changes dock position via menu] --> B[Panel.position changes]
B --> C[onPositionChanged in positionChangeConnections]
C --> D{isRestoringPosition}
D -->|true| E[Return, ignore change]
D -->|false| F[Save savedNewPosition from Panel.position]
F --> G[Set isRestoringPosition = true]
G --> H[Restore Applet.position to previousPosition]
H --> I[Set isRestoringPosition = false]
I --> J[Stop dockAnimation and hideShowAnimation]
J --> K[Set dockAnimation.isPositionChanging = true]
K --> L{Panel.hideState is Hide and dock not visible}
L -->|true| M[Set dockAnimation.isPositionChanging = false]
M --> N[handlePositionChangeAfterHide]
L -->|false| O["startAnimation(false) for hide"]
O --> P[dockAnimation onStopped]
P --> Q{isPositionChanging and not isShowing}
Q -->|true| R[Set isPositionChanging = false]
R --> N
Q -->|false| S{isShowing and Panel.hideState is Hide}
S -->|true| T[start hideTimer]
S -->|false| U[End]
N --> V{savedNewPosition is valid}
V -->|false| U
V -->|true| W[Set previousPosition = savedNewPosition]
W --> X[Apply Applet.position = savedNewPosition]
X --> Y[Reset savedNewPosition = -1]
Y --> Z[changeDragAreaAnchor and requestClosePopup]
Z --> AA[Set dockTransform to hidden offset based on position]
AA --> AB["startAnimation(true) for show"]
AB --> AC[dockAnimation onStopped with isShowing true]
AC --> AD{Panel.hideState is Hide}
AD -->|true| T
AD -->|false| U
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 left some high level feedback:
- The
dockAnimation.isPositionChangingflag is only reset inonStoppedand the early-return path for hidden docks; if the animation is interrupted (e.g., by another position change or a manualstop()), this flag may remain true and affect later animations—consider centralizing state reset so all code paths that stop animations clear this flag consistently. - In the
Connectionshandler foronPositionChanged, theisRestoringPositionflag is set and immediately cleared after assigningApplet.position; this relies on synchronous behavior of the signal emission—if this logic ever changes or other async work is added, it may become brittle, so consider scoping the restore logic into a helper that manages the flag with a clearer critical section.
Prompt for AI Agents
Please address the comments from this code review:
## Overall Comments
- The `dockAnimation.isPositionChanging` flag is only reset in `onStopped` and the early-return path for hidden docks; if the animation is interrupted (e.g., by another position change or a manual `stop()`), this flag may remain true and affect later animations—consider centralizing state reset so all code paths that stop animations clear this flag consistently.
- In the `Connections` handler for `onPositionChanged`, the `isRestoringPosition` flag is set and immediately cleared after assigning `Applet.position`; this relies on synchronous behavior of the signal emission—if this logic ever changes or other async work is added, it may become brittle, so consider scoping the restore logic into a helper that manages the flag with a clearer critical section.Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.
Ivy233
force-pushed
the
fix-dock-position-transform
branch
from
9b5c6fe to
fffc65c
Compare
Ivy233
changed the title
Ivy233
force-pushed
the
fix-dock-position-transform
branch
from
fffc65c to
72c38ac
Compare
|
TAG Bot New tag: 2.0.27 |
Ivy233
force-pushed
the
fix-dock-position-transform
branch
from
72c38ac to
b19836d
Compare
18202781743
reviewed
Jan 26, 2026
panels/dock/package/main.qml
Outdated
| onTriggered: { | ||
| if (Applet[prop] === value) { | ||
| // Manually restore checked state since Qt already toggled it | ||
| checked = true; |
Contributor
There was a problem hiding this comment.
这个checked被手动赋值后，是不是解绑了，之前的绑定不起作用了，
checked = Qt.binding(function() {
return Applet[prop] === value;
});
Ivy233
force-pushed
the
fix-dock-position-transform
branch
2 times, most recently
from
6c7fc28 to
cc0e4cd
Compare
18202781743
reviewed
Jan 27, 2026
panels/dock/package/main.qml
Outdated
| } | ||
| } | ||
|
|
||
| Timer { |
Contributor
There was a problem hiding this comment.
这个定时器能否去掉，如果真需要，dde-shell有个DS.singleshot定时执行一次的接口，
c++里数据被调用了setPosition之后，不应该依赖界面来驱动这个流程，不管有没有动画，它都应该执行下去，我们能不能将隐藏显示的动画，补充到另一个流程里，而不是直接嵌入到setPosition，影响这个流程，
如果真需要beforePosition这个值，可以在panel里加一个，类似张坤提的禁用动画的pr，
Ivy233
force-pushed
the
fix-dock-position-transform
branch
from
cc0e4cd to
808d0fd
Compare
18202781743
reviewed
Jan 28, 2026
panels/dock/docksettings.h
Outdated
| Q_SIGNALS: | ||
| void dockSizeChanged(uint size); | ||
| void hideModeChanged(HideMode mode); | ||
| void beforePositionChanged(Position oldPosition, Position newPosition); |
18202781743
reviewed
Jan 28, 2026
Ivy233
force-pushed
the
fix-dock-position-transform
branch
2 times, most recently
from
e876c06 to
6123dbc
Compare
18202781743
reviewed
Jan 29, 2026
Ivy233
force-pushed
the
fix-dock-position-transform
branch
from
6123dbc to
7f5936d
Compare
1. Lift positionForAnimation from dockAnimation to dock Window level - Move property from SequentialAnimation to Window scope - Update all references from dockAnimation.positionForAnimation to dock.positionForAnimation - Improve code organization and semantic clarity 2. Remove m_beforePosition member variable and beforePosition() getter - Directly emit beforePositionChanged(SETTINGS->position()) in setPosition() - Eliminate unnecessary intermediate storage - Simplify code and reduce memory footprint 3. Position change flow improvements - C++ directly commits position changes via SETTINGS->setPosition() - Animation logic triggered by beforePositionChanged signal - No dependency on QML animation callbacks 修复：重构任务栏位置管理并与动画流程解耦 1. 将 positionForAnimation 从 dockAnimation 提升到 dock Window 级别 - 将属性从 SequentialAnimation 移至 Window 作用域 - 更新所有引用从 dockAnimation.positionForAnimation 改为 dock.positionForAnimation - 改善代码组织和语义清晰度 2. 移除 m_beforePosition 成员变量和 beforePosition() getter 函数 - 在 setPosition() 中直接发送 beforePositionChanged(SETTINGS->position()) - 消除不必要的中间存储 - 简化代码并减少内存占用 3. 位置变更流程改进 - C++ 直接通过 SETTINGS->setPosition() 提交位置变更 - 动画逻辑由 beforePositionChanged 信号触发 - 不依赖 QML 动画回调 PMS: BUG-346777
Ivy233
force-pushed
the
fix-dock-position-transform
branch
from
7f5936d to
f921a24
Compare
18202781743
approved these changes
Jan 29, 2026
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: 18202781743, Ivy233 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 |
deepin pr auto review这段代码主要是对 Dock（任务栏）位置切换时的动画逻辑进行了重构。通过引入 以下是对这段代码的详细审查意见，分为语法逻辑、代码质量、代码性能和代码安全四个方面： 1. 语法逻辑优点：
潜在问题与建议：
2. 代码质量优点：
改进建议：
3. 代码性能优点：
潜在问题与建议：
4. 代码安全优点：
改进建议：
总结这是一次高质量的代码重构。主要改进点在于：
最终建议： |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
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.
通过改进位置切换逻辑，实现平滑的过渡动画：
这样可以确保任务栏在位置切换时不会出现空白区域、内容溢出或突然跳变的问题。
Log: 修复任务栏位置切换时的显示异常
PMS: BUG-346777
Summary by Sourcery
Improve dock position change handling to provide smooth hide/show transitions and avoid visual glitches when moving the taskbar.
Bug Fixes:
Enhancements: