kendo-theme-bootstrap/README.md

54 строки
3.0 KiB
Markdown
Исходник Обычный вид История

2017-05-03 17:57:33 +03:00
# Kendo UI Bootstrap Theme
2016-01-28 17:11:04 +03:00
The Kendo UI Bootstrap Theme is a theme for the Kendo UI components which is based on the Twitter Bootstrap framework, version 4. To style and size the components and make them blend in with the surrounding page, the Bootstrap theme uses the variables defined in Bootstrap.
2017-06-27 15:18:17 +03:00
* [License](#license)
* [Basic Usage](#basic-usage)
* [Running Custom Builds](#running-custom-builds)
* [Applying Mapped Variables](#applying-mapped-variables)
2017-05-03 17:57:33 +03:00
* [Troubleshooting](#troubleshooting)
2016-05-03 16:40:22 +03:00
2017-06-27 15:18:17 +03:00
## License
This package is part of the following suites:
* [Kendo UI for Angular](http://www.telerik.com/kendo-angular-ui/)
* [Kendo UI for jQuery](http://www.telerik.com/kendo-ui)
* [UI for ASP.NET MVC](http://www.telerik.com/aspnet-mvc)
* [UI for ASP.NET Core](http://www.telerik.com/aspnet-core-ui)
2016-01-28 17:11:04 +03:00
2017-06-27 15:18:17 +03:00
All available Kendo UI commercial licenses may be obtained at http://www.telerik.com/purchase/kendo-ui.
2016-01-28 17:11:04 +03:00
-If you do not own a commercial license, the usage of this software shall be governed by the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
2017-06-27 15:18:17 +03:00
## Basic Usage
2016-05-03 16:40:22 +03:00
For more information on how to implement the Material theme in your project, refer to the following articles:
2016-05-03 16:40:22 +03:00
* [Using the Bootstrap Theme in Angular Projects](http://gyoshevlnx:4000/components/styling/)
* [Using the Bootstrap Theme in jQuery Projects](http://docs.telerik.com/kendo-ui/styles-and-layout/sass-themes)
* [Customizing the Bootstrap Theme](https://github.com/telerik/kendo-theme-default/blob/13713a572b392806ca7c2950f77f9b033f87d8ea/README.md)
2017-05-03 17:57:33 +03:00
## Running Custom Builds
2016-05-03 16:40:22 +03:00
2017-05-03 17:57:33 +03:00
The handling of all variables happens in the [`_bootstrap-map.scss`](src/_bootstrap-map.scss) file. It loads the Bootstrap variables from the default location. For example, `node_modules/bootstrap/scss/_variables.scss`.
2016-05-03 16:40:22 +03:00
If you have a customized version of Bootstrap:
1. Specify the location in `_bootstrap-map.scss`.
1. Build as usual.
2017-05-03 17:57:33 +03:00
## Applying Mapped Variables
2016-05-03 16:40:22 +03:00
To ensure a certain level of compatibility, the Bootstrap variables are locally mapped. This also enables Kendo UI to use an ad-hoc micro framework based on primitive components. For example, [button](src/mixins/appearance/_button.scss), [input](src/mixins/appearance/_input.scss), [node](src/mixins/appearance/_node.scss), and so on.
2016-05-03 16:40:22 +03:00
However, some variables, such as `$tooltip-arrow-width` which is used in the tooltip, are not mapped. They are referenced explicitly because they do not fit in the previously mentioned framework.
2016-05-03 16:40:22 +03:00
## Troubleshooting
2016-05-03 16:40:22 +03:00
Because Bootstrap v4 is still in beta, its variables may change between releases. Make sure to use the Bootstrap version which is [specified in the peer dependencies](package.json) of the package.
*Copyright © 2017 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.*
*Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries.*