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.
Dependencies:
- Qt (>= 5.3)
- Boost (>= 1.54)
- CMake (>= 2.8.12)
Test dependencies:
Mac:
- Xcode v5.1 or higher
Windows:
- Visual Studio 2013
mkdir build
cd build
cmake ..
cmake --build .
The unit tests can be executed with ctest:
ctest -V
You might set the following variables:
- Boost_INCLUDE_DIR to the folder, where Boost headers are found
- GTEST_SOURCE to the folder of GoogleTest sources.
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 \
-DGTEST_SOURCE=~/Dev/googletest -DBoost_INCLUDE_DIR=/opt/local/include/
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 qml/ examples/TestApp.qml
While qmlscene is running you can change examples/style.css and watch the
application update.
Aqt StyleSheets is distributed under the MIT license (see LICENSE).