## Introduction
**uiv** is a Bootstrap 3 component lib implemented by Vue 2.
* **Lightweight**
* All components **~20KB** Gziped.
* Dependencies only **Vue & Bootstrap CSS**.
* No extra CSS.
* Individually import supported.
* IE 9+ & modern browsers supported.
* **SSR** (server-side rendering) supported.
* All env supported:
* UMD build `uiv.min.js` can be used in all environments (including browser)
* ES Module build `uiv.esm.js` is for modern bundlers like [webpack 2](https://webpack.js.org) or [rollup](https://rollupjs.org)
* CommonJS build `uiv.common.js` is for older bundlers like [browserify](http://browserify.org) or [webpack 1](https://webpack.github.io).
## Documentation
To check out live examples and docs, visit [https://uiv.wxsm.space](https://uiv.wxsm.space).
## Install
If you are using module bundlers such as Webpack, you can directly include package into your project via:
**NPM**:
```bash
$ npm install uiv --save
```
or **Yarn**:
```bash
$ yarn add uiv
```
Then register uiv components and directives all at once in your app's entry:
```javascript
// main.js
import 'bootstrap/dist/css/bootstrap.min.css'
import Vue from 'vue'
import * as uiv from 'uiv'
Vue.use(uiv)
```
That's it. Happy coding!
### No Conflict
All components & directives will be installed with no prefix by default, you can add any prefix to them to avoid conflicts with other libs if needed.
For example:
```javascript
Vue.use(uiv, {prefix: 'uiv'})
```
Results in:
* Components such as `` becomes ``
* Directives such as `v-tooltip` becomes `v-uiv-tooltip`
* Global methods such as `$alert` becomes `$uiv_alert`
## Import Individually
If you don't want all of the components for some reason (e.g. to save the bundle size), you can also import them individually.
### Example
```javascript
import { Alert } from 'uiv'
new Vue({
components: {
Alert
}
})
```
## Browsers
You can load & install uiv package directly in browsers. For example:
```html
```
This will simply load the latest version of `uiv.min.js` into your page. For detail usages (e.g. load specify version, IMPORTANT in production mode) and different CDN providers, you can visit:
* [https://unpkg.com](https://unpkg.com)
* [https://www.jsdelivr.com](https://www.jsdelivr.com/)
* [https://cdnjs.com/libraries/uiv](https://cdnjs.com/libraries/uiv)
### Complete Usage Example
```html
Tab content 1.Tab content 2.
```
This will create a working **Tabs** component on your page.
## Browser Compatibility
All browsers supported by [Vue 2](https://github.com/vuejs/vue) and [Bootstrap 3 CSS](https://github.com/twbs/bootstrap) are suppose to be also supported by this lib (IE8 and below are not supported).
## Changelog
Detailed changes for each release are documented in the [release notes](https://github.com/wxsms/uiv/releases).
## Contribute
[](https://github.com/standard/standard)
Welcome and thanks to use and contribute to this project. Your support is very important.
If you found any problem / bug during the use of uiv, or have any suggustion that can make this lib better, please [create an issue](https://github.com/wxsms/uiv/issues/new).
Pull requests are also welcome! However, before you started working on a PR, it is highly recommend to **create an issue with your idea first**, so people can know what's going to happen and avoid duplicated work.
## Build Setup
```bash
# install dependencies
npm install
# serve demos & docs with hot reload at localhost:8080
npm run dev
# build dist
npm run dist
# build document
npm run build
# run all tests
npm test
```
## Contributors
This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].
## Backers
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/uiv#backer)]
## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/uiv#sponsor)]
## License
MIT
## Backers
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/uiv#backer)]
## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/uiv#sponsor)]
## License
MIT