如何为QListWidgetItem条件性应用QSS样式表？

针对你的需求，有两个不用写复杂自定义组件的最优方案：

方案一：给列表项绑定自定义Widget（完全沿用你QLabel的实现逻辑） #

QListWidgetItem本身不是QWidget子类，没法直接用setProperty，但可以给每个列表项绑定一个QLabel（或其他QWidget）作为显示载体，然后给这个Widget设置属性，就能复用你熟悉的QSS属性选择器逻辑。

具体操作： #

1. 编写QSS时，把目标选择器改成你用的Widget（比如QLabel）：

QLabel[status=0]
{
    color: red;
}
QLabel[status=1]
{
    color: yellow;
}

2. 代码里给每个QListWidgetItem绑定QLabel并设置属性：

from PyQt5.QtWidgets import QListWidget, QListWidgetItem, QLabel, QApplication

app = QApplication([])
list_widget = QListWidget()

# 创建第一个列表项，绑定QLabel并设置status=0
item = QListWidgetItem(list_widget)
label = QLabel("测试Item 1")
label.setProperty("status", 0)
item.setSizeHint(label.sizeHint())  # 必须设置大小，否则Widget不会显示
list_widget.setItemWidget(item, label)

# 创建第二个列表项，设置status=1
item2 = QListWidgetItem(list_widget)
label2 = QLabel("测试Item 2")
label2.setProperty("status", 1)
item2.setSizeHint(label2.sizeHint())
list_widget.setItemWidget(item2, label2)

# 应用QSS
list_widget.setStyleSheet("""
QLabel[status=0] { color: red; }
QLabel[status=1] { color: yellow; }
""")

list_widget.show()
app.exec_()

这种方法和你之前给QLabel加样式的逻辑完全一致，上手快，适合简单场景。

方案二：用QStyledItemDelegate轻量化实现（无需额外Widget） #

如果不想给每个列表项都套Widget，可以通过重写一个极简的QStyledItemDelegate，读取列表项存储的自定义状态数据，在绘制时直接应用样式。这种方式性能更好，适合大量列表项的场景。

具体操作： #

1. 先给QListWidgetItem用Qt.UserRole存储自定义状态：

item = QListWidgetItem("测试Item")
item.setData(Qt.UserRole, 0)  # 把status存在UserRole里

2. 写一个简单的Delegate类，根据状态设置绘制样式：

from PyQt5.QtWidgets import QStyledItemDelegate, QStyleOptionViewItem
from PyQt5.QtGui import QPalette, QColor
from PyQt5.QtCore import Qt

class StatusDelegate(QStyledItemDelegate):
    def paint(self, painter, option, index):
        # 读取自定义状态
        status = index.data(Qt.UserRole)
        # 复制样式选项，避免修改原始选项影响其他列表项
        opt = QStyleOptionViewItem(option)
        self.initStyleOption(opt, index)
        
        # 根据状态设置文字颜色
        if status == 0:
            opt.palette.setColor(QPalette.Text, QColor("red"))
        elif status == 1:
            opt.palette.setColor(QPalette.Text, QColor("yellow"))
        
        # 调用父类方法完成绘制
        self.parent().style().drawControl(QStyle.CE_ItemViewItem, opt, painter, self.parent())

3. 给QListWidget设置这个Delegate：

list_widget = QListWidget()
delegate = StatusDelegate(list_widget)
list_widget.setItemDelegate(delegate)

# 添加两个不同状态的列表项
item1 = QListWidgetItem("测试Item 1")
item1.setData(Qt.UserRole, 0)
list_widget.addItem(item1)

item2 = QListWidgetItem("测试Item 2")
item2.setData(Qt.UserRole, 1)
list_widget.addItem(item2)

list_widget.show()

这个Delegate代码量很小，不算自定义组件，只是扩展了绘制逻辑，性能比绑定Widget更优。

方案对比 #

• 方案一：优点是逻辑和你之前的QLabel实现完全一致，上手快；缺点是每个列表项都要创建Widget，大量item时内存占用稍高。
• 方案二：优点是轻量化、性能好，适合大量item场景；缺点需要写几行Delegate代码，但非常简单。

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