Dojo Framework Themes
Clone or download
Latest commit 2aa9476 Oct 30, 2018

README.md

Dojo Themes

Package that contains a collection of Dojo themes.

Please Note: If you are looking for Dojo 1 themes, these have been relocated to @dojo/dijit-themes. The github url registered with bower has also been updated to point to the new repository, if you encounter any issues please run bower cache clean and try again.

Usage

With Dojo applications

  1. Install @dojo/themes with npm i @dojo/themes.
  2. Import the theme CSS into your project's main.css: @import '@dojo/themes/dojo.
  3. Import the theme module and pass it to the widgets you need themed:
import theme from '@dojo/themes/dojo';

render() {
	return w(Button, { theme }, [ 'Hello World' ]);
}

With custom elements

  1. Install @dojo/themes with npm i @dojo/themes.
  2. Add the custom element-specific theme CSS to index.html: <link rel="stylesheet" href="node_modules/@dojo/themes/dojo/dojo-{version}.css">.
  3. Add the custom element-specific theme JS to index.html: <script src="node_modules/@dojo/themes/dojo/dojo-{version}.js"></script>.

Composition

To compose and extend the themes within a dojo project, run npm i @dojo/themes and use the css-module composes functionality. Variables can be used by using @import to import the variables.css file from a theme. This functionality is added by a post-css plugin within the dojo build command.

/* myButton.m.css */
@import '@dojo/themes/dojo/variables.css';

.root {
	composes: root from '@dojo/themes/dojo/button.m.css';
	background-color: var(--dojo-green);
}

Generating typings

The following npm scripts are available to facilitate development:

  • build:tcm: generate .m.css.d.ts files
  • watch: generate .m.css.d.ts files in watch mode