This is a style for Qt Quick Controls (also known as QQC2 in Qt5) which implements the KDE Visual Design Group's vision for Breeze in pure Qt Quick and Kirigami.
This library has no public API, applications should not (and cannot) use it directly. Instead, developers should add this library as a dependency of their apps.
The name of the style is org.kde.breeze
.
On Plasma Mobile, this style should be used automatically. Ensure that your application does not override the style by accident by checking if QT_QUICK_CONTROLS_STYLE
is set:
#include <QQuickStyle>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
// Default to org.kde.desktop style unless the user forces another style
if (qEnvironmentVariableIsEmpty("QT_QUICK_CONTROLS_STYLE")) {
QQuickStyle::setStyle(QStringLiteral("org.kde.desktop"));
}
QQmlApplicationEngine engine;
...
}
Unlike QQC2 Desktop Style, it does not depend on Qt Widgets and the system QStyle. This means you can use the lighter QGuiApplication
instead of QApplication
, and your application does not need to link to QtWidgets.
The performance, loading times and RAM usage should be generally competitive with the Qt Fusion and Material QQC styles.
The easiest way to make changes and test QQC2 Breeze Style during development is to build it with kdesrc-build.
Like other projects in the KDE ecosystem, contributions are welcome from all. This repository is managed in KDE Invent, our GitLab instance.
- Want to contribute code? See the GitLab wiki page for a tutorial on how to send a merge request.
- Reporting a bug? Please submit it on the Issues page.
If you get stuck or need help with anything at all, head over to the KDE New Contributors room on Matrix. For questions about QQC2 Desktop Style, please ask in the KDE Development room. See Matrix for more details.