691596d207
Closes: telerik/kendo-theme-bootstrap#257 |
||
---|---|---|
build | ||
demo | ||
docs | ||
scss | ||
.gitignore | ||
.npmignore | ||
.sassdocrc | ||
.travis.yml | ||
CONTRIBUTING.md | ||
README.md | ||
package.json | ||
webpack.config.js |
README.md
Kendo UI Bootstrap Theme
Overview
The Kendo UI Bootstrap Theme is a theme for the Kendo UI components, based on version 4 of the Twitter Bootstrap framework.
It uses the variables defined in Bootstrap to style and size the components, so that they blend in with the surrounding page.
Currently, the Bootstrap theme is available for the following suites:
- Kendo UI for React.
- Kendo UI for Angular.
- Kendo UI for jQuery.
Installation
- Run the
npm install
command to install the build dependencies. - Run the
npm run build
command to build the CSS.
Custom Builds
The handling of all variables happens in the _bootstrap-map.scss
file. It loads the Bootstrap variables from the default location. For example, node_modules/bootstrap/scss/_variables.scss
.
If you have a customized version of Bootstrap:
- Specify the location in
_bootstrap-map.scss
. - Build as usual.
Troubleshooting
Since Bootstrap v4 is still in beta, its variables may change between releases. Make sure to use the version specified in the peer dependencies of the package.
Under the Hood
To ensure a certain level of compatibility, the Bootstrap variables are mapped locally. This also enables Kendo UI to use an ad-hoc micro framework based on primitive components. For example, button, input, node, and so on.
However, some variables, such as $tooltip-arrow-width
that is used in the tooltip, are not mapped. They are referenced explicitly because they do not fit within the previously mentioned framework.