让前端飞vue生物信息学

10、手把手教 Vue--Mint UI 使用

2018-10-12  本文已影响204人  TigerChain
本节大纲

PS：转载请注明出处
作者: TigerChain
地址: https://www.jianshu.com/p/db776b507065
本文出自 TigerChain 简书 手把手教 Vue 系列

教程简介

正文

一、什么是 Mint UI

当我们一听到 XX UI 就可以知道它是一个界面相关的框架，玩过前端的人至少听说过 Bootstrap「它是 Twitter 开源的一个 css/html 工具包」, 而 Mint UI 是饿了么团队开源的一款基于 Vue.js 的移动端组件库

二、Mint UI 的使用方法

1、使用 cdn 的方式引入

我们在使用 Vue.js 的时候不一定非要使用 vue-cli 来创建一个单页面应用，很可能们使用别的技术栈来搭配 Vue.js「vue只是使用它的模版，减少恶心的动态拼串」，那么我们使用 cdn 直接引入的方式是最好不过了

引入方法

<!-- 引入样式 -->
<link rel="stylesheet" href="https://unpkg.com/mint-ui@1/lib/style.css">
<!-- 引入组件库 -->
<script src="https://unpkg.com/mint-ui@1/lib/index.js"></script>

当然我们也可以使用 yarn/npm/bower 等来安装 Mint UI 模块，然后在 html 界面中引入

这种方式其实没有什么好说的，就像我们在以前的 vue demo 中引入 vue.js 是一样的，废话不多说了，来两个例子直观感受一下吧

使用几个组件练练手

仿手机 webapp 淘宝登录界面

来张效果图看一下

手淘的登录界面 仿写手淘的登录界面

怎么样还原度还是挺高的吧，当然这个效果不使用 Mint UI 完全可以实现「实现难度也是非常低的，这里使用 Mint UI 实现此效果有点大材小用，只是为了演示效果」

<div id="mydiv">
    <!-- 提醒栏 -->
    <div class="tipslogin">
      <span>你需要登录才能继续仿问</span>
      <span class="closeSpan">关闭</span>
    </div>
    <div class="imgDiv">
      <img src="./imgs/tblogo.png" alt="" class="logo">
    </div>
    <!-- 操作区域 -->
    <div class="operateDiv">
      <!-- 账号 -->
      <mt-field  :placeholder="accountPlaceholder"  v-model="uname" class="myinput"></mt-field>
      <!-- 密码 -->
      <mt-field  v-show="isUserAccount" placeholder="请输入密码"  type="password" v-model="upass" class="myinput"></mt-field>
      <!-- 短信验证码 -->
      <mt-field  v-show="!isUserAccount" placeholder="校验码" v-model="getCode" class="myinput">
          <span class="getCode">获取短信验证码</span>
      </mt-field>
      <!-- 免费注册块 -->
      <div class="registerDiv">
        <span>免费注册</span>
        <span v-show="forgetPassShowroNot">忘记密码</span>
      </div>
      <!-- 登录和切换登录方式块 -->
      <div>
        <mt-button size="large" class="mybutton" @click.native="login">登录</mt-button>
        <mt-button size="large"  type="primary" class="mybutton" @click.native="changeLoginMethod">{{defaultAccountText}}</mt-button>
      </div>
    </div>
  </div>

这个没有什么好说的，完整的代码请看 https://github.com/githubchen001/vue-lesson/tree/master/08%E3%80%81Mint-UI%E7%9A%84%E4%BD%BF%E7%94%A8/usecdntaobaologin 注释非常清楚，不解释

2、在 Vue-cli 中使用 Mint UI

我们使用 vue-cli 来创建的组件化项目，其实也有三种引入 Mint UI 的方式

（1）、直接在 index.html 中引入，这个和上面的方式一样，不过有一些小区别，我们来感受一下

我们使用 vue-cli 来创建一个项目，过程就不演示了，以前说过，我们直接看核心代码

<html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1.0">
    <title>mint-ui-demo</title>
    <link rel="stylesheet" href="https://unpkg.com/mint-ui/lib/style.css">
  </head>
  <body>
    <!-- 先引入 Vue -->
    <script src="https://unpkg.com/vue@2.5.11/dist/vue.js"></script>
    <!-- built files will be auto injected -->
    <script src="https://unpkg.com/mint-ui/lib/index.js"></script>
    <div id="app"></div>
  </body>
</html>

方式一，配置 externals mint-ui

配置 mint-ui

我们在 webpack.base.conf.js 的 module.exports 中配置 externals，externals 是把组件公开出去，供全局使用

PS：在这里我们要注意一点 externals 配置的 key:vaule 形式的，这里的 Value 好多文章中说是随意配置的，但是亲过自己亲测，这里不能随便配置，必须要和相关 js 暴漏出来的模块名字一模一样，对于 mint-ui 来说是 MINT，我们可以看一下 mint-ui.js 的源码

mint-ui部分源码

看到了吧，mint-ui 暴露出去供我们使用的是 MINT，所以 externals 的 value 一定是这个值「不能随意配置」

import MINT from 'mint-ui'
Vue.use(MINT)

添加以上两句，引入 mint-ui ，并且使用它

经过以上三部，我们就使用 cdn 的方式把 mint-ui 配置完了，我们来测试一下

<template>
  <div id="app">
    <mt-button type="default">default</mt-button>
        <mt-button type="primary">primary</mt-button>
        <mt-button type="danger" >danger</mt-button>
    <router-view/>
  </div>
</template>
show-vue-cli-cdn-mint-ui

怎么样，完美的显示出了 mint-ui 的 Button 效果

方式二 配置 externals vue

关于 externals 可以看 webpack 官方说明：外部扩展，这里不细说了解一下即可，我们来看看如何在配置---配置方式如下

externals-config-vue

我们这时配置一下 Vue 并不配置 mint-ui

remove-use-mint show-vue-cli-cdn-mint-ui.png

怎么样，效果一毛一样，为什么呢？个人是这样理解的，mint-ui 是依赖于 vue 的，如果我们没有在 externals 配置 vue，只是配置了 mint-ui「这里 import MINT from 'mint-ui' 都是 cdn 上的全局都一样」 没有把 vue 当全局暴露出去，那么我们在每个界面 import Vue from 'vue' 其实是 vue-cli 把我们下载到 node-modules 中的 vue ,而在本地 vue 使用其它 组件的时候，一般情况下我们是要 import 和 Vue.use(xxx) 的「具体要看组件的 js 有没有提供这个方法」

但是如果我们在 externals 中配置了 vue ，相当于我们 import Vue from 'vue' 都是 cdn 上的「和本地 node-modules 中的 vue 没有关系，此时的 vue 和 mint 真正的都是 cdn 上的」，此时的情况就像在 html 中直使用 cdn 直接引入 vue 再引入 mint-ui 是一样的，所以我们不必在 externals 再去配置 mint-ui，效果也能实现「个人建议如果使用的话，使用第二种方案」

（2）、使用模块化全局引用

以上说了在 vue-cli 中使用 cdn 来使用 mint-ui 的两种方式，其实使用 cdn 来减小包的大小和优化速度是不错的一种选择，下在我们介绍第二种使用模块化全局引入 mint-ui

yarn-add-mint-ui

在这里我们要注意一下，样式文件需要单独引入

我们打开 main.js 输入以下内容「如图中红框所示」

import-mint-js-and-css

经过以上两步配置，我们就把 mint-ui 全局配置好了，我们在任何组件中就可以使用 mint-ui 了

我们就来几个按钮和 Navbar 的功能，废话不多说了直接看效果图

golbal-vue-cli

基本上就是这个效果，具体代码可以看源码 https://github.com/githubchen001/vue-lesson/tree/master/08%E3%80%81Mint-UI%E7%9A%84%E4%BD%BF%E7%94%A8/mint-ui-vue-cli-global-use-demo

（3）、使用模块化按需引用

在上面的例子，我们只使用了 button 和 Navbar 组件，但是我们却引入了整个 mint-ui 组件，这有多么大的浪费呀「简直是一种奢侈，大材小用」，能不能我们需要什么组件再引入什么组件，实现按需加载呢「以达到减少项目体积的目的」，当然可以了，我们来看看这种方式

当然我们要使用 mint-ui ，我们肯定要安装 mint-ui

yarn add mint-ui

yarn add install babel-plugin-component --dev
config-single-mint-ui-babelrc.png

我们来运行一下项目 yarn run dev 然后输入 localhost:8080 很不幸，报错了，我们看一下命令行中的错误如下，是我们要使用 ES6 的标准，却没有安装 babel-preset-es2015 ，废话不多说，我们安装一下即可

can't-find-es2015 
yarn add babel-preset-es2015 --dev

我们完成安装以后，再运行一下，就不会报上面的错误了

import-button-and-use

这样我们引入了 Button 并且全局注册了 Button 我们就可以在什何组件中使用 Button 了，官方说注册组件可以使用 Vue.component(Component.name, Component) 和 Vue.use(Component) 两种方式实现，但是亲测只有 Vue.component(Component.name, Component) 这种注册方式起作用而 Vue.use(Component) 是无效的「会报错，说组件没有正确的注册」

button-in-appvue show-single-button-result

怎么样除了我们熟悉的 vue-cli 帮我们创建的 HelloWorld 以外，我们看到了 mint-ui 创建的两个按钮「完美显示出来了」

PS: 这里注意一下，我们如果想要给 mt-button 这种自定义组件添加点击事件，不能使用传统的 @click 而要使用 @click.native

这样我们就把按需加载 mint-ui 中的组件配置完了，不过根据路由的思想，虽然我们可以把路由配置在 main.js 中，但是为了统一管理 vue-cli 帮我们把路由配置在单独的文件中--- router/index.js 中，仿照路由的配置，我们把 mint-ui 也单独配置在一个文件夹中「方便我们管理,当然这不是必须的，你完全可以在 main.js 中去一个个按需引入组件」，这里我们创建一个 mint-ui/index.js 文件「如下所示」

add-mint-ui-indexjs

我们把引入需要的 mint-ui 组件全部配置在 mint-ui/index.js 文件中

由于 mint-ui 是基于 vue 的，所以我们要先相入 vue ，这和 router 是一样的「这里以 Button 为例子来引入，其实就是把上面 main.js 是配置的放到 mint-ui/index.js 文件中」

# mint-ui/index.js

import Vue from 'vue'
import { Button } from 'mint-ui';
Vue.component(Button.name, Button);

由于我们把 main.js 中引入 Button 的工作放在了 mint-ui/index.js 中了，所以我们现在把原有的 main.js 中引入 Button 的方法就要去掉「替换成引入 mint-ui/index.js 即可」

# main.js
import Vue from 'vue'
import App from './App'
import router from './router'

// import { Button } from 'mint-ui';
// Vue.component(Button.name, Button);

import './mint-ui/index.js'
...
show-single-button-result

和上面在 main.js 中引入 Button 组件是一毛一样的，所以推荐大家在使用 mint-ui 的时候建议在一个单独文件中去引入

为了方便起见，我们把原来 App.Vue 中和 HelloWorld 组件中的内容干掉「template、style、js 都把内容清空」

我们在 HelloWorld 组件中分别引入 mint-ui 的 Button、Action sheet 等「需要什么我们看文档即可，文档非常的详细」

直接在 mint-ui/index.js 引入需要的组件即可

# mint-ui/index.js

import Vue from 'vue'
import { Button,Actionsheet } from 'mint-ui';

Vue.component(Button.name, Button);
Vue.component(Actionsheet.name, Actionsheet);

我们可以看到除了 Button，我们又引入了 Actionsheet「依次类推，想用什么组件就在这里引入并且注册即可」，我们来看看 Actionsheet 的用法

<mt-actionsheet
  :actions="actions"
  v-model="sheetVisible">
</mt-actionsheet>

actions 属性绑定一个由对象组成的数组，每个对象有 name 和 method 两个键，name 为菜单项的文本，method 为点击该菜单项的回调函数。sheetVisible 是组件默认是否显示，直接看代码「在 HelloWorld 中添加」

<template>
  <div class="hello">
    <mt-button type="primary" size="large">primary</mt-button>
    <mt-actionsheet
      :actions="actions"
      v-model="sheetVisible">
    </mt-actionsheet>
  </div>
</template>

<script>
export default {
  name: 'HelloWorld',
  data () {
    return {
      actions:[],
      // 设置为 true 默认就自动弹出 actionSheet
      sheetVisible:true
    }
  },
  created() {
    this.actions = [
      {name:'拍照'},
      {name:'打开相册'}
    ]
  }
}

没有什么好说的，和官方介绍的差不离，在这里 actions 中的 method 不是必须「但是实际情况是肯定是有的，不然 actionsheet 有个毛意义呢」

use-actionsheet-demo add-method-to-actionsheet

我们再给 Button 添加点击事件

<mt-button 
type="primary" 
size="large" 
@click.native="showActionSheet">
    primary
</mt-button>
show-actionsheet-result

还不错吧，这里基本就差不多了，其它的组件我们照着文档使用就可以了，没什么难的「文档非常的详细」

具体代码看：源代码

三、使用 mint-ui 仿微信界面

以上说我们说了 mint-ui 的三种引入方式，并且介绍了组件的使用，这没有什么好说的，需要什么组件看官网上有的话直接拿来用。学了就要使用，在这里我们使用 mint-ui 来仿一个微信的基本框架「使用 vue-cli + 按需加载 mint-ui 组件的方式」，所谓无图无真相，我们来看一下效果图吧

效果图

we-chat-demo.gif

大概说一下我是如何拆分组件的，具体可以看源码，注释非常清楚

wecaht-component-01

其它类似发现，我的中的条目都是通用的组件「就不一一列举了」，这个 Demo 中的组件抽到的粒度还不是最细的，大家可以自行再封装组件

源码地址： https://github.com/githubchen001/vue-lesson/tree/master/08%E3%80%81Mint-UI%E7%9A%84%E4%BD%BF%E7%94%A8/mint-ui-wechat-demo

四、总结

本节我们说了 mint-ui 的使用，其实不管什么组件都是类似的使用方式，还是非常 easy 的，大概总结一下

1、在 vue-cli 中使用 mint-ui 有三种方式

2、使用 mint-ui 仿微信

本节所有 demo 演示地址：https://githubchen001.github.io/vue-lesson/08%E3%80%81Mint-UI%E7%9A%84%E4%BD%BF%E7%94%A8/index.html

更多文章关注：手把手教Vue系列

点赞富一生「你一点赞我就更来劲了」，转发富五代，更多文章请关注我的微信公号来查阅

公众号：TigerChain

上一篇下一篇

猜你喜欢

热点阅读