fix(quick-panel): adjust icon and text color opacity with hover effects

MyLeeJiEun · MyLeeJiEun · commit d4812875e899 · 2026-06-22T10:25:51.000+08:00
1. Add kNormalOpacity (0.7) and kHoverOpacity (1.0) constants in CommonIconButton, controlling icon/text transparency via parentHovered state
2. Add HoverEventFilter to QuickPluginItem, forwarding enter/leave events to child widgets for hover state tracking
3. Add QGraphicsOpacityEffect to PluginItemWidget for icon/label/connect button with enterEvent/leaveEvent overrides
4. Update SliderContainer to read _dtl_plugin_hovered property and adjust progress track opacity accordingly
5. Backport identical opacity logic to wireless-casting plugin's CommonIconButton copy

Log: Adjust colors and hover effects for quick panel icons and text

fix(快捷面板): 调整快捷面板图标和文字颜色及hover效果

1. CommonIconButton 增加 kNormalOpacity(0.7) 和 kHoverOpacity(1.0) 常量，通过 parentHovered 状态控制图标/文字透明度
2. QuickPluginItem 增加 HoverEventFilter，将 enter/leave 事件转发到子控件实现 hover 状态跟踪
3. PluginItemWidget 增加 icon/label/connect button 的 QGraphicsOpacityEffect，重写 enterEvent/leaveEvent
4. SliderContainer 读取 _dtl_plugin_hovered 属性，根据 hover 状态调整进度条透明度
5. 无线投屏插件中的 CommonIconButton 同步相同的透明度逻辑

Log: 调整快捷面板图标和文字颜色及hover效果
PMS: BUG-314503
diff --git a/plugins/dde-dock/common/commoniconbutton.cpp b/plugins/dde-dock/common/commoniconbutton.cpp
@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2019 - 2022 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2019 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 #include "commoniconbutton.h"
@@ -11,6 +11,9 @@
 
 DGUI_USE_NAMESPACE
 
+static constexpr qreal kNormalOpacity = 0.7;
+static constexpr qreal kHoverOpacity = 1.0;
+
 CommonIconButton::CommonIconButton(QWidget *parent)
     : QWidget(parent)
     , m_refreshTimer(nullptr)
@@ -21,6 +24,7 @@ CommonIconButton::CommonIconButton(QWidget *parent)
     , m_darkThemeColor(Qt::white)
     , m_activeState(false)
     , m_hoverEnable(true)
+    , m_parentHovered(false)
     , m_iconSize(QSize())
     , m_rotation(0)
 {
@@ -87,6 +91,8 @@ void CommonIconButton::updatePalette()
         if (m_lightThemeColor.isValid() && m_darkThemeColor.isValid()) {
             if (!m_activeState) {
                 QColor color = DGuiApplicationHelper::instance()->themeType() == DGuiApplicationHelper::LightType ? m_lightThemeColor : m_darkThemeColor;
+                qreal alpha = m_parentHovered ? kHoverOpacity : kNormalOpacity;
+                color.setAlphaF(alpha);
                 auto pa = palette();
                 pa.setColor(QPalette::WindowText, color);
                 setPalette(pa);
@@ -113,6 +119,15 @@ void CommonIconButton::setHoverEnable(bool enable)
     m_hoverEnable = enable;
 }
 
+void CommonIconButton::setParentHovered(bool hovered)
+{
+    if (m_parentHovered == hovered)
+        return;
+
+    m_parentHovered = hovered;
+    updatePalette();
+}
+
 void CommonIconButton::setIcon(const QString &icon, const QString &fallback, const QString &suffix)
 {
     if (!m_fileMapping.contains(Default)) {
diff --git a/plugins/dde-dock/common/commoniconbutton.h b/plugins/dde-dock/common/commoniconbutton.h
@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2019 - 2022 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2019 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 #ifndef ICONBUTTON_H
@@ -43,6 +43,8 @@ public Q_SLOTS:
     void setHoverIcon(const QIcon &icon);
 
     void setClickable(bool clickable);
+    void setParentHovered(bool hovered);
+    bool isParentHovered() const { return m_parentHovered; }
 
 signals:
     void clicked();
@@ -70,6 +72,7 @@ public Q_SLOTS:
     QColor m_darkThemeColor;
     bool m_activeState;
     bool m_hoverEnable;
+    bool m_parentHovered;
     QSize m_iconSize;
     qreal m_rotation;
     QPalette m_defaultPalette;
diff --git a/plugins/dde-dock/common/pluginitemdelegate.cpp b/plugins/dde-dock/common/pluginitemdelegate.cpp
@@ -14,6 +14,8 @@
 #include <QPalette>
 #include <QIcon>
 #include <QListView>
+#include <QEnterEvent>
+#include <QGraphicsOpacityEffect>
 
 PluginItemDelegate::PluginItemDelegate(QAbstractItemView *parent)
     : QStyledItemDelegate(parent)
@@ -191,6 +193,9 @@ PluginItemWidget::PluginItemWidget(PluginStandardItem *item, QWidget *parent)
     , m_connBtn(nullptr)
     , m_spinner(nullptr)
     , m_rightIconSpacerItem(new QSpacerItem(0, 0))
+    , m_iconOpacity(nullptr)
+    , m_labelOpacity(nullptr)
+    , m_connOpacity(nullptr)
 {
     if (!m_item) {
         QLabel *err = new QLabel(this);
@@ -223,6 +228,14 @@ PluginItemWidget::PluginItemWidget(PluginStandardItem *item, QWidget *parent)
     m_spinner->hide();
     m_spinner->stop();
 
+    m_iconOpacity = new QGraphicsOpacityEffect(m_iconBtn);
+    m_iconBtn->setGraphicsEffect(m_iconOpacity);
+    m_labelOpacity = new QGraphicsOpacityEffect(m_nameLabel);
+    m_nameLabel->setGraphicsEffect(m_labelOpacity);
+    m_connOpacity = new QGraphicsOpacityEffect(m_connBtn);
+    m_connBtn->setGraphicsEffect(m_connOpacity);
+    updateHoverOpacity(false);
+
     m_mainLayout->setContentsMargins(10, 0, 10, 0);
     m_mainLayout->setSpacing(0);
     m_mainLayout->addWidget(m_iconBtn, 0);
@@ -298,6 +311,32 @@ void PluginItemWidget::updateState(const PluginItemState state)
     m_mainLayout->invalidate();
 }
 
+void PluginItemWidget::enterEvent(QEnterEvent *event)
+{
+    updateHoverOpacity(true);
+    QWidget::enterEvent(event);
+}
+
+void PluginItemWidget::leaveEvent(QEvent *event)
+{
+    updateHoverOpacity(false);
+    QWidget::leaveEvent(event);
+}
+
+void PluginItemWidget::updateHoverOpacity(bool hovered)
+{
+    static constexpr qreal kNormalAlpha = 0.7;
+    static constexpr qreal kHoverAlpha = 1.0;
+    qreal alpha = hovered ? kHoverAlpha : kNormalAlpha;
+
+    if (m_iconOpacity)
+        m_iconOpacity->setOpacity(alpha);
+    if (m_labelOpacity)
+        m_labelOpacity->setOpacity(alpha);
+    if (m_connOpacity)
+        m_connOpacity->setOpacity(alpha);
+}
+
 bool PluginItemWidget::event(QEvent *e)
 {
     switch (e->type()) {
diff --git a/plugins/dde-dock/common/pluginitemdelegate.h b/plugins/dde-dock/common/pluginitemdelegate.h
@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2016 - 2023 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2016 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 
@@ -8,6 +8,7 @@
 
 #include <DLabel>
 #include <DSpinner>
+#include <QGraphicsOpacityEffect>
 
 #include <QObject>
 #include <QStyledItemDelegate>
@@ -116,8 +117,11 @@ public Q_SLOTS:
 
 protected:
     bool event(QEvent *e) override;
+    void enterEvent(QEnterEvent *event) override;
+    void leaveEvent(QEvent *event) override;
 
 private:
+    void updateHoverOpacity(bool hovered);
     PluginStandardItem *m_item;
 
     QHBoxLayout *m_mainLayout;
@@ -126,4 +130,7 @@ public Q_SLOTS:
     CommonIconButton *m_connBtn;
     DSpinner *m_spinner;
     QSpacerItem *m_rightIconSpacerItem;
+    QGraphicsOpacityEffect *m_iconOpacity;
+    QGraphicsOpacityEffect *m_labelOpacity;
+    QGraphicsOpacityEffect *m_connOpacity;
 };
diff --git a/plugins/dde-dock/common/slidercontainer.cpp b/plugins/dde-dock/common/slidercontainer.cpp
@@ -1,4 +1,4 @@
-// Copyright (C) 2022 ~ 2022 Deepin Technology Co., Ltd.
+// Copyright (C) 2022 ~ 2026 Deepin Technology Co., Ltd.
 // SPDX-FileCopyrightText: 2018 - 2023 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
@@ -323,6 +323,12 @@ void SliderProxyStyle::drawNormalSlider(QPainter *painter, QRect rectGroove, QRe
 // 绘制设计师定义的那种圆形滑块，黑色的滑条
 void SliderProxyStyle::drawRoundSlider(QPainter *painter, QRect rectGroove, QRect rectHandle, const QWidget *widget) const
 {
+    static constexpr qreal kNormalProgressAlpha = 0.7;
+    static constexpr qreal kHoveredProgressAlpha = 1.0;
+
+    bool pluginHovered = widget->property("_dtl_plugin_hovered").toBool();
+    qreal progressAlpha = pluginHovered ? kHoveredProgressAlpha : kNormalProgressAlpha;
+
     // 深色背景下，滑块和滑动条白色，浅色背景下，滑块和滑动条黑色
     QColor color = widget->isEnabled() ? (DGuiApplicationHelper::DarkType == DGuiApplicationHelper::instance()->themeType() ? Qt::white : Qt::black) : Qt::gray;
 
@@ -338,7 +344,9 @@ void SliderProxyStyle::drawRoundSlider(QPainter *painter, QRect rectGroove, QRec
     painter->fillPath(allPathGroove, allBrush);
 
     // 已经滑动过的区域
-    QBrush brush(color);
+    QColor progressColor = color;
+    progressColor.setAlphaF(progressAlpha);
+    QBrush brush(progressColor);
     QPainterPath pathGroove;
     int handleSize = qMin(rectHandle.width(), rectHandle.height());
     rectGroove.setWidth(rectHandle.x() + (rectHandle.width() - handleSize) / 2);
diff --git a/plugins/dde-network-display-ui/plugins/dock-wirelesscasting-plugin/src/widget/commoniconbutton.cpp b/plugins/dde-network-display-ui/plugins/dock-wirelesscasting-plugin/src/widget/commoniconbutton.cpp
@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2019 - 2022 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2019 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 #include "commoniconbutton.h"
@@ -11,6 +11,9 @@
 
 DGUI_USE_NAMESPACE
 
+static constexpr qreal kNormalOpacity = 0.7;
+static constexpr qreal kHoverOpacity = 1.0;
+
 CommonIconButton::CommonIconButton(QWidget *parent)
     : QWidget(parent)
     , m_refreshTimer(nullptr)
@@ -23,6 +26,7 @@ CommonIconButton::CommonIconButton(QWidget *parent)
     , m_darkThemeColor(Qt::white)
     , m_activeState(false)
     , m_hoverEnable(true)
+    , m_parentHovered(false)
 {
     setAccessibleName("IconButton");
     setFixedSize(24, 24);
@@ -64,8 +68,12 @@ void CommonIconButton::updatePalette()
 {
     if (m_lightThemeColor.isValid() && m_darkThemeColor.isValid()) {
         QColor color = DGuiApplicationHelper::instance()->themeType() == DGuiApplicationHelper::LightType ? m_lightThemeColor : m_darkThemeColor;
-        if (m_activeState)
+        if (m_activeState) {
             color = palette().color(QPalette::Highlight);
+        } else {
+            qreal alpha = m_parentHovered ? kHoverOpacity : kNormalOpacity;
+            color.setAlphaF(alpha);
+        }
         auto pa = palette();
         pa.setColor(QPalette::WindowText, color);
         setPalette(pa);
@@ -89,6 +97,15 @@ void CommonIconButton::setHoverEnable(bool enable)
     m_hoverEnable = enable;
 }
 
+void CommonIconButton::setParentHovered(bool hovered)
+{
+    if (m_parentHovered == hovered)
+        return;
+
+    m_parentHovered = hovered;
+    updatePalette();
+}
+
 void CommonIconButton::setIcon(const QString &icon, const QString &fallback, const QString &suffix)
 {
     if (!m_fileMapping.contains(Default)) {
diff --git a/plugins/dde-network-display-ui/plugins/dock-wirelesscasting-plugin/src/widget/commoniconbutton.h b/plugins/dde-network-display-ui/plugins/dock-wirelesscasting-plugin/src/widget/commoniconbutton.h
@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2019 - 2022 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2019 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 #ifndef ICONBUTTON_H
@@ -34,6 +34,8 @@ public Q_SLOTS:
 
     void setClickable(bool clickable);
     void setRotatable(bool rotatable);
+    void setParentHovered(bool hovered);
+    bool isParentHovered() const { return m_parentHovered; }
 
 signals:
     void clicked();
@@ -66,6 +68,7 @@ public Q_SLOTS:
     QColor m_darkThemeColor;
     bool m_activeState;
     bool m_hoverEnable;
+    bool m_parentHovered;
 };
 
 #endif // DOCKICONBUTTON_H
diff --git a/src/loader/quickpluginitem.cpp b/src/loader/quickpluginitem.cpp
@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2024 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2024 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: LGPL-3.0-or-later
 
@@ -9,6 +9,10 @@
 
 #include <QMouseEvent>
 #include <QMenu>
+#include <QLabel>
+#include <QSlider>
+#include <QAbstractButton>
+#include <QGraphicsOpacityEffect>
 
 namespace {
 class Q_DECL_HIDDEN EventFilter : public QObject
@@ -96,13 +100,42 @@ class Q_DECL_HIDDEN ItemWidgetEventFilter : public QObject
 
     QuickPluginItem *m_target = nullptr;
 };
+
+class Q_DECL_HIDDEN HoverEventFilter : public QObject
+{
+public:
+    explicit HoverEventFilter(QuickPluginItem *target)
+        : QObject(target)
+        , m_target(target)
+    {
+    }
+
+    bool eventFilter(QObject *watched, QEvent *event) override
+    {
+        if (event->type() != QEvent::Enter && event->type() != QEvent::Leave)
+            return false;
+
+        // underMouse() is updated before event filter runs in Qt's event delivery;
+        // centralWidget()->window() => the quick panel's top-level window
+        bool isUnder = false;
+        if (auto *w = m_target->centralWidget()) {
+            if (auto *win = w->window())
+                isUnder = win->underMouse();
+        }
+        m_target->updatePluginHoverState(isUnder);
+        return false;
+    }
+
+    QuickPluginItem *m_target = nullptr;
+};
 }
 
 QuickPluginItem::QuickPluginItem(PluginsItemInterface *pluginInterface, const QString &itemKey, QWidget *parent)
     : PluginItem(pluginInterface, itemKey, parent)
     , m_onDockAction(nullptr)
 {
     qApp->installEventFilter(new EventFilter(this));
+    installEventFilter(new HoverEventFilter(this));
 }
 
 void QuickPluginItem::init()
@@ -111,6 +144,7 @@ void QuickPluginItem::init()
     if (auto widget = centralWidget()) {
         widget->installEventFilter(new ItemWidgetEventFilter(this));
     }
+    updatePluginHoverState(false);
 }
 
 QWidget *QuickPluginItem::centralWidget()
@@ -215,3 +249,45 @@ void QuickPluginItem::requestActiveState()
         }
     }
 }
+
+void QuickPluginItem::updatePluginHoverState(bool hovered)
+{
+    if (m_hoverStateApplied && m_pluginHovered == hovered)
+        return;
+
+    m_pluginHovered = hovered;
+    m_hoverStateApplied = true;
+
+    static constexpr qreal kNormalAlpha = 0.7;
+    static constexpr qreal kHoverAlpha = 1.0;
+    const qreal targetAlpha = hovered ? kHoverAlpha : kNormalAlpha;
+
+    // Single pass: no redundant findChildren calls.
+    // CommonIconButton → invokeMethod (fallback to QGraphicsOpacityEffect)
+    // QSlider         → property + update()
+    // QLabel / QAbstractButton → QGraphicsOpacityEffect
+    // These branches are mutually exclusive in the widget hierarchy.
+    for (auto *child : findChildren<QWidget *>()) {
+        if (child->inherits("CommonIconButton")) {
+            bool invoked = QMetaObject::invokeMethod(child, "setParentHovered", Q_ARG(bool, hovered));
+            if (!invoked) {
+                auto *effect = qobject_cast<QGraphicsOpacityEffect *>(child->graphicsEffect());
+                if (!effect) {
+                    effect = new QGraphicsOpacityEffect(child);
+                    child->setGraphicsEffect(effect);
+                }
+                effect->setOpacity(targetAlpha);
+            }
+        } else if (qobject_cast<QSlider *>(child)) {
+            child->setProperty("_dtl_plugin_hovered", hovered);
+            child->update();
+        } else if (qobject_cast<QLabel *>(child) || qobject_cast<QAbstractButton *>(child)) {
+            auto *effect = qobject_cast<QGraphicsOpacityEffect *>(child->graphicsEffect());
+            if (!effect) {
+                effect = new QGraphicsOpacityEffect(child);
+                child->setGraphicsEffect(effect);
+            }
+            effect->setOpacity(targetAlpha);
+        }
+    }
+}
diff --git a/src/loader/quickpluginitem.h b/src/loader/quickpluginitem.h
