在vue中使用Mint-ui

一、什么是 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 淘宝登录界面

来张效果图看一下

手淘 webapp 登录界面


手淘的登录界面

使用 Mint UI 仿写的手淘 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-fieldv-show="isUserAccount" placeholder="请输入密码" type="password" v-model="upass" class="myinput">

</mt-field>

<!-- 短信验证码 -->

<mt-fieldv-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 来创建一个项目,过程就不演示了,以前说过,我们直接看核心代码

1、在 index.html 中使用 cdn 引入 mint-ui 相关的 css 和 js

<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 -->

<scrip tsrc="https://unpkg.com/mint-ui/lib/index.js"></script>

<div id="app"></div>

</body>

</html>

方式一,配置 externals mint-ui

2、配置 webpack.base.conf.js,添加如下代码


配置 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 一定是这个值「不能随意配置」

3、修改 main.js

import MINT from'mint-ui'

Vue.use(MINT)

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

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

4、在 App.vue 中的模版中添加以下代码

<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>

5、运行查看结果


show-vue-cli-cdn-mint-ui

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

方式二 配置 externals vue

除了以上方式,我们还可以在 externals 中直接配置 vue 不用配置 mint-ui ,

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


externals-config-vue

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

同时去掉 main.js 中的 import 和 Vue.use(MINT)


remove-use-mint

由于我们修改了 webpack.base.conf.js 所以一定要重新启动服务,果看结果


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

1、首先我们要使用一模块我们就要安装它「cdn 除外」,使用 yarn/npm 来安装,这里使用 yarn「好处以前在 React 中说过了,这里不过多了说」


yarn-add-mint-ui

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

2、使用 mint-ui

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


import-mint-js-and-css

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

3、测试一下

我们就来几个按钮和 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 组件,这有多么大的浪费呀「简直是一种奢侈,大材小用」,能不能我们需要什么组件再引入什么组件,实现按需加载呢「以达到减少项目体积的目的」,当然可以了,我们来看看这种方式

1、使用 vue-cli 来创建一个名为 mint-ui-cli-single-import-demo 的项目

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

yarn add mint-ui

2、要实现按需加载 mint-ui 组件,我们需要借助 babel-plugin-component 组件来只引入需要组件,我们来安装一下 babel-plugin-component

yarn add install babel-plugin-component --dev

3、配置 .babelrc


config-single-mint-ui-babelrc.png

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


can't-find-es2015

4、安装 babel-preset-es2015

yarnadd babel-preset-es2015 --dev

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

5、我们来引入按钮来测试一下,我们在 main.js 引入 Button 组件


import-button-and-use

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

6、使用 Button 组件,我们直接在 App.vue 组件中使用 Button


button-in-appvue

7、运行一把,查看结果


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 文件中

8、配置 mint-ui/index.js 文件

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

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

9、修改 main.js

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

# main.jsimportVuefrom'vue'importAppfrom'./App'importrouterfrom'./router'//import{ Button }from'mint-ui';// Vue.component(Button.name, Button);import'./mint-ui/index.js'...

10、查看结果


show-single-button-result

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

11、我们再来几个组件试试

为了方便起见,我们把原来 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 默认就自动弹出

               actionSheetsheetVisible:true

}

  }, 

created() {

            this.actions = [   

                         {name:'拍照'}, 

                           {name:'打开相册'}

                                  ] 

                    }

}

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

12、运行一下,查看结果


use-actionsheet-demo

13、我们来实现,点击按钮显示 actionsheet 并且每个 actionsheet 中的菜单有对应的方法


add-method-to-actionsheet

我们再给 Button 添加点击事件

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

14、运行一把看结果


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 有三种方式

使用 cdn 引入,注意配置 webpack.base.conf.js

全局使用,包会非常大,效率当然不是很高

按需使用--推荐使用「建议我们把使用三方组件单独配置到一个文件中,这里注意官方说单个组件可以使用 Vue.use(xxx),亲测不可以「看了源码,确实没有实现 install 方法」,我们只能使用 Vue.component(Component.name,Component) 这种方式」

2、使用 mint-ui 仿微信

使用了组件化开发,父子组件之间的传数据,方法等

使用到了 mint-ui 的 tabs 组件,index-list 等组件


打个广告,本人博客地址是:风吟个人博客

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,670评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,928评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,926评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,238评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,112评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,138评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,545评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,232评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,496评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,596评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,369评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,226评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,600评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,906评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,185评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,516评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,721评论 2 335

推荐阅读更多精彩内容

  • PS:转载请注明出处作者: TigerChain地址: https://www.jianshu.com/p/db7...
    TigerChain阅读 64,391评论 5 81
  • 基于Vue的一些资料 内容 UI组件 开发框架 实用库 服务端 辅助工具 应用实例 Demo示例 element★...
    尝了又尝阅读 1,137评论 0 1
  • 第一节 vue:读音: v-u-eview vue和angular区别?vue——简单、易学指令以 v-xxx一片...
    黑色的五叶草阅读 1,105评论 0 1
  • UI组件 element- 饿了么出品的Vue2的web UI工具套件 Vux- 基于Vue和WeUI的组件库 m...
    王喂马_阅读 6,430评论 1 77
  • UI组件 element- 饿了么出品的Vue2的web UI工具套件 Vux- 基于Vue和WeUI的组件库 m...
    你猜_3214阅读 11,004评论 0 118