Documentation:Theme as data: Difference between revisions

Theme as data

Latest revision as of 05:11, 3 February 2025

This page was created by Hans.karlsen@mdriven.net on 2020-06-24. Last edited by Stephanie@mdriven.net on 2025-02-03.

MDriven Turnkey has now added support to keep your theme and CSS as data within your app.

Having the CSS rules as data within the app rather than as a file on the server opens up other possibilities to react to other data. It makes it possible to change between multiple sets of CSS rules (themes) in runtime.

The pattern for Turnkey to discover for applying data as CSS is this:

SysSingleton.oclsingleton.PickedThemeData , and the object found must ha Name:string and DerivedCSS:string

An example model to add both this model section plus a UI to set CSS theming variables is found here: Theme Builder

Basic Example

This example sets the background of the navigation bar.

Good to know

The corresponding rule in tkusercss.css file will override your value if set.
You will probably have to touch your web.config, restart your Turnkey site and reload your page when testing.

To identify what theme variables will have effect in Turnkey - check names used in StylesInModel dialog:

See SysSingleton.MiscSetting to see how to trigger a generation of the CSS in runtime.

@@ Line 1: / Line 1: @@
-MDriven Turnkey now has added support for keeping your theme and css as data within your app.
+<message>Write the content here to display this box</message>
+MDriven Turnkey has now added support to keep your theme and CSS as data within your app.
-To have the CSS rules as data within the app rather than as a file on the server opens up other possibilities to react to other data and possibly change between multiple sets of css rules (themes) in runtime.
+Having the CSS rules as data within the app rather than as a file on the server opens up other possibilities to react to other data. It makes it possible to change between multiple sets of CSS rules (themes) in runtime.
 The pattern for Turnkey to discover for applying data as CSS is this:
   SysSingleton.oclsingleton.PickedThemeData , and the object found must ha Name:string and DerivedCSS:string
-An example model to both add this model section plus a UI to set CSS theming variables is found here: [[Model Examples|Theme Builder]]
+An example model to add both this model section plus a UI to set CSS theming variables is found here: [[Documentation:Model Examples|Theme Builder]]
+=== Basic Example ===
+This example sets the background of the navigation bar.
+[[File:ThemeDataWithLink.PNG]]
+[[File:DerivationOcl.PNG]]
+=== Good to know ===
+* The corresponding rule in tkusercss.css file will override your value if set.
+* You will probably have to touch your web.config, restart your Turnkey site and reload your page when testing.
+To identify what theme variables will have effect in Turnkey - check names used in StylesInModel dialog:
+[[File:Documentation Theme as data 1723709327369.png|none|thumb|552x552px]]
+[[Category:MDriven Turnkey]]
+See [[Documentation:SysSingleton.MiscSetting|SysSingleton.MiscSetting]] to see how to trigger a generation of the CSS in runtime.
+{{Edited|July|12|2025}}