qextrawidgets 0.1.3

A collection of extra widgets for PySide6 including Emoji Picker, Filterable Table, and more.

QExtraWidgets

QExtraWidgets is a comprehensive library of modern, responsive, and feature-rich widgets for PySide6 applications. It aims to fill the gaps in standard Qt widgets by providing high-level components like Excel-style filterable tables, emoji pickers, accordion menus, and theme-aware icons.

---

📖 Documentation

The complete documentation is available at: https://gpedrosobernardes.github.io/QExtraWidgets/

---

📦 Installation

pip install qextrawidgets

Requirements:

• Python 3.9+
• PySide6 >= 6.10.1
• twemoji-api >= 2.0.0
• emoji-data-python == 1.6.0
• qtawesome == 1.4.0

---

✨ Features & Widgets

1. QFilterableTable

A powerful QTableView extension that adds Excel-like filtering capabilities to headers.

• Cascading Filters: Filter options update based on other columns (drill-down).
• Sort & Search: Built-in sorting and search within the filter popup.
• Model Agnostic: Works with QSqlTableModel, QStandardItemModel, or any custom model.

---

2. QEmojiPicker & QTwemojiTextEdit

A full-featured Emoji Picker and a Text Edit that renders Twemoji images inline.

• Lazy Loading: Efficiently handles thousands of emojis.
• Auto-Resize: The QExtraTextEdit grows automatically with content (like WhatsApp/Telegram).
• Emoji Replacement: Automatically converts :smile: aliases or pasted unicode characters into high-quality images.

---

3. QAccordion

A flexible accordion widget for grouping content in collapsible sections.

• Customizable: Change icon position (left/right) and animation speed.
• Smooth Animation: Uses QPropertyAnimation for expanding/collapsing.

---

4. QThemeResponsiveIcon

Stop worrying about Dark/Light mode icons. This class wraps QtAwesome to automatically invert colors (Black <-> White) based on the current system or application palette.

from qextrawidgets.icons import QThemeResponsiveIcon
from PySide6.QtWidgets import QPushButton

btn = QPushButton("Theme Aware Button")
# Automatically switches color when QPalette changes
btn.setIcon(QThemeResponsiveIcon.fromAwesome("fa6s.house"))

---

5. QStandardTwemojiDelegate

A delegate that renders Twemoji images within standard item views (like QListView, QTableView, QTreeView).

• Unicode Support: Renders standard Unicode emojis as high-quality Twemoji images.
• Alignment: Supports standard Qt text alignment flags.
• Mixed Content: Handles text mixed with emojis seamlessly.

from PySide6.QtWidgets import QListView
from qextrawidgets.delegates.standard_twemoji_delegate import QStandardTwemojiDelegate

view = QListView()
delegate = QStandardTwemojiDelegate(view)
view.setItemDelegate(delegate)

---

6. Other Useful Widgets

Widget	Description	Image
QPasswordLineEdit	A line edit with a built-in eye icon to toggle password visibility.
QPager	A classic pagination control for navigating large datasets.
QColorButton	A button that displays a selected color and opens a dialog on click.
QDualList	Two lists side-by-side for moving items (Select/Deselect).
QSearchLineEdit	A search input field with a clear button and search icon.
QIconComboBox	A ToolButton-style combo box optimized for icons or short text.

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.