Tkinter Style map() Method

Typically, a tkinter widget allows you to change its appearance based on a specific state.

The following table shows a list of widget states and their meanings:

activeThe mouse is currently within the widget.
alternateTtk reserved this state for application use.
backgroundThe widget is on a window that is not the foreground window. The foreground window is a window that is getting user inputs. This state is only relevant to Windows and macOS.
disabledThe widget won’t respond to any actions.
focusThe widget currently has focus.
invalidThe value of the widget is currently invalid.
pressedThe widget is currently being clicked or pressed e.g. when a Button widget is pressed.
readonlyThe readonly widget prevents you from changing its current value e.g., a read-only Entry widget won’t allow you to change its text contents.
selectedThe widget is selected e.g. when radio buttons are checked.

To change the appearance of a widget dynamically, you can use the map() method of the Style object:, query)Code language: Python (python)

The map() method accepts the first argument as the name of the style e.g., TButton and TLabel.

The argument query is a list of keyword arguments where each key is a style option and values are lists of tuples of (state,value).

For example, the following code dynamically changes the foreground color of a button widget:

import tkinter as tk
from tkinter import ttk

class App(tk.Tk):
    def __init__(self):


        button = ttk.Button(self, text='Save')

        style = ttk.Style(self)
        style.configure('TButton', font=('Helvetica', 16))'TButton',
                foreground=[('pressed', 'blue'),
                            ('active', 'red')])


if __name__ == "__main__":
    app = App()
    app.mainloop()Code language: Python (python)

In this example, when you move focus to the button, its text color changes to red. And when you click or press the button, its text color turns to blue.



  • Use the method to dynamically change the appearance of a widget based on its specific state.
Follow Us On