kendo-theme-bootstrap/README.md

1.8 KiB

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

  1. Run the npm install command to install the build dependencies.
  2. 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:

  1. Specify the location in _bootstrap-map.scss.
  2. 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.