tkable 1.0.3

Simple and beginner-friendly table widget for Tkinter

The simplest way to create tables in Tkinter for beginners :)

---

✨ Why Tkable?

• No complex setup
• No Treeview headaches
• Built for beginners
• Clean API
• Works out of the box

---

🧠 When should you use Tkable?

✔ Learning Tkinter

✔ Building simple apps

✔ Creating dashboards

✔ Managing data visually

---

📦 Installation

pip install tkable

---

🚀 Quick Example

from tkable import DataTable
import tkinter as tk

root = tk.Tk()

table = DataTable(root, ["Name", "Age", "City"], header_bg="#ff004c" , alternating_colors=("#ffffff", "#ffcadc"))

table.load_data([
    ["Person 1", 20, "City 1"],
    ["Person 2", 22, "City 2"]
])

root.mainloop()

---

📸 Screenshot

---

🔧 Customization Options

Parameter	Type	Default	Description
header_bg	str	#2c3e50	Header background color
header_fg	str	white	Header text color
row_height	int	28	Height of each row
font	tuple	("Segoe UI", 10)	Font used in the table
alternating_colors	tuple	("#ffffff", "#f5f5f5")	Row background colors

---

📦 API Reference

insert_row(*values)

Add a new row to the table.

table.insert_row("Person Name", 20, "City")

---

insert_dict(data: dict)

Insert a row using a dictionary.

table.insert_dict({
    "Name": "Person Name",
    "Age": 22,
    "City": "City"
})

---

load_data(data)

Load multiple rows.

table.load_data([
    ["Person 1", 20, "City 1"],
    ["Person 2", 22, "City 2"]
])

---

clear()

Remove all rows.

table.clear()

---

get_selected_row()

Return selected row as dictionary.

selected = table.get_selected_row()

💡 Tip: Use insert_dict() when working with forms for cleaner code.

---

🤝 Contributing

Pull requests are welcome!

---

⭐ Support

If you like this project, give it a star ⭐

It helps a lot!

---

📄 License

MIT License © Abdullah Sameh