小程序中使用npm包和组件库 Vant Weapp 的使用

1,195 阅读2分钟

「这是我参与2022首次更文挑战的第26天,活动详情查看:2022首次更文挑战

小程序对 npm 的支持与限制

目前,小程序中已经支持使用 npm 安装第三方包,从而来提高小程序的开发效率。但是,在小程序中使用 npm包有限制

  • 不支持依赖于 Node.js 内置库的包
  • 不支持依赖于浏览器内置对象的包
  • 不支持依赖于 C++ 插件的包

关于 Vant Weapp

Vant Weapp 是有赞前端团队开源的一套小程序UI组件库,助力开发者快速搭建小程序应用,它所使用的是 MIT 开源许可协议,对商业使用比较友好。

官方文档地址


安装 Vant 组件库

在小程序中,安装 Vant 组件库主要分为以下三步

  • 通过 npm 安装
  • 构建 npm 包
  • 修改 app.json

详细的操作步骤,可以参考 Vant 官方提供的快速上手教程


使用 Vant 组件库

安装完 Vant 组件库之后,可以在 app.jsonusingComponents 节点中引入需要的组件,即可在 wxml 中直接使用组件

  • 在 app.json 文件中
"usingComponents": {
  "van-button": "@vant/weapp/button/index"
}
  • 在 .wxml 文件中
<van-button type="primary">按钮</van-button>
  • 效果

    Snip20220210_1.png


Vant Weapp 定制全局主体样式

Vant Weapp 使用 CSS 变量来实现定制主题,在 app.wxss 中,写入 CSS 变量,即可对全局生效

page {
    /* 定制警告按钮的背景颜色和边框颜色 */
    --button-danger-background-color:pink;
    --button-danger-border-color:pink;
}
  • 为什么用 page 节点

    定义全局样式是有作用域的,小程序每个页面的根节点就是 page 节点,为了这些样式全局生效,所以在 page 节点定义

  • 如何拿到修改样式的变量名字

    vant-weapp 文档 中,定制主体的选项中选择样式变量中的配置文件,会进入 vant-weapp 的 github 中,在 .less 文件中定义了很多变量

    Snip20220212_1.png

    Snip20220212_2.png

  • 注:使用变量时需要将 .less 文件中的格式进行变化

    在 .less 文件中查看

    @button-danger-color: @white; 
    @button-danger-background-color: @red; 
    @button-danger-border-color: @red;
    

    app.wxss 文件中使用

    page {
        --button-danger-color:black;
        --button-danger-background-color:pink;
        --button-danger-border-color:pink;
    }