FAQ¶
Sliders not dragging properly on macOS 12+¶
With Qt 5 on macOS 12 (Monterey) and later, a bug in Qt makes all sliders, including Qt's own, respond badly to dragging (QTBUG-98093, and superqt#74). Qt 6 doesn't have this bug.
superqt includes a workaround: a style sheet for the sliders. It isn't perfect, and it replaces the sliders' styles (so it may interfere with your own; and if you already style your sliders, you may not see the bug). To use it, do one of the following:
- Set the environment variable
USE_MAC_SLIDER_PATCH=1before importing superqt. superqt's sliders then use the style sheet if they run with Qt 5 on macOS 12 or later (so it's safe to set on other platforms). This applies to all of them exceptQLabeledSlider, which contains a plainQSlider. - Call the
applyMacStylePatch()method of aQDoubleSlider,QRangeSlider, orQDoubleRangeSlider. This applies the style sheet whatever the platform, and replaces the slider's style sheet. -
Apply the style sheet yourself, to any slider: