如何在应用样式表时基于对象属性设置QListView项样式

我通过QListView结合自定义Alarm_Viewer_Model展示Alarm对象，模型通过Qt.ForegroundRole根据Alarm.level属性为每个列表项设置不同文本颜色，原本功能正常。但应用全局样式表（为所有控件设置默认文本颜色）后，样式表的颜色会覆盖模型中设置的颜色（已确认这是Qt的正常行为）。

我需要解决的问题是：如何在保留全局样式表的同时，仍能独立控制每个列表项的样式？同时有两个疑问：

• 是否可以通过模型为列表项设置自定义属性，让样式表通过选择器（如QListView::item[level=1] { color: red; }）控制样式？
• 是否必须使用QStyledItemDelegate，有没有更简便的方案？

附原有核心代码：

from dataclasses import dataclass
from datetime import datetime
from typing import List, Dict
from PySide2.QtCore import QAbstractListModel, QModelIndex, Qt, QColor, QBrush

@dataclass
class Alarm:
    name: str
    level: int
    started_at: datetime

class Alarm_Viewer_Model(QAbstractListModel):
    def __init__(
            self,
            alarms: List[Alarm] = None,
            alarm_colors: Dict[int, QColor] = None,
            *args,
            **kwargs
    ):
        super().__init__(*args, **kwargs)
        self._alarms = alarms or []
        self._alarm_colors = alarm_colors or {}

    def data(self, index: QModelIndex, role: int):
        alarm = self._alarms[index.row()]
        if role == Qt.DisplayRole:
            dt = alarm.started_at.strftime('%Y/%m/%d %H:%M:%S')
            return f"{dt} - {alarm.level.name} - {alarm.name}"
        elif role == Qt.ForegroundRole:
            alarm_color = self._alarm_colors.get(alarm.level, Qt.black)
            return QBrush(alarm_color)

方法一：通过模型自定义角色实现样式表属性选择（可行） #

Qt支持将模型中Qt.UserRole及以上的自定义角色数据，作为列表项的属性暴露给样式表，这样就能用属性选择器精准控制样式。

步骤1：在模型中添加自定义角色 #

# 定义自定义角色，用于传递Alarm.level值
LevelRole = Qt.UserRole + 1

class Alarm_Viewer_Model(QAbstractListModel):
    # ... 原有__init__方法不变 ...

    def data(self, index: QModelIndex, role: int):
        alarm = self._alarms[index.row()]
        if role == Qt.DisplayRole:
            dt = alarm.started_at.strftime('%Y/%m/%d %H:%M:%S')
            return f"{dt} - {alarm.level.name} - {alarm.name}"
        elif role == LevelRole:
            return alarm.level  # 将level值作为自定义角色数据返回
        # 原ForegroundRole可保留，但样式表优先级更高，主要靠自定义角色控制
        elif role == Qt.ForegroundRole:
            alarm_color = self._alarm_colors.get(alarm.level, Qt.black)
            return QBrush(alarm_color)

步骤2：编写样式表匹配自定义属性 #

直接为QListView的项编写带属性选择器的样式：

QListView::item[level="1"] {
    color: red;
}
QListView::item[level="2"] {
    color: orange;
}
QListView::item[level="3"] {
    color: green;
}

注意：如果Alarm.level是枚举类型，需确保data方法返回的是样式表可识别的字符串或数值类型。

方法二：使用QStyledItemDelegate（灵活可靠，并非繁琐） #

如果需要更复杂的样式控制（如字体、背景、hover状态等），重写QStyledItemDelegate是更稳定的方案，实现起来并不复杂：

实现自定义代理 #

from PySide2.QtWidgets import QStyledItemDelegate
from PySide2.QtGui import QStyleOptionViewItem, QPalette

class AlarmDelegate(QStyledItemDelegate):
    def initStyleOption(self, option: QStyleOptionViewItem, index: QModelIndex):
        super().initStyleOption(option, index)
        # 从模型获取预设的颜色
        brush = index.data(Qt.ForegroundRole)
        if brush:
            option.palette.setColor(QPalette.Text, brush.color())
        # 也可直接根据level值设置颜色，无需依赖模型的ForegroundRole
        # alarm_level = index.data(LevelRole)
        # if alarm_level == 1:
        #     option.palette.setColor(QPalette.Text, QColor("red"))

绑定代理到QListView #

list_view = QListView()
delegate = AlarmDelegate()
list_view.setItemDelegate(delegate)

这种方式不受样式表优先级限制，完全由代理控制项的样式，适合复杂场景。

额外提示：样式表优先级规避 #

如果想保留模型ForegroundRole的设置，可调整全局样式表的选择器，避免直接覆盖QListView项的样式：

/* 全局默认样式，不对QListView::item直接设置颜色 */
QWidget:not(QListView::item) {
    color: #333;
}

但这种方式局限性较大，不如前两种方法可靠。

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