步骤一：初始化一个包的描述文件
注意：小程序的包名不能是中文，当文件名是中文时不能使用-y， 则使用npm init 回车后自己手动输入包名。
步骤二：安装Vant
通过 npm 安装 npm i @vant/weapp -S --production
通过 yarn 安装 yarn add @vant/weapp --production
安装 0.x 版本 npm i vant-weapp -S --production
步骤三：修改 app.json
将 app.json 中的 "style": "v2" 去除，小程序的新版基础组件强行加上了许多样式，难以覆盖，不关闭将造成部分组件样式混乱。
步骤四：修改 project.config.json
开发者工具创建的项目，miniprogramRoot 默认为 miniprogram，package.json 在其外部，npm 构建无法正常工作。需要手动在 project.config.json 内添加如下配置，使开发者工具可以正确索引到 npm 依赖的位置。
注意： 由于目前新版开发者工具创建的小程序目录文件结构问题，npm构建的文件目录为miniprogram_npm，并且开发工具会默认在当前目录下创建miniprogram_npm的文件名，所以新版本的miniprogramNpmDistDir配置为 ’./' 即可。
步骤五： 构建 npm 包
打开微信开发者工具，点击 工具 -> 构建 npm，并勾选 使用 npm 模块 选项，构建完成后，
到 全局配置 app.json 中注册引入组件，详见快速上手。
{
"usingComponents": {
"van-field": "@vant/weapp/field/index",
"van-button": "@vant/weapp/button/index",
"van-popup": "@vant/weapp/popup/index",
"van-picker": "@vant/weapp/picker/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
})
网友评论