Skip to content

Latest commit

 

History

History
89 lines (58 loc) · 3.2 KB

CustomTheming.md

File metadata and controls

89 lines (58 loc) · 3.2 KB
Raw

Custom Theming with SAP Theme Designer

UI5 Web Components are fully compatible with SAP Theme Designer. You can create your own theme and effortlessly integrate it in your UI5 Web Components project on HTML level! On top, this does not prevent you from switching to and from officially supported themes, while having your own.

Follow this simple tutorial to get a custom theme running with UI5 Web Components in 5 minutes:

  1. Open SAP Theme Designer.

    Go to ui5.sap.com and select Tools -> UI Theme Designer from the menu, or just follow the direct link.

  2. Create your custom theme in SAP Theme Designer.

    • Click the Create a New Theme button.

    • Choose which SAP stock theme will serve as the base of your custom theme and click the Create Theme button in the footer of the dialog.

    • Proceed to change as many parameters as you wish.

    • Once you are done customizing, choose Theme -> Export from the main menu on top. A dialog will appear, asking for Theme ID (technical name of your new theme) and a title.

      The Theme ID you chose at this point will be the one you'll use in order to switch to your custom theme, for example if you chose mytheme:

      index.html?sap-ui-theme=mytheme

      Important: Before clicking the Export button, thus dismissing the dialog and finishing theme creation, it is mandatory that you expand the Optional Settings (for Experts) panel, and select the Source Files + CSS Resources option. Otherwise, no CSS Variables will be generated.

  3. Download the custom theme .zip file:

    Your browser will then download a .zip file with the name of your new theme, e.g. mytheme.zip.

  4. Copy the css_variables.css file with all CSS Variables for your custom theme to your project.

    You can find this file inside the .zip in the \Base\baseLib\<your theme name>\ directory.

    For example: mytheme.zip\Base\baseLib\mytheme\css_variables.css.

    Just copy this file to a directory in your project where it can be statically served.

  5. Include the file in your project's .html page:

    The simplest option would be to use a <link> tag and point to where you copied the file:

    <link rel="stylesheet" type="text/css" href="<path-to-your-css-file>/css_variables.css">

    but you could as well use a <style> tag and paste the content of css_variables.css inside, if that's what you prefer:

    <style>
	/* Here goes the content of css_variables.css */
</style>

And that's it! Now you can use your custom theme by setting it either in the URL of your page, or in your configuration script:

index.html?sap-ui-theme=mytheme

or

<script data-ui5-config type="application/json">
{
	"theme": "mytheme"
}
</script>

Note: Using a custom theme does not prevent you from using the official themes. You can freely switch to and from them.

import { setTheme } from "@ui5/webcomponents-base/dist/config/Theme.js";
setTheme("sap_fiori_3");
...
setTheme("mytheme");
...
setTheme("sap_fiori_3_dark");

For more on configuring themes, see Configuration.