Html5踩坑记之mandMobile使用小记


Posted in HTML / CSS onApril 02, 2020

Mand Mobile使用小记

mandMobile是滴滴开源的专门面向金融场景的Vue移动端UI组件库(非金融类也可以用),最近我司正在孵化一个金融类产品,本人准备使用。

对初次使用者来说,按照官方文档 来,多少会踩一些坑或者不顺畅,下面是我初次使用之后的总结。另外,本小记也会持续更新,记录使用中的各种问题。如果各位在使用中也遇到了问题,欢迎留言交流,我们一起提bug:smile:哈哈哈。

1. 首先安装

npm i mand-mobile -S

2. 引入

全局引入

如果使用  import { Button } from 'mand-mobile'; 的写法会引入 mand-mobile 下所有的模块.

为了提高提升打包和浏览器下载速度,推荐使用 按需引入

你可以通过以下方式按需引入

import Button from 'mand-mobile/lib/button'
import 'mand-mobile/lib/mand-mobile.css'  // 样式单独引入

这样可以将组件按需引入,但是样式还是全部引入。

更好的方法是使用 插件 babel-plugin-import

安装插件 cnpm i babel-plugin-import --save-dev
使用插件,添加babel.config.js或者.babelrc.js文件,添加以下配置

module.exports = {
    "plugins": [
        ["import", {
          "libraryName": "mand-mobile",
          "libraryDirectory": "lib",
          "style": true              // 文档说无需配置style,可能是默认值为true吧
        }]
    ]
 };

配置之后,你可以直接在项目中这样使用了: import { Button } from 'mand-mobile';

这样组件和样式都是按需引入了,而且相对来说少写了几行代码,如果引入的组件多的情况下配置一下还是比较有用的。

3. 配置postcss.config.js或者.postcssrc.js

module.exports = {
  plugins: [
    require('postcss-pxtorem')({
      rootValue: 75,    // 结果为:设计稿元素尺寸/75
      minPixelValue: 2,  // 小于等于 2 的元素不做处理
      propWhiteList: []
    })
  ]
}

如果想要忽略单个属性不做转化,最简单的方法是在像素单元声明中使用大写PX,例如有些字体不需要转换。至此,项目接入该UI库完成。

4. 如何定制主题

我们有两种方式定制主题:一种是css样式覆盖,一种是样式变量覆盖

第一种方式是我们自己写一套样式主题,然后全局引入,强行覆盖掉原来的样式,稍微有点不太优雅,但是也没什么不可以的。

第二种是文档上介绍的,即覆盖样式变量 ,这种方式需要我们做一些配置:

首先修改 babel.config.js,将libraryDirectory的值改为 "components",components这个文件夹存放的是所有组件。改完之后重新运行,这时候你会发现你的样式都没有了,原因是 components中少了一些东西,可以跟lib文件夹对比一下,例如下图所示是lib文件夹下的而components没有这些,如果这时你加上  import 'mand-mobile/lib/mand-mobile.css'; 样式就可以出现了,但是不能加上它,因为我们要通过覆盖样式变量的方式来定制主题。   

Html5踩坑记之mandMobile使用小记

如何覆盖呢?其实components中的组件是有样式的,只不过这些样式的值都是样式变量,而组件内部并没有引入变量,比如看下Button的源码,它的其中一些样式是这样的

.md-button
  position relative
  display block
  height button-height   // 样式变量
  line-height button-height  // 样式变量
  font-size button-font-size  // 样式变量
  font-weight button-font-weight  // 样式变量
  font-family font-family-normal
  text-align center
  border none
  border-radius button-radius  // 样式变量
  box-sizing border-box

所以我们只需要引入这些变量,样式就可以正常显示了,然后我们通过覆盖这些变量的值就可以改变主题了。关键是我们要如何引入这些变量。

根据文档,首先我们新建自定义主题文件,如 theme.custom.styl, 然后在这里引入样式变量

@import '~mand-mobile/components/_style/mixin/util'
@import '~mand-mobile/components/_style/mixin/theme.components'
@import '~mand-mobile/components/_style/mixin/theme.basic'

// 安装并引入css拓展nib(可选)
@import '~nib/lib/nib/vendor'
@import '~nib/lib/nib/gradients'

引入之后还需配置一下webpack让它在我们的项目中生效,我是用的是vue-cli3,所以在vue.config.js中做如下配置:

module.exports = {
  css: {
    loaderOptions: {
      stylus: {
        import: [resolve(`.src/assets/theme.custom`)]  // 根据你项目的实际情况配置路径
      }
    }
  }
}

这个时候基本上就可以了,但是还有一个样式文件需要引入,就是全局样式,因为是在component文件夹,so这个样式也要我们单独引入进来,在你的入口文件(mian.is)加入以下代码即可

import 'mand-mobile/components/_style/global.styl'

参考

全局样式变量   和 组件样式变量 ,在  theme.custom.styl  中设置这些值,就可以自定义主题了。

5. 项目开始

如果有些属性没有生效,看看是不是UI库版本太低了

6. 小结

其实,总体而言,mandMobile还是相当贴心的,提供的组件也很丰富且灵活,相信它在金融类产品中使用它还是很香的,推荐大家使用,毕竟金融类产品的业务逻辑还是比较复杂的。

 到此这篇关于Html5踩坑记之mandMobile使用小记的文章就介绍到这了,更多相关Html5使用mandMobile内容请搜索三水点靠木以前的文章或继续浏览下面的相关文章,希望大家以后多多支持三水点靠木!

HTML / CSS 相关文章推荐
css3选择器基本介绍
Dec 15 HTML / CSS
css3的focus-within选择器的使用
May 11 HTML / CSS
HTML5网页录音和上传到服务器支持PC、Android,支持IOS微信功能
Apr 26 HTML / CSS
canvas画布实现手写签名效果的示例代码
Apr 23 HTML / CSS
HTML5 声明兼容IE的写法
May 16 HTML / CSS
HTML5中5个简单实用的API(第二篇,含全屏、可见性、拍照、预加载、电池状态)
May 07 HTML / CSS
利用Storage Event实现页面间通信的示例代码
Jul 26 HTML / CSS
Html5 滚动穿透的方法
May 13 HTML / CSS
吃透移动端 Html5 响应式布局
Dec 16 HTML / CSS
H5 video poster属性设置视频封面的方法
May 25 HTML / CSS
详解如何解决H5开发使用wx.hideMenuItems无效果不生效
Jan 20 HTML / CSS
MIME类型中application/xml与text/xml的区别介绍
Jan 18 HTML / CSS
总结html5自定义属性有哪些
Apr 01 #HTML / CSS
详解canvas.toDataURL()报错的解决方案全都在这了
Mar 31 #HTML / CSS
浅谈Html5页面打开app的一些思考
Mar 30 #HTML / CSS
详解HTML5常用的语义化标签
Sep 27 #HTML / CSS
html5 移动端视频video的android兼容(去除播放控件、全屏)
Mar 26 #HTML / CSS
HTML5 Canvas实现放大镜效果示例
Mar 25 #HTML / CSS
HTML5 图片预加载的示例代码
Mar 25 #HTML / CSS
You might like
天使彦史上最神还原,性别曝光的那一刻,百万网友恋爱了
2020/03/02 国漫
星际争霸任务指南——人族
2020/03/04 星际争霸
php笔记之:初探PHPcms模块开发介绍
2013/04/26 PHP
详解PHP+AJAX无刷新分页实现方法
2015/11/03 PHP
JS获取页面窗口大小的代码解读
2011/12/01 Javascript
jquery插件lazyload.js延迟加载图片的使用方法
2014/02/19 Javascript
AngularJS利用Controller完成URL跳转
2016/08/09 Javascript
详解js中Json的语法与格式
2016/11/22 Javascript
基于JS设计12306登录页面
2016/12/28 Javascript
JavaScript中的一些隐式转换和总结(推荐)
2017/12/22 Javascript
Vue数据监听方法watch的使用
2018/03/28 Javascript
详解如何用babel转换es6的class语法
2018/04/03 Javascript
2种在vue项目中使用百度地图的简单方法
2018/09/28 Javascript
微信小程序自定义tabBar在uni-app的适配详解
2019/09/30 Javascript
在vue中使用jsx语法的使用方法
2019/09/30 Javascript
小程序api实现promise封装过程解析
2019/11/21 Javascript
vue组件内部引入外部js文件的方法
2020/01/18 Javascript
vue实现点击出现操作弹出框的示例
2020/11/05 Javascript
python实现数据图表
2017/07/29 Python
对Python 文件夹遍历和文件查找的实例讲解
2018/04/26 Python
Python3实现的爬虫爬取数据并存入mysql数据库操作示例
2018/06/06 Python
使用django-guardian实现django-admin的行级权限控制的方法
2018/10/30 Python
详解Python_shutil模块
2019/03/15 Python
tensorflow 重置/清除计算图的实现
2020/01/19 Python
浅谈python多线程和多线程变量共享问题介绍
2020/04/17 Python
Python+pyftpdlib实现局域网文件互传
2020/08/24 Python
Python 实现微信自动回复的方法
2020/09/11 Python
Django前后端分离csrf token获取方式
2020/12/25 Python
CSS3中的元素过渡属性transition示例详解
2016/11/30 HTML / CSS
自荐信格式的六要素
2013/09/21 职场文书
致跳远运动员广播稿
2014/02/11 职场文书
专家推荐信怎么写
2015/03/25 职场文书
2016年社区文体活动总结
2016/04/06 职场文书
2019开业庆典剪彩仪式主持词!
2019/07/22 职场文书
vue中控制mock在开发环境使用,在生产环境禁用方式
2022/04/06 Vue.js
Python使用Opencv打开笔记本电脑摄像头报错解问题及解决
2022/06/21 Python