PyQt中隐藏QTabWidget内容但保留QTabBar可见的实现方法

核心思路是不隐藏整个QTabWidget，只隐藏其内部的内容容器（QStackedWidget），同时保留TabBar可见。因为QTabWidget默认包含QTabBar和QStackedWidget两个子部件，直接操作后者即可实现需求。

PyQt 实现示例 #

自定义TabWidget类 #

from PyQt5.QtWidgets import QTabWidget, QTabBar, QStackedWidget, QWidget
from PyQt5.QtCore import Qt, QPropertyAnimation, QEasingCurve

class CustomTabBar(QTabBar):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setOrientation(Qt.Vertical)  # 垂直TabBar，居左

class CustomTabWidget(QTabWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setTabBar(CustomTabBar(self))
        self.setTabPosition(QTabWidget.West)
        self.stacked_widget = self.findChild(QStackedWidget)  # 获取内部内容容器
        self.content_hidden = False

    def toggle_content(self):
        self.content_hidden = not self.content_hidden
        # 添加平滑动画（可选，模拟VSCode伸缩效果）
        animation = QPropertyAnimation(self, b"width")
        animation.setDuration(300)
        animation.setEasingCurve(QEasingCurve.InOutQuad)

        if self.content_hidden:
            self.stacked_widget.hide()
            animation.setStartValue(self.width())
            animation.setEndValue(self.tabBar().width())
        else:
            self.stacked_widget.show()
            animation.setStartValue(self.width())
            animation.setEndValue(self.sizeHint().width())
        
        animation.start()

测试代码 #

if __name__ == "__main__":
    import sys
    from PyQt5.QtWidgets import QApplication, QPushButton, QVBoxLayout

    app = QApplication(sys.argv)
    window = QWidget()
    layout = QVBoxLayout(window)

    tab_widget = CustomTabWidget()
    tab_widget.addTab(QWidget(), "Tab 1")
    tab_widget.addTab(QWidget(), "Tab 2")

    toggle_btn = QPushButton("Toggle Sidebar")
    toggle_btn.clicked.connect(tab_widget.toggle_content)

    layout.addWidget(toggle_btn)
    layout.addWidget(tab_widget)

    window.show()
    sys.exit(app.exec_())

C++ Qt 实现示例 #

自定义TabWidget类 #

#include <QTabWidget>
#include <QTabBar>
#include <QStackedWidget>
#include <QPropertyAnimation>
#include <QEasingCurve>

class CustomTabBar : public QTabBar {
    Q_OBJECT
public:
    explicit CustomTabBar(QWidget *parent = nullptr) : QTabBar(parent) {
        setOrientation(Qt::Vertical);
    }
};

class CustomTabWidget : public QTabWidget {
    Q_OBJECT
public:
    explicit CustomTabWidget(QWidget *parent = nullptr) : QTabWidget(parent) {
        setTabBar(new CustomTabBar(this));
        setTabPosition(QTabWidget::West);
        stacked_widget = findChild<QStackedWidget*>();
        content_hidden = false;
    }

public slots:
    void toggleContent() {
        content_hidden = !content_hidden;
        QPropertyAnimation *animation = new QPropertyAnimation(this, "width");
        animation->setDuration(300);
        animation->setEasingCurve(QEasingCurve::InOutQuad);

        if (content_hidden) {
            stacked_widget->hide();
            animation->setStartValue(width());
            animation->setEndValue(tabBar()->width());
        } else {
            stacked_widget->show();
            animation->setStartValue(width());
            animation->setEndValue(sizeHint().width());
        }

        animation->start(QAbstractAnimation::DeleteWhenStopped);
    }

private:
    QStackedWidget *stacked_widget;
    bool content_hidden;
};

测试代码 #

#include <QApplication>
#include <QPushButton>
#include <QVBoxLayout>
#include <QWidget>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QWidget window;
    QVBoxLayout *layout = new QVBoxLayout(&window);

    CustomTabWidget *tab_widget = new CustomTabWidget();
    tab_widget->addTab(new QWidget(), "Tab 1");
    tab_widget->addTab(new QWidget(), "Tab 2");

    QPushButton *toggle_btn = new QPushButton("Toggle Sidebar");
    QObject::connect(toggle_btn, &QPushButton::clicked, tab_widget, &CustomTabWidget::toggleContent);

    layout->addWidget(toggle_btn);
    layout->addWidget(tab_widget);

    window.show();
    return app.exec();
}

#include "main.moc"

为什么之前的方法无效？ #

QTabWidget是TabBar的父部件，Qt中父部件调用hide()会递归隐藏所有子部件，因此即使后续调用tabBar()->show()也无法生效——父部件处于隐藏状态时，子部件无法独立显示。直接操作内部的QStackedWidget才是正确的切入点。

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