如何为QTabBar单个标签设置自定义属性以适配QSS样式表

你原来的代码有两个核心问题：

• 自定义的persistent属性是绑定到标签页内容控件（TabItem）上的，但QSS选择器QTabBar::tab[persistent="0"]是在匹配标签栏（QTabBar）的tab项的属性，两者不匹配，QSS无法识别到你设置的属性
• QTabBar的tab项本身没有内置的自定义属性存储入口，不能直接给单个tab加动态属性来匹配QSS

这里给出两种常用实现方式，按需选择即可：

方案1：重写QTabBar的paintEvent实现（最稳定，无QSS兼容性问题） #

这个方案逻辑最可控，不会受Qt版本QSS解析差异影响：

from PySide2 import QtWidgets, QtCore, QtGui


class TabItem(QtWidgets.QWidget):
    def __init__(self, persistent=False):
        super(TabItem, self).__init__()
        self._persistent = persistent


class CustomTabBar(QtWidgets.QTabBar):
    def paintEvent(self, event):
        painter = QtWidgets.QStylePainter(self)
        opt = QtWidgets.QStyleOptionTab()

        for i in range(self.count()):
            self.initStyleOption(opt, i)
            # 获取对应TabItem的persistent属性
            tab_widget = self.parent()
            tab_content = tab_widget.widget(i)
            if hasattr(tab_content, '_persistent') and not tab_content._persistent:
                # 非持久态设置斜体
                font = opt.font
                font.setItalic(True)
                opt.font = font
            painter.drawControl(QtWidgets.QStyle.CE_TabBarTabShape, opt)
            painter.drawControl(QtWidgets.QStyle.CE_TabBarTabLabel, opt)


class TabWidget(QtWidgets.QTabWidget):
    def __init__(self):
        super(TabWidget, self).__init__()
        # 替换自定义TabBar
        self.setTabBar(CustomTabBar())

        item1 = TabItem(persistent=False)
        item2 = TabItem(persistent=True)

        self.addTab(item1, 'FirstItem')
        self.addTab(item2, 'SecondItem')
        
        # 不需要额外针对tab的字体QSS，默认样式即可
        self.setStyleSheet("""
            QTabBar::tab{
                padding: 4px 8px;
            }
        """)


if __name__ == '__main__':
    import sys
    app = QtWidgets.QApplication(sys.argv)
    win = TabWidget()
    win.show()
    sys.exit(app.exec_())

方案2：通过QSS + 给TabBar绑定tab属性映射实现 #

如果你更想用QSS控制样式，可以通过属性映射的方式实现，注意修改persistent属性后需要主动polish刷新样式：

from PySide2 import QtWidgets, QtCore, QtGui


class TabItem(QtWidgets.QWidget):
    def __init__(self, persistent=False):
        super(TabItem, self).__init__()
        self._persistent = persistent


class TabWidget(QtWidgets.QTabWidget):
    def __init__(self):
        super(TabWidget, self).__init__()

        item1 = TabItem(persistent=False)
        item2 = TabItem(persistent=True)

        self.addTab(item1, 'FirstItem')
        self.addTab(item2, 'SecondItem')
        
        # 给每个tab设置动态属性到tabBar上
        for i in range(self.count()):
            persistent = self.widget(i)._persistent
            self.tabBar().setTabData(i, persistent)
            # 给tabBar的对应tab设置属性标记，QSS可以通过索引匹配
            self.tabBar().setProperty(f'tab_{i}_persistent', '0' if not persistent else '1')

        self.setStyleSheet("""
            QTabBar::tab{
                font: normal;
                padding: 4px 8px;
            }
            QTabBar[tab_0_persistent="0"]::tab:nth-child(1){
                font: italic;
            }
            QTabBar[tab_1_persistent="0"]::tab:nth-child(2){
                font: italic;
            }
            /* 如果你有更多tab可以继续往下加，或者动态生成QSS规则 */
        """)


if __name__ == '__main__':
    import sys
    app = QtWidgets.QApplication(sys.argv)
    win = TabWidget()
    win.show()
    sys.exit(app.exec_())

如果后续需要实现双击切换持久态的效果，只需要在TabWidget中绑定tabBarDoubleClicked信号，修改对应TabItem的_persistent属性后，调用self.tabBar().update()刷新即可。

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