Python3+GTK3开发：获取主题配色实现按钮悬停变色的替代方案

嘿，刚好我之前也踩过这个坑，GTK3弃用gtk-color-scheme之后，用CSS样式是最靠谱的解决方案——这也是GTK3官方主推的主题适配方式，既能自动跟随系统主题变化，又足够灵活。

下面给你两种实用的方法，你可以根据需求选：

方法一：用CSS样式（推荐） #

这种方法能让按钮的悬停颜色自动适配系统主题，而且主题切换时会自动更新，完全不需要手动硬编码颜色值。

具体步骤： #

1. 给你的按钮添加一个自定义CSS类名，方便后续精准定位；
2. 创建Gtk.CssProvider加载自定义CSS规则，用系统主题的预定义颜色变量设置悬停背景；
3. 将CSS提供者应用到按钮的样式上下文。

示例代码： #

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk

class AppWindow(Gtk.Window):
    def __init__(self):
        super().__init__(title="主题适配按钮示例")
        self.set_border_width(15)

        # 创建上传按钮
        self.uploadbutton = Gtk.Button(label="上传文件")
        # 给按钮添加自定义类名，方便CSS选择
        self.uploadbutton.get_style_context().add_class("custom-upload-btn")

        # 初始化CSS提供者
        css_provider = Gtk.CssProvider()
        # 编写CSS规则，使用系统主题的悬停背景色变量
        css_content = """
        .custom-upload-btn:hover {
            background-color: @theme-hover-bg-color;
            /* 可选：加个过渡动画，让颜色变化更自然 */
            transition: background-color 0.2s ease;
        }
        """
        # 加载CSS内容
        css_provider.load_from_data(css_content.encode())

        # 将CSS应用到按钮，优先级设为APPLICATION确保生效
        self.uploadbutton.get_style_context().add_provider(
            css_provider,
            Gtk.STYLE_PROVIDER_PRIORITY_APPLICATION
        )

        self.add(self.uploadbutton)

# 启动应用
win = AppWindow()
win.connect("destroy", Gtk.main_quit)
win.show_all()
Gtk.main()

系统主题常用颜色变量： #

GTK3的主题内置了很多预定义变量，你可以根据需求替换：

• @theme-hover-bg-color：系统默认的控件悬停背景色
• @theme-selected-bg-color：控件选中时的背景色
• @theme-button-bg-color：按钮默认背景色
• @theme-bg-color：窗口背景色

方法二：通过StyleContext获取主题颜色 #

如果你还是想用modify_bg的方式，可以通过Gtk.StyleContext直接获取系统主题的对应状态颜色，但这种方法的缺点是主题切换时不会自动更新，需要手动监听主题变化事件。

示例代码： #

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk, Gdk

class AppWindow(Gtk.Window):
    def __init__(self):
        super().__init__(title="主题颜色获取示例")
        self.set_border_width(15)

        self.uploadbutton = Gtk.Button(label="上传文件")
        # 获取按钮的样式上下文
        style_ctx = self.uploadbutton.get_style_context()
        # 获取悬停状态的主题颜色
        hover_color = style_ctx.get_color(Gtk.StateFlags.PRELIGHT)
        # 设置按钮悬停背景色
        self.uploadbutton.modify_bg(Gtk.StateType.PRELIGHT, hover_color)

        self.add(self.uploadbutton)

win = AppWindow()
win.connect("destroy", Gtk.main_quit)
win.show_all()
Gtk.main()

总结 #

优先推荐第一种CSS方法，因为它更符合GTK3的设计理念，能自动适配主题变化，代码也更易维护。如果有特殊场景需求，再考虑第二种方法。

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