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.
- Qt (>= 5.3)
- Boost (>= 1.54)
- CMake (>= 2.8.12)
- Xcode v5.1 or higher
- 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
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.
cmake .. -DCMAKE_PREFIX_PATH=~/Qt/Qt5.3.1/clang_64 \ -DBoost_INCLUDE_DIR=/opt/local/include/
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
benchmarks folder there are benchmarks that can be run manually with:
qmltestrunner -import build/lib/qml -input benchmarks/benchmark_*.qml
Aqt StyleSheets is distributed under the MIT license (see LICENSE).