cube-ui 是滴滴公司的技术团队基于 Vue.js 实现的精致移动端组件库。很赞,虽然组件还不是很多,但是基本场景是够用了,感谢开源!
首先创建一个vue项目
vue init webpack my-project cd my-project npm install
安装cube-ui
npm install cube-ui -S
官方推荐使用 babel-plugin-transform-modules 插件,可以更优雅引入组件模块以及对应的样式。
npm install babel-plugin-transform-modules -D
然后配置下这个插件,修改 .babelrc:(添加到plugins中去)
{
"plugins": [
["transform-modules", {
"cube-ui": {
"transform": "cube-ui/lib/${member}",
"kebabCase": true,
"style": {
"ignore": ["create-api", "better-scroll"]
}
}
}]
]
}
引入方式1:全部引入
一般在入口文件main.js中:
import Vue from 'vue' import Cube from 'cube-ui' // 一般直接放在这个位置 Vue.use(Cube)
全部引入了后就相当于全局注册了,直接用就可以了。不需要在每个.vue文件中import { … }(局部引用),以及components{ … }局部注册了。
引入方式2:按需引入
import {
/* eslint-disable no-unused-vars */
Style, // 必需
Button
} from 'cube-ui'
注意: 按需引入的话,是不会打包基础样式部分的,所以在使用的时候需要引入 style 模块。
注册方式 可选全局注册也可以选择局部注册:
// 全局注册
Vue.use(Button) // 在入口文件中
// 或者局部注册
// 某个组件中
{
components: {
CubeButton: Button
}
}
所有的可按需引入的组件:
import {
Button,
Checkbox,
Loading,
Tip,
Toast,
Picker,
TimePicker,
Dialog,
ActionSheet,
Scroll,
Slide,
IndexList
} from 'cube-ui'
也可以引入create-api和better-scroll模块:
import { createAPI, BetterScroll } from 'cube-ui'
示例
<template>
<cube-button @click="showDiaog">show dialog<cube-button>
</template>
<script>
export default {
methods: {
showDialog() {
this.$createDialog({
type: 'alert',
title: 'Alert',
content: 'dialog content'
}).show()
}
}
}
</script>
不使用后编译
注意: cube-ui 搭配 webpack 2+ 默认就会使用后编译,但是后编译需要有一些依赖以及配置(参见本页最后);如果不想使用后编译的话,可以直接修改 webpack 配置即可:
