Metadata-Version: 2.4
Name: ttk-text
Version: 0.3.1
Summary: Themed Tkinter Text widget with modern styling support.
Keywords: ttk,ttk-text,tkinter,tkinter-text,tk,tk-text
Author: Jesse205
Author-email: Jesse205 <jesse205@qq.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 8.1
Classifier: Operating System :: Microsoft :: Windows :: Windows 8
Classifier: Operating System :: Microsoft :: Windows :: Windows 7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Development Status :: 2 - Pre-Alpha
Maintainer: Jesse205
Maintainer-email: Jesse205 <jesse205@qq.com>
Requires-Python: >=3.8
Project-URL: Repository, https://github.com/hellotool/ttk-text
Project-URL: Tracker, https://github.com/hellotool/ttk-text/issues
Project-URL: Changelog, https://github.com/hellotool/ttk-text/releases
Description-Content-Type: text/markdown

<!-- 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.
