Skip to content

Widgets#

The widget docs now pull runnable examples directly from the repository and build screenshots from those same example files. That keeps the examples, images, and API notes aligned.

Browse by capability below, then open the individual pages for screenshots, runnable code, and API references.

Actions And Buttons#

  • QtPushButton (variants): theme-aware push buttons with activity and rich-text display helpers.
  • Qt Icon Buttons: a family of icon buttons for toggles, state indicators, and common toolbar actions.
  • QtPanelToolbar: a vertical toolbar that toggles stacked panels, with optional labelled buttons.
  • QtIconButtons: a family of icon buttons for toggles, state indicators, and common toolbar actions.
  • QtMiniToolbar: a dense icon-toolbar widget for compact utility actions.

Data Editors#

  • QtArrayTableView: high-volume array tables with sorting, lazy row loading, and optional colormap rendering.
  • QtDataFrameWidget: a dataframe viewer with synchronized headers and support for pandas and polars inputs.
  • QtDictTagEditor: editable key-value tables for small dictionaries with search and typed values.
  • QtDictTagViewer: a read-only searchable dictionary viewer for compact metadata tables.
  • QtMultiDictTagEditor: edit multiple named dictionaries together with an aggregate summary view.
  • QtMultiDictTagViewer: read-only multi-record dictionary viewing with a synchronized summary widget.

Disclosure And Layout#

  • QtCheckCollapsible: a superqt.QCollapsible variant with checkbox, action button, and warning state in the header.

Feedback And Teaching#

  • QtPopout: contextual popouts that point back to a target widget.
  • QtTutorial: guided tutorial overlays that walk the user through a sequence of widgets.

Labels And Display#

  • QReadMoreLessLabel: rich text that can stay compact by default and expand into a two-column explanation when needed.
  • QtQtaLabel (variants): theme-aware static and animated icon labels built on QtAwesome mappings.
  • QtScrollableLabel: scrollable rich text labels for longer explanations inside constrained layouts.

Progress And Status#

  • QtActiveOverlay: animated busy indicators for lightweight in-place activity feedback.
  • QtActiveProgressBarButton: a button that pairs a progress bar with inline activity and cancel affordances.
  • QtCountdownWidget: a label-and-bar countdown that notifies users of upcoming updates or scheduled changes.
  • QtFloatingProgressBar: a floating progress overlay that stays anchored to a window, dialog, or child widget.
  • QtNotificationBadge: attach count and dot badges to existing widgets without changing their layout.
  • QtOverlay: floating labels and message widgets anchored to another widget.
  • QtStepProgressBar: step-based progress visualization for multi-stage workflows.
  • QtSystemSummaryWidget: a compact system summary widget for application and runtime metadata.

Selection And Input#

  • Qt Search Comboboxes: search-first combobox variants for inline filtering and type-ahead selection.
  • QtColorSwatchComboBox: a combobox that presents a grid of named color swatches.
  • QtFilterEdit: filter-token entry widgets for building simple search and match expressions.
  • QtMultiSelectComboBox: a multi-select combobox that renders the current selection as inline chips.
  • QtSearchPanel: reusable search and replace panel for text editors and plain-text views.
  • QtTagEditor: a lightweight tag entry widget for adding, removing, and deduplicating short labels.
  • QtTagManager: interactive tag chips with filtering and add/remove affordances.
  • QtToggleGroup: compact grouped toggle buttons with exclusive and multi-select modes.