Skip to content

Home

QExtraWidgets Logo

PyPI version License: MIT Python Versions Documentation Status

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

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

QFilterableTable

2. QEmojiPicker

A full-featured Emoji Picker.

  • Rich Features: Includes skin tone selector, favorites/recents management, and context menu actions (copy alias, favorite/unfavorite).
  • Optimized Search: Fast filtering with recursive category matching.
  • Emoji Replacement: Automatically converts :smile: aliases or pasted unicode characters into high-quality images.

QEmojiPicker

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.

QAccordion

4. QThemeResponsiveIcon & QThemeResponsiveLabel

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

For labels, QThemeResponsiveLabel automatically updates its pixmap when the icon theme or widget size changes.

QThemeResponsiveIcon

5. Other Useful Widgets

Widget Description Image
QPasswordLineEdit A line edit with a built-in eye icon to toggle password visibility. QPasswordLineEdit
QPager A classic pagination control for navigating large datasets. QPager
QColorButton A button that allows setting custom background colors for different states (Normal, Hover, Pressed, Checked). QColorButton
QColorToolButton A tool button that allows setting custom background colors for different states (Normal, Hover, Pressed, Checked).
QDualList Two lists side-by-side for moving items (Select/Deselect). QDualList
QSearchLineEdit A search input field with a clear button and search icon. QSearchLineEdit
QIconComboBox A ToolButton-style combo box optimized for icons or short text.
QEmojiPickerMenu A menu wrapper for QEmojiPicker to easily attach it to buttons.
QThemeResponsiveLabel A label that automatically updates its icon based on theme and size.

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