semvec/pypi-packages huggingface dataset:
ttk-text 0.3.1
Themed Tkinter Text widget with modern styling support.
Requires Python: >=3.8
Keywords: ttk, ttk-text, tkinter, tkinter-text, tk, tk-text

<!-- Warning! This file will be included in the wheel package. Please do not use relative paths. -->

# Themed Tkinter Text

![Contributor Covenant 2.1](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)
![MIT License](https://img.shields.io/pypi/l/ttk-text)

Themed Tkinter Text widget with modern styling support.

## Features

- 🎨 Theme-aware text widget that automatically adapts to ttk themes
- 📜 Built-in ScrolledText component with vertical/horizontal scrollbars
- 🖥️ Native integration with ttk styles and themes
- 🔄 Dynamic theme switching support

## Screenshots

<div>
<img src="https://github.com/hellotool/ttk-text/raw/refs/heads/main/assets/images/screenshots/windows11.webp" alt="Windows 11" width="338.7">
<img src="https://github.com/hellotool/ttk-text/raw/refs/heads/main/assets/images/screenshots/windows10.webp" alt="Windows 10" width="337">
<img src="https://github.com/hellotool/ttk-text/raw/refs/heads/main/assets/images/screenshots/windows7.webp" alt="Windows 7" width="350.7">
</div>

Example screenshots of Windows 11, Windows 10, and Windows 7.

## Using the Widgets

ttk-text provides two widgets:

- `ttk_text.ThemedText`: A themed Text widget, as a replacement for `tkinter.Text`.
- `ttk_text.scrolled_text.ScrolledText`: An extension of `ThemedText` with vertical/horizontal scrollbars, as a replacement for `tkinter.scrolledtext.ScrolledText`.

You can use `ThemedText` and `ScrolledText` just like you would use `tkinter.Text`.

Here’s an example:

```python
from tkinter import Tk
from ttk_text import ThemedText
from ttk_text.scrolled_text import ScrolledText

root = Tk()
themed_text = ThemedText(root)
themed_text.pack(fill="both", expand=True)

scrolled_text = ScrolledText(root)
scrolled_text.pack(fill="both", expand=True)

root.mainloop()
```

## Contributing

See [CONTRIBUTING.md](https://github.com/hellotool/ttk-text/blob/main/CONTRIBUTING.md) for details.

## License

This project is licensed under the MIT License, see the [LICENSE](https://github.com/hellotool/ttk-text/blob/main/LICENSE) file for details.