官方网址： 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"

this.setData({

            show:true

    })