Skip to content

Apply CSS style sheets to QML applications

License

Notifications You must be signed in to change notification settings

Ableton/aqt-stylesheets

Repository files navigation

Aqt StyleSheets

StylesSheets is a library for Qt/QML that allows you to apply CSS stylesheets to QML applications.

A singleton StyleEngine reads and parses a CSS file. QML components in your application can use the StyleSet attached object to request style properties. In doing so, the classname of the requesting object, its position in the component hierarchy, and its StyleSet.name info are used to build a selector path that is searched for in the CSS.

Decoupling application visual style from QML code allows designers and developers freedom to change the visual appearance of an application without breaking functionality, and allows for changing many similar QML components with fewer lines of code through selectors that apply across many components.

Requirements

Dependencies:

  • Qt (>= 5.3)
  • Boost (>= 1.54)
  • CMake (>= 2.8.12)

Mac:

  • Xcode v5.1 or higher

Windows:

  • Visual Studio 2015

Build and Test

  mkdir build
  cd build
  cmake ..
  cmake --build . --config Release
  cmake --build . --config Release --target install

The resulting plugin is then found inside build/lib/qml

The unit tests can be executed with ctest:

  ctest -V -C Release

You might set the following variables:

  • Boost_INCLUDE_DIR to the folder, where Boost headers are found

In case the CMake files shipped with Qt are not found, set the CMAKE_PREFIX_PATH to the Qt installation prefix. See the Qt5 CMake manual for more.

Example:

  cmake .. -DCMAKE_PREFIX_PATH=~/Qt/Qt5.3.1/clang_64 \
           -DBoost_INCLUDE_DIR=/opt/local/include/

Examples

In the examples folder there's an example app, showing how to use some of the feature of the StylePlugin. You can run the app with:

  qmlscene -I build/lib/qml examples/TestApp.qml

While qmlscene is running you can change examples/style.css and watch the application update.

Benchmarks

In the benchmarks folder there are benchmarks that can be run manually with:

qmltestrunner -import build/lib/qml -input benchmarks/benchmark_*.qml

Maintainers

License

Aqt StyleSheets is distributed under the MIT license (see LICENSE).

CI Status

Main: Build status Build Status