PyQt/PySide动画问题：如何让可扩展子部件初始宽度为0

问题背景 #

我开发了一款占用屏幕空间极小的PyQt/PySide可拖动部件，点击（后续将支持hover）时需向左、向上扩展两个子部件，初始状态下这些子部件需不可见且宽度为0，不占用桌面空间。已实现低闪烁的动画效果，但无法将可扩展区域的初始宽度设为0，尝试以下方法均无效：

• 子类化QWidget并重写sizeHint：未缩小尺寸且破坏动画
• 调用子部件的.resize方法：无任何效果
• 重写主部件的showEvent方法手动修改geometry：无效果

推测子部件被限制为不能小于其内容尺寸，设置maximumWidth为0可实现0宽度，但会导致动画失效。示例代码中点击按钮1可向左扩展projectWidget，动画正常运行，但默认状态下该部件应不可见（宽度为0），扩展后需达到设定宽度或首选宽度。

解决方案 #

核心思路是初始时强制子部件宽度为0，同时在动画过程中动态调整maximumWidth，既保留初始不可见状态，又不影响动画过渡。

具体实现步骤 #

1. 初始化锁定宽度为0并记录目标尺寸
   直接将子部件的初始宽度设为0，同时保存其目标展开宽度（可使用sizeHint().width()或自定义固定值），避免用maximumWidth锁死导致动画失效。

2. 动画前后动态调整maximumWidth
   展开动画启动前，将子部件的maximumWidth设为目标宽度；收起动画结束后，再将maximumWidth设回0，防止布局约束强制恢复部件尺寸。

3. 使用QPropertyAnimation操作geometry属性
   直接对部件的geometry做动画，比单独修改宽度更稳定，能规避布局约束带来的尺寸限制问题。

代码示例 #

from PyQt5.QtWidgets import (QWidget, QPushButton, QHBoxLayout, 
                             QVBoxLayout, QApplication)
from PyQt5.QtCore import QPropertyAnimation, QRect, Qt

class ExpandableWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowFlags(Qt.FramelessWindowHint | Qt.WindowStaysOnTopHint)
        self.resize(50, 50)
        
        # 主布局：左侧可扩展部件，右侧触发按钮
        main_layout = QHBoxLayout(self)
        main_layout.setContentsMargins(0, 0, 0, 0)
        
        # 初始化可扩展子部件
        self.project_widget = QWidget()
        self.project_widget.setStyleSheet("background-color: #333;")
        # 初始宽度设为0，记录目标展开宽度
        self.target_width = self.project_widget.sizeHint().width() or 200
        self.project_widget.setFixedWidth(0)
        
        # 触发按钮
        self.btn = QPushButton("按钮1")
        self.btn.clicked.connect(self.toggle_expand)
        
        main_layout.addWidget(self.project_widget)
        main_layout.addWidget(self.btn)
        
        # 动画初始化
        self.animation = QPropertyAnimation(self.project_widget, b"geometry")
        self.animation.setDuration(300)
        self.is_expanded = False

    def toggle_expand(self):
        self.is_expanded = not self.is_expanded
        current_geo = self.project_widget.geometry()
        
        if self.is_expanded:
            # 展开：解锁最大宽度，动画到目标尺寸
            self.project_widget.setMaximumWidth(self.target_width)
            target_geo = QRect(
                self.x(), current_geo.y(), 
                self.target_width, current_geo.height()
            )
        else:
            # 收起：动画到宽度0，结束后锁定最大宽度为0
            target_geo = QRect(
                self.x(), current_geo.y(), 
                0, current_geo.height()
            )
            self.animation.finished.connect(lambda: self.project_widget.setMaximumWidth(0))
        
        self.animation.setStartValue(current_geo)
        self.animation.setEndValue(target_geo)
        self.animation.start()

if __name__ == "__main__":
    app = QApplication([])
    w = ExpandableWidget()
    w.show()
    app.exec_()

补充说明 #

• 若子部件内部有布局，需将布局的contentsMargins设为0，避免内部空白导致最小宽度无法归零。
• 代码适配PySide2/PySide6，仅需调整导入路径即可。
• 向上扩展的子部件可复用逻辑，改为操作height属性和y坐标即可。

内容的提问来源于stack exchange，提问作者PSZ_Code