Vant Weapp 小程序

官方网址： Vant Weapp（详细使用方法）

使用第三方组件方法：

步骤一：通过npm安装

#通过 npm 安装
npm i @vant/weapp -S --production

步骤二：修改 app.json

将 app.json 中的 "style": "v2" 去除，小程序的新版基础组件强行加上了许多样式，难以覆盖，不关闭将造成部分组件样式混乱。

步骤三：修改 project.config.json

开发者工具创建的项目，miniprogramRoot 默认为 miniprogram，package.json 在其外部，npm 构建无法正常工作。

需要手动在 project.config.json 内添加如下配置，使开发者工具可以正确索引到 npm 依赖的位置。

{
...
     "setting": {
             ...
             "packNpmManually": true,
             "packNpmRelationList": [
                 {

                // 修改部分
             "packageJsonPath": "./package.json",
             "miniprogramNpmDistDir": "./miniprogram/" //新版本 ./ 即可
}
             ]
     }
}

步骤四：构建 npm 包

工具 --- 构建npm ---- 勾选npm模块

在 app.json 或 index.json 中引入组件，详细介绍见快速上手。

"usingComponents": {

"van-button": "@vant/weapp/button/index"

}

按钮

按钮类型

支持default、primary、info、warning、danger五种类型，默认为default。

格式：

<van-button type="default">默认按钮</van-button>

朴素按钮

通过plain属性将按钮设置为朴素按钮

<van-button plain type="primary">朴素按钮</van-button>

细边框

设置hairline属性可以开启 0.5px 边框，基于伪类实现。

<van-button plain hairline type="info">细边框按钮</van-button>

禁用状态

通过disabled属性来禁用按钮，此时按钮的bind:click事件不会触发。

<van-button disabled type="primary">禁用状态</van-button>

加载状态

通过loading属性来设置加载按钮 loading-type="spinner" loading-text="加载中..."

<van-button loading type="primary" />

图标按钮

通过icon属性设置按钮图标，支持 Icon 组件里的所有图标，也可以传入图标 URL。

Field 输入框

属性：

label 输入框左侧文本

type 可设置为任意原生类型, 如 number idcard textarea digit

readonly 是否只读

custom-style 自定义样式

autosize 是否自适应内容高度，只对 textarea 有效，可传入对象,如 { maxHeight: 100, minHeight: 50 }，单位为px

Popup 弹出层

<van-popup show="{{ show }}" bind:close="onClose">内容</van-popup>

属性：

show :是否显示

onClose 点击其他位置，关闭弹出层

显示弹出层 (bindtap)

showPopup() {

this.setData({ show: true });

关闭弹出层

onClose() {

this.setData({ show: false });

弹出位置

position 可以设置为top、bottom、left、right。

Picker 选择器

Picker 选择器需要配合弹出层使用

<van-picker columns="{{ columns }}" bind:change="onChange" />

columns 对象数组，配置每一列显示的数据

onChange（e）有默认参数 e

value-key 选项对象中，文字对应的 key 通常用于对象数组

show-toolbar 是否显示顶部栏

defaultIndex 初始选中项的索引，默认为 0 不是双向绑定需要自己改变defaultIndex 的值需要渲染两次

展示顶部栏

取消选择

bind:cancel="onCancel"

this.setData({

show:false

})

确认选择

bind:confirm="onConfirm"