Skip to content

githubuser0xFFFF/Qt-Advanced-Stylesheets

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ukraine

logo


Advanced Stylesheets with Theming Support for Qt.

The library allows runtime color switching for CSS stylesheet themes including SVG resources and SVG icons. The image below shows switching of accent color and switching between dark and light theme. Notice how the icons in the left sidebar change color when switching between dark and light theme.

color_switching

The main features are:

  • runtime switching of CSS colors
  • runtime color switching of CSS SVG icons / resources
  • runtime color switching of icons loaded via loadThemeAwareSvgIcon()
  • runtime switching of QPalette colors
  • definition of CSS styles that switch the complete application design
  • definition of XML color themes that allow switching of theme colors (dark / light)
  • switching of individual theme color or switching of accent color
  • QML support

If you run the full_features example, then you can test the functionality. There are some custom dark themes:

dark

And light:

light

The library allows you to create stylesheets that contain variables that are replaced at runtime like in this example:

QComboBox:disabled {
  color: {{primaryColor|opacity(0.2)}};
  background-color: {{secondaryColor|opacity(0.75)}};
  border-bottom: 2px solid {{primaryColor|opacity(0.2)}};
}

QComboBox::drop-down {
  border: none;
  color: {{primaryColor}};
  width: 20px;
}

Navigation

Features

Theme-aware Icons

The library supports loading of theme-aware SVG icons.

AdvancedStylesheet.loadThemeAwareSvgIcon(":/app/images/progress.svg");

This allows runtime color switching of application icons like in the toolbar below.

Theme Aware Icon

Build

Open the acss.pro file with QtCreator and start the build, that's it. You can run the example projects and test it yourself.

Getting started

Have look into the file CMainWindow in the full_features example to learn ho to use the CStyleManager. Here are the basic steps to add the style manager to your application:

QString AppDir = qApp->applicationDirPath();
QtAdvancedStylesheet AdvancedStylesheet;

// first set the directory that contains all your styles
AdvancedStylesheet.setStylesDirPath(AppDir + "/../../styles");

// now set the output folder where the processed styles are stored. The
// style manager will create a sub directory for each style
AdvancedStylesheet.setOutputDirPath(AppDir + "/output");

// set the current style and select a theme. After these two calls, the output
// folder will contains the generated resoruces and stylesheet.
AdvancedStylesheet.setCurrentStyle("qt_material");
AdvancedStylesheet.setCurrentTheme("dark_teal");

// now you can set the generated stylesheet
qApp->setStyleSheet(StyleManager.styleSheet());

Run examples

The full_features example shows a window with almost all widgets to test all themes and create new ones.

theme

Future Plans

The idea is to merge my QtFluentDesign project into this project to create a nice Windows 11 style that can dynamically adapt to the Windows accent color and to the Window dark and light theme.

light

License information

License: LGPL v2.1 This project uses the LGPLv2.1 license for the source code. The stylesheets use individual licenses which are located in the directory of the corresponding style.

Credits

  • Uwe Kindler, Project Maintainer
  • GCPDS - Grupo de control y procesamiento digital de señales

The project is strongly inspired by the great Qt-material project from GCPDS and uses the qt-material stylesheet from this project.

Donation

If this project help you reduce time to develop or if you just like it, you can give me a cup of coffee ☕😉.

Donate with PayPal

Showcase

The CETONI Elements software from CETONI is a comprehensive, plugin-based and modular laboratory automation software for controlling CETONI devices using a joint graphical user interface. The software features a powerful script system to automate processes.

CETONI Elements Dark Theme CETONI_Elements Dark

CETONI Elements Light Theme CETONI_Elements Light