淺談基于Vue.js的移動(dòng)組件庫cube-ui

更新時(shí)間：2017年12月20日 11:56:36 作者：疾風(fēng)勁草ccy

這篇文章主要介紹了基于Vue.js的移動(dòng)組件庫cube-ui，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧

cube-ui 是滴滴公司的技術(shù)團(tuán)隊(duì)基于 Vue.js 實(shí)現(xiàn)的精致移動(dòng)端組件庫。很贊，雖然組件還不是很多，但是基本場(chǎng)景是夠用了，感謝開源！

首先創(chuàng)建一個(gè)vue項(xiàng)目

vue init webpack my-project
cd my-project
npm install

安裝cube-ui

npm install cube-ui -S

官方推薦使用 babel-plugin-transform-modules 插件，可以更優(yōu)雅引入組件模塊以及對(duì)應(yīng)的樣式。

npm install babel-plugin-transform-modules -D

然后配置下這個(gè)插件，修改 .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' // 一般直接放在這個(gè)位置
Vue.use(Cube)

全部引入了后就相當(dāng)于全局注冊(cè)了，直接用就可以了。不需要在每個(gè).vue文件中import { … }（局部引用），以及components{ … }局部注冊(cè)了。

引入方式2：按需引入

import {
 /* eslint-disable no-unused-vars */
 Style, // 必需
 Button
} from 'cube-ui'

注意：按需引入的話，是不會(huì)打包基礎(chǔ)樣式部分的，所以在使用的時(shí)候需要引入 style 模塊。

注冊(cè)方式 可選全局注冊(cè)也可以選擇局部注冊(cè)：

// 全局注冊(cè)
Vue.use(Button) // 在入口文件中
// 或者局部注冊(cè)
// 某個(gè)組件中
{
 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+ 默認(rèn)就會(huì)使用后編譯，但是后編譯需要有一些依賴以及配置（參見本頁最后）；如果不想使用后編譯的話，可以直接修改 webpack 配置即可：

// webpack.config.js
module.exports = {
 // ...
 resolve: {
 // ...
 alias: {
  // ...
  'cube-ui': 'cube-ui/lib'
  // ...
 }
 // ...
 }
 // ...
}

使用后編譯

cube-ui 搭配 webpack 2+ 后就會(huì)默認(rèn)使用后編譯，那么應(yīng)用就需要兼容 cube-ui 的依賴和配置。

1、修改 package.json

{
 // webpack-post-compile-plugin 依賴 compileDependencies
 "compileDependencies": ["cube-ui"],
 "devDependencies": {
 "babel-plugin-transform-modules": "^0.0.2",
 // 新增 stylus 相關(guān)依賴 (都需要額外安裝：npm install … -D)
 // stylus 類似于 sass,less
 "stylus": "^0.54.5",
 "stylus-loader": "^2.1.1",
 "webpack-post-compile-plugin": "^0.1.2"
 }
}

2、修改 .babelrc，依舊依賴babel-plugin-transform-modules：

"plugins": [
 ["transform-runtime"],
 ["transform-modules", {
 "cube-ui": {
  // 注意: 這里的路徑需要修改到 src/modules 下
  "transform": "./node_modules/cube-ui/src/modules/${member}",
  "kebabCase": true
 }
 }]
]

3、修改 webpack.base.conf.js

var PostCompilePlugin = require('webpack-post-compile-plugin')
module.exports = {
 // ...
 plugins: [
 // ...
 new PostCompilePlugin()
 ]
 // ...
}

4、修改 build/utils.js 中的 exports.cssLoaders 函數(shù)

exports.cssLoaders = function (options) {
 // ...
 const stylusOptions = {
 'resolve url': true
 }
 // https://vue-loader.vuejs.org/en/configurations/extract-css.html
 return {
 css: generateLoaders(),
 postcss: generateLoaders(),
 less: generateLoaders('less'),
 sass: generateLoaders('sass', { indentedSyntax: true }),
 scss: generateLoaders('sass'),
 stylus: generateLoaders('stylus', stylusOptions),
 styl: generateLoaders('stylus', stylusOptions)
 }
}

運(yùn)行看看成果：