如何解决TTK Button组件自定义样式不生效的问题？

问题根本原因 #

• TTK 组件的样式属性和原生 Tkinter Button 完全不同，且样式生效逻辑和当前使用的 TTK 主题强绑定，默认系统主题大多自带原生绘制逻辑，会覆盖自定义的背景、前景配置
• 代码里用了很多原生 Tkinter Button 的属性，TTK 不识别
• 没有单独配置 TTK 按钮的交互状态样式，active 类属性需要用style.map()方法配置

各属性失效对应说明 #

• background/activebackground失效：默认系统主题禁止修改按钮背景色，且active状态属性不能直接在configure里配置，需要通过map方法关联状态
• foreground显示为白色遮罩：默认主题的按钮文本是绘制在预置的按钮底图上的，自定义前景色会被底图遮挡，仅显示为遮罩效果
• padx失效：TTK TButton 的内边距属性为padding，而非原生的padx/pady
• bd失效：TTK 中边框属性为borderwidth，不识别bd简写

修复步骤 #

步骤1：切换到支持自定义样式的 TTK 主题 #

优先选择clam/alt/default这类跨平台的可自定义主题，不要使用系统默认主题：

from tkinter import ttk

style = ttk.Style()
# 切换主题，必须放在样式配置之前
style.theme_use("clam")

步骤2：修正样式配置代码 #

# 配置按钮默认状态样式
style.configure(
    "Menu.TButton",
    font=("Times New Roman", 20),
    width=30, # TTK 的width单位为字符数，如需按像素控制宽度可在外层容器加padding
    padding=(20, 4), # 格式为(水平内边距, 垂直内边距)，也可写为(左, 上, 右, 下)
    anchor="w",
    background="#21252B",
    foreground="#fff",
    borderwidth=0
)

# 配置按钮交互状态样式（hover、按下等状态）
style.map(
    "Menu.TButton",
    # 格式为 [("状态名", 对应属性值), ...]
    background=[("active", "#BD93F9"), ("pressed", "#a879f5")],
    foreground=[("active", "#21252B"), ("pressed", "#fff")]
)

步骤3：确认按钮实例化使用的是 TTK 组件 #

必须使用ttk.Button而非原生tkinter.Button，否则样式不生效：

# 注意是ttk.Button
home_button = ttk.Button(menu_frame, style="Menu.TButton", text="Home")
home_button.grid(column=0, row=1)

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