原文地址:https://cloud.tencent.com/developer/doc/1273Mint-UI基于Vue.js的移动端组件库,它的使用方法类似于Element-UI。
目录
Mint UI 使用文档
npm 安装
CDN
Hello world
快速上手
使用 vue-cli
引入 Mint UI
完整引入
按需引入
开始使用
本文将介绍 Mint UI 的安装方式和基本的用法。
推荐使用 npm 的方式安装,它能更好地和 webpack 打包工具配合使用。
npm i mint-ui -S
目前可以通过 unpkg.com/mint-ui 获取到最新版本的资源,在页面上引入 js 和 css 文件即可开始使用。
通过 CDN 的方式我们可以很容易地使用 Mint UI 写出一个 Hello world 页面。
按钮
如果是通过 npm 安装,并希望配合 webpack 使用,请阅读下一节:快速开始。
关于事件绑定
在 Vue 2.0 中,为自定义组件绑定原生事件必须使用 .native
修饰符:
Click Me
从易用性的角度出发,我们对 Button
组件进行了处理,使它可以监听 click
事件:
Click Me
但是对于其他组件,还是需要添加 .native
修饰符。
本节将介绍如何在项目中使用 Mint UI。
npm install -g vue-cli vue init webpack projectname
你可以引入整个 Mint UI,或是根据需要仅引入部分组件。我们先介绍如何引入完整的 Mint UI。
在 main.js 中写入以下内容:
import Vue from 'vue' import MintUI from 'mint-ui' import 'mint-ui/lib/style.css' import App from './App.vue' Vue.use(MintUI) new Vue({ el: '#app', components: { App } })
以上代码便完成了 Mint UI 的引入。需要注意的是,样式文件需要单独引入。
借助 babel-plugin-component,我们可以只引入需要的组件,以达到减小项目体积的目的。
首先,安装 babel-plugin-component:
npm install babel-plugin-component -D
然后,将 .babelrc 修改为:
{ "presets": [ ["es2015", { "modules": false }] ], "plugins": [["component", [ { "libraryName": "mint-ui", "style": true } ]]] }
如果你只希望引入部分组件,比如 Button 和 Cell,那么需要在 main.js 中写入以下内容:
import Vue from 'vue' import { Button, Cell } from 'mint-ui' import App from './App.vue' Vue.component(Button.name, Button) Vue.component(Cell.name, Cell) /* 或写为 * Vue.use(Button) * Vue.use(Cell) */ new Vue({ el: '#app', components: { App } })
至此,一个基于 Vue 和 Mint UI 的开发环境已经搭建完毕,现在就可以编写代码了。启动开发模式:
npm run dev
编译:
npm run build
各个组件的使用方法请参阅它们各自的文档。