小程序教程——Vant

1st.注意，小程序的包名不能是中文，所以当文件名是中念竖晌文时不能使用-y 需要使用npm init 回车后自己手动输入包名

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

通过 yarn 安装yarn add @vant/weapp --production

安装 0.x 版本npm i vant-weapp -S --production

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

删除app.json 中纤唯的 "style": "v2"

开发者工具创建的项目，miniprogramRoot 默认为 miniprogram，package.json 在其外部，npm 构建无法正常工作。需要手动在 project.config.json 内添加如下配置，使开发者工具可以正确索引到 npm 依赖的位置。

"packNpmManually": true,

        "packNpmRelationList": [

            {

                "packageJsonPath": "./package.json",

                "miniprogramNpmDistDir": "./"

              }

        ],

修改project.config.json

注意： 由于目前新版开发者工具创建的小程序目录文件结构问题，npm构建的文件目录为miniprogram_npm，并且开发工具会默认在当前目录下创建miniprogram_npm的文件名，所以新版本的miniprogramNpmDistDir配置为’./'即可

打开微信开发者工具，点击 工具 ->构建 npm ，并勾选 使用 npm 模块 选项，构建完成后，即可引入组件。

勾选 使用 npm 模块t

    当以上项目都完成之后，只需在.json文件中加入的"usingComponents"对象中注册需要使用的模块仔锋，即可在页面中使用

usingComponents中注册模块

附：Vant Weapp官网

介绍 - Vant Weapp (gitee.io)

vant UI 组件库是有赞前端团队开发的一个 Vue 组件库，提供了一整套的 UI 基础组件和业陵毕务组件，通过 vant 可以快速搭建出风格统一的页面。

官方地址： vant UI 组件库

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

工具 ->构建 npm

效果：

内置样式：https://vant-contrib.gitee.io/vant-weapp/#/common

Vant 中默认包含了一些常用样式，可以直接通过 className 的方式使用。

添加1px 边框，为元素添加 Retina 屏幕下的 1px 边框（即 hairline），基于伪类 transform 实现尺源芹。如果不是基于伪类实现的，则我们在添加的 1px 边框在 Retina 下默认是裂蠢 2px 。

Vant 轻量、可靠的移动端 Vue 组件库

Vant 是一个 轻量 、 可靠的移动端组件库 ，于 2017 年开源。

目前 Vant 官方提供了 Vue 2 版本、Vue 3 版茄高本和微信小程序版本，并由社区团队维护 React 版本和支付宝小程序版本。

文档：V2开发手册： https://vant-contrib.gitee.io/vant/v2/#/zh-CN/

特性：

通过 npm 安装 .在现有项目中使用 Vant 时，可以通过 npm 或 yarn 进行安装：

通过 CDN 安装 .使用 Vant 最简单的方法是直接在 html 文件中引入 CDN 链接，之后你可以通过全局变量 vant 访问到所有组件。

通过 脚手架安装 .在新项目中使用 Vant 时，推荐使用 Vue 官方提供的脚手架 Vue Cli 创建项目并安装 Vant。

Vue脚手架（创建、了解结构、运行流程）,不清楚vue怎么创建请点击

打开 Dos命令窗口 ,使用下面命令创建Vue

添加安装Vant支持

项目创建完毕后,并不直接支持vant,我们需要将Vant的内容添加安装到当前Vue项目

添加引用

启动项目的命令

Vant 支持多种组件注册方式，请根据实际业务需要进行选择。

全局注册后，你可以在 app 下的任意子组件中使用注册的 Vant 组件。

局部注册后，你可以在当前组件中使用注册的 Vant 组件。

Vant 中的许多组件提供了实例方法，调用实例方法时，我们需要通过 ref 来注册组件引用信息，引用信息将会注册在父组件的 $refs 对象上。注册完成后，我们可以通过 this.$refs.xxx 访问到对应的组件实例，并调用上面的实例方法。

Vant 默认使用px 作为样式单位，如果需要使用 viewport 单位 (vw, vh, vmin, vmax)，推荐使用 postcss-px-to-viewport 进行转换。

postcss-px-to-viewport 是一款 PostCSS 插件，用于将 px 单位转化为 vw/vh 单位。

下面提供了一份基本的 PostCSS 示例配置，可以在此配置的基础上根据项目需求进行修改。

表单组件

使用表单组件实现登录页面,是Vant直接提供的组件

向vue文件中复制文档中提供的代码

注意复制的位置,我们以AboutView.vue为例

然后直接访问about页面即可

area省市区选择

我们在手机app上经常需要选择省市区

Vant直接提供了这个组件

我们创建AreaView.vue文件

别忘了要设置路由才能访问这个页面

router文件夹下的index.js文件中添加路由代码

然后可以通过输入路径

localhost:8080/area访问这个页面

但是我们现在只能颤散尺访问我们数组中定义的少数省市区

怎么才能想文档中显示所有省市区呢

需要引用官方提供的一个地址列表

这样就安装了所有省市区的数据到当前的项目

我们只需要修改掘灶js代码,让arealist引用这个数据内容即可

商品列表页

我们在开发酷鲨商城的过程中

移动端需要很多页面,商品列表页面是比较常见的页面之一

我们以商品列表页为例

带领大家开发一个页面

创建页面和路由配置

router/index.js添加路由信息

创建ListView.vue

添加事件调用的参考代码

---