微信小程序--》从零实现小程序项目案例

🏍️作者简介:大家好,我是亦世凡华、渴望知识储备自己的一名在校大学生

🛵个人主页:亦世凡华、

🛺系列专栏:微信小程序

🚲座右铭:人生亦可燃烧,亦可腐败,我愿燃烧,耗尽所有光芒。

👀引言

       ⚓经过web前端开发的学习,相信大家对于前端开发有了一定深入的了解,今天我开设了微信小程序专栏,主要想从移动端开发方向进一步发展,而对于我来说写移动端博文的第一站就是小程序开发,希望看到我文章的朋友能对你有所帮助。

目录

配置导航栏

配置tabBar

实现页面轮播图

实现页面九宫格

实现底部图片

实现九宫格的导航跳转

实现导航跳转时设置标题内容

实现商品列表数据的渲染

实现上拉加载以及loading效果

实现数据是否加载完毕的判断

实现下拉刷新功能

实现wxs处理手机号

最终的实现效果


今天借助黑马的本地生活案例,加强一下自己对小程序的学习,并将学习过程分享出来,希望能和以前学习的知识相互印证。现在开始:

配置导航栏

导航栏是小程序的门户,用户进来第一眼看到的便是导航栏,其起着对当前小程序主题的概括。而我们 新建的小程序 时,第一步变开始配置导航栏。如下:

配置tabBar

因为配置tabBar需要借助字体图标,我这里平常喜欢使用阿里云字体图标库,所以需要先去阿里云库中找到相关图标:其官方网站:网站链接

随便找两个,一个作为未点击(未激活)状态,另一个作为已点击(已激活)状态:

因为我是属于类似做一个小demo ,图标就随便选了,在正式项目必须严谨了,选好图标命名如下

准备好图片资源之后就要在 app.json 文件中配置tabBar了,配置代码如下:


   
   
  1. {
  2. "pages":[
  3. "pages/home/home",
  4. "pages/message/message",
  5. "pages/contact/contact"
  6. ],
  7. "window":{
  8. "backgroundTextStyle": "light",
  9. "navigationBarBackgroundColor": "#008c8c",
  10. "navigationBarTitleText": "本地生活",
  11. "navigationBarTextStyle": "white"
  12. },
  13. "tabBar": {
  14. "list": [{
  15. "pagePath": "pages/home/home",
  16. "text": "首页",
  17. "iconPath": "/images/home.png",
  18. "selectedIconPath": "/images/home-active.png"
  19. },{
  20. "pagePath": "pages/message/message",
  21. "text": "消息",
  22. "iconPath": "/images/message.png",
  23. "selectedIconPath": "/images/message-active.png"
  24. },{
  25. "pagePath": "pages/contact/contact",
  26. "text": "联系我们",
  27. "iconPath": "/images/contact.png",
  28. "selectedIconPath": "/images/contact-active.png"
  29. }]
  30. },
  31. "style": "v2",
  32. "sitemapLocation": "sitemap.json"
  33. }

实现页面轮播图

实现轮播图必须有图片资源,而在项目中一般是不会使用本地资源的,都是通过调用接口的形式拿到数据,在本项目中也是,因为轮播图是在 home 组件中进行使用,所有我们需要在home组件去调用接口,具体实现过程如下:

在页面的初始数据data中定义一个数组,用于存放数据:

调用微信的request方法,发起get请求访问接口拿到数据:


   
   
  1. // 获取轮播图的方法
  2. getSwiperList( ){
  3. wx. request({
  4. url: 'https://www.escook.cn/slides',
  5. method: 'GET',
  6. success: (res)=>{
  7. // 类似于React中的setState,将状态数据更新
  8. this. setData({
  9. SwiperList: res. data
  10. })
  11. }
  12. })
  13. },

在生命周期onLoad,页面刚加载的时候,调用获取轮播图的方法:

在data存放的数据可以在控制台的AppData中看到:

拿到数据之后,我们就可以在wxml中制作页面效果了:


   
   
  1. <!-- 轮播图区域 -->
  2. <swiper indicator-dots circular autoplay interval="2000">
  3. <swiper-item wx:for="{{SwiperList}}" wx:key="id">
  4. <image src="{{item.image}}"> </image>
  5. </swiper-item>
  6. </swiper>

属性可以参考我之前的文章:https://z5qyj5pyi.blog.csdn.net/article/details/125829071 ,如下:

给轮播图添加样式,给定宽高并充满两侧:


   
   
  1. swiper{
  2. height: 350rpx; /*rpx能实现高度的自动缩放*/
  3. }
  4. swiper image{
  5. width: 100%;
  6. height: 100%;
  7. }

至此轮播图效果已经实现,效果如下:

黑马的这个项目接口,就两张图片感觉有点丑,我自己在网上整了五张好看的小姐姐图片,然后用node搭建了一个本地服务器,然后也写了一个图片的接口,本想轮播小姐姐图片的,如下

换掉小程序之前黑马老师的接口链接,发现报错了,寻找原因原来没有让这个域名合法,好嘛于是登录到小程序的后台添加合法域名,发现报错,寻找原因,原来本地的ip地址不行,如下:

好嘛,之前的买的服务器已经到期了。。。只能这样了,看不了小姐姐了,哈哈,一个小插曲。

实现页面九宫格

和实现轮播图一样,也是需要调用接口,然后渲染到页面上,如下:

获取九宫格的数据:


   
   
  1. // 获取九宫格数据的方法
  2. getGridList( ){
  3. wx. request({
  4. url: 'https://www.escook.cn/categories',
  5. method: 'GET',
  6. success: (res)=>{
  7. this. setData({
  8. gridList:res. data
  9. })
  10. }
  11. })
  12. },

在页面刚渲染的时候,调用获取九宫格的方法:

在wxml页面上对接口获取到的数据进行渲染:


   
   
  1. <!-- 九宫格区域 -->
  2. <view class="grid-list">
  3. <view class="grid-item" wx:for="{{gridList}}" wx:key="id">
  4. <image src="{{item.icon}}"> </image>
  5. <text>{{item.name}} </text>
  6. </view>
  7. </view>

给获取到的数据添加样式:


   
   
  1. .grid-list{
  2. display: flex;
  3. flex-wrap: wrap; /* 让弹性盒元素在必要的时候拆行 */
  4. border-left: 1px solid #efefef;
  5. border-top: 1px solid #efefef;
  6. }
  7. .grid-item{
  8. width: 33.33%;
  9. height: 200rpx;
  10. display: flex;
  11. flex-direction: column; /* 项目将垂直显示,正如一个列一样。 */
  12. align-items: center; /* 定义flex子项在flex容器的中心 */
  13. justify-content: center; /*用于设置或检索弹性盒子元素在主轴(横轴)方向上的对齐方式为居中*/
  14. border-right: 1px solid #efefef;
  15. border-bottom: 1px solid #efefef;
  16. box-sizing: border-box;
  17. }
  18. .grid-item image {
  19. width: 60rpx;
  20. height: 60rpx;
  21. }
  22. .grid-item text{
  23. font-size: 24rpx;
  24. margin-top: 10rpx;
  25. }

得到的效果如下:

实现底部图片

可以看到在九宫格的下面还是有很大一片区域的,所有我们需要在下面放置两张图片,一个是商品推荐,另一个是交友论坛,如下:

在wxml中设置图片区域:


   
   
  1. <!-- 图片区域 -->
  2. <view class="img-box">
  3. <image src="/images/shangjia.jpg"> </image>
  4. <image src="/images/jiaoyou.jpg"> </image>
  5. </view>

给图片添加样式:


   
   
  1. /* 图片 */
  2. .img-box{
  3. display: flex;
  4. padding: 20rpx 10rpx;
  5. justify-content: space-around;
  6. }
  7. .img-box image{
  8. width: 45%;
  9. height: 250rpx;
  10. }

最终的结果如下:

实现九宫格的导航跳转

在我们配置好九宫格的样式之后,我们就需要给每个九宫格添加导航路由跳转了,如下:

首先我们需要新创建一个文件夹,里面用来存放九宫格跳转路由时用到数据的组件,如下:

创建好shoplist组件后,将我们之前九宫格的view标签修改为navigator标签,添加url属性,并书写好要跳转组件的路径,并传递参数,进行导航跳转:


   
   
  1. <!-- 九宫格区域 -->
  2. <view class="grid-list">
  3. <navigator class="grid-item" wx:for="{{gridList}}" wx:key="id" url="/pages/shoplist/shoplist?id={{item.id}}&title={{item.name}}">
  4. <image src="{{item.icon}}"> </image>
  5. <text>{{item.name}} </text>
  6. </navigator>
  7. </view>

如果不了解导航跳转的原理的朋友,可以看一下我之前的文章:数据请求和页面导航 。结果如下

实现导航跳转时设置标题内容

我们在跳转到shoplist组件时,将我们的id和titile作为query参数传递过去了,在微信的官方文档明确告诉我们在传参过去如何设置标题内容,如下:

那么如何调用 setNavigationBarTitle 呢?官方文档明确告诉我们调用的时机,如下:

ok,这样的话,我们就需要在shoplist组件的js文件进行相关配置了,通过onLoad函数,拿到传递过来的query参数,并将参数更新到data中。

在onReady函数中调用相应API,并从data拿到query的参数值,并渲染到页面,如下:

最后的效果如下:

实现商品列表数据的渲染

实现了标题内容之后,接下来需要实现,在点击相关九宫格选项之后,将相应的标题下的内容进行渲染出来,如下:

根据我们要调用的接口返回来的数据,第一步先在data中初始化数据,如下:

初始完数据之后,就要调用接口拿数据了,将拿到的数据去更新data里面的状态数据,根据我们点击九宫格返回过来的query参数里面的id,来判断我们要拿到哪一个页面的数据,如下:


   
   
  1. // 获取商品信息数据
  2. getShopList( ){
  3. wx. request({
  4. url: `https://www.escook.cn/categories/${this.data.query.id}/shops`,
  5. method: 'GET',
  6. data:{ //指定要发送给服务器的参数
  7. _page: this. data. page,
  8. _limit: this. data. pageSize
  9. },
  10. success: (res)=>{
  11. this. setData({
  12. shopList:[... this. data. shopList,...res. data], // 新旧数据的拼接
  13. total: res. header[ 'X-Total-Count']- 0 // 将字符串转换为数字型
  14. })
  15. }
  16. })
  17. },

在生命周期 onLoad ,页面刚加载数据的时候,调用我们获取商品列表信息的函数:

接下来,将我们接口调用的数据渲染到页面上,如下:


   
   
  1. <view class="shop-item" wx:for="{{shopList}}" wx:key="id">
  2. <!-- 图片资源 -->
  3. <view class="thumb">
  4. <image src="{{item.images[0]}}"> </image>
  5. </view>
  6. <!-- 文字信息 -->
  7. <view class="info">
  8. <text class="shop-title">{{item.name}} </text>
  9. <text>电话:{{item.phone}} </text>
  10. <text>地址:{{item.address}} </text>
  11. <text>营业时间:{{item.businessHours}} </text>
  12. </view>
  13. </view>

接下来需要对我们设置的内容样式进行美化,如下:


   
   
  1. .shop-item{
  2. display: flex;
  3. padding: 15rpx;
  4. border: 1px solid #efefef;
  5. margin: 15rpx;
  6. border-radius: 8rpx;
  7. box-shadow: 1rpx 1rpx 15rpx #ddd;
  8. }
  9. .thumb image{
  10. width: 250rpx;
  11. height: 250rpx;
  12. display: block;
  13. margin-right: 15rpx;
  14. }
  15. .info{
  16. display: flex;
  17. flex-direction: column;
  18. justify-content: space-around;
  19. font-size: 24rpx;
  20. }
  21. .shop-title{
  22. font-weight: bold;
  23. }

ok,具体效果如下:

实现上拉加载以及loading效果

在实现了接口数据渲染到页面之后,接下来要实现上拉加载实现请求多页的数据,如下:

首先,我们需要在shoplist.json文件中,去设置当我们下拉的距离为多少的时候加载第二页数据:

设置,完成之后,我们需要在页面上拉触底事件的处理函数中,对我们之前初始化的page进行+1 ,然后重新调用获取shoplist列表数据的函数,如下:

要知道上拉加载是有一个问题的,在网络不稳定的情况下,当你不停的在对应距离来回拉扯会不停的触发上下加载函数,具体的过程如下:

为了处理这个问题,需要设置一个节流阀来进行限制,如下:

在调用接口的函数中,进行数据加载前以及加载后页面的设置 :


   
   
  1. // 获取商品信息数据
  2. getShopList( ){
  3. // 表明我们要请求数据了,将isloading修改为true
  4. this. setData({
  5. isloading: true
  6. })
  7. // 展示loading效果
  8. wx. showLoading({
  9. title: '数据加载中......',
  10. })
  11. wx. request({
  12. url: `https://www.escook.cn/categories/${this.data.query.id}/shops`,
  13. method: 'GET',
  14. data:{ //指定要发送给服务器的参数
  15. _page: this. data. page,
  16. _limit: this. data. pageSize
  17. },
  18. success: (res)=>{
  19. this. setData({
  20. shopList:[... this. data. shopList,...res. data], // 新旧数据的拼接
  21. total: res. header[ 'X-Total-Count']- 0
  22. })
  23. },
  24. // 事件完成之后调用
  25. complete: ()=>{
  26. // 取消loading效果
  27. wx. hideLoading()
  28. this. setData({
  29. isloading: false
  30. })
  31. }
  32. })
  33. },

在上拉加载函数的地方在进行一次判断,如果isloading为true,证明当前正在请求数据,直接return出去就可以了,此时的页码值不会加1,也不会请求数据,当当前的数据请求完成以后,才可以让页码值进行加1,再请求下一页数据。

实现数据是否加载完毕的判断

我们在之前调用的接口中,里面的内容总共只有80条数据,每页有十条数据也就是说总共只有8页,但是当我们频繁的去下拉加载时,页数依然会增加,内容还是属于80条数据里面,这就产生了一个效率问题,如下:所有我们需要对数据是否加载完毕进行一个判断

判断的公式,如果下面公式成立 ,则证明没有下一页数据了:

页码值 * 每页显示多少条数据 >= 总数据条数

page * pageSize >= total

这里需要借用微信官方文档提供的API,如下:

最后的结果如下:

实现下拉刷新功能

实现下拉刷新功能之前,需要在shoplist.json文件中进行相关配置,如下:

结果如下:

接下来需要在下拉刷新函数中进行配置,将data中的数据初始化最初状态,并重新发起接口请求:


   
   
  1. /**
  2. * 页面相关事件处理函数--监听用户下拉动作
  3. */
  4. onPullDownRefresh( ) {
  5. // 需要重置关键的数据
  6. this. setData({
  7. page: 1,
  8. shopList:[],
  9. total: 0
  10. })
  11. // 重新发起数据请求,并传入一个参数函数,在接口请求数据结束,调用该函数阻止下拉刷新
  12. this. getShopList( ()=>{
  13. wx. stopPullDownRefresh()
  14. })
  15. },

获取商品数据的函数传递一个形参用来接收函数

在接口请求完成之后通过短路运算调用这个函数,如下:这样即使有别的函数调用获取商品列表的接口函数,没有传递参数的话也是不会调用这个函数的。

可以点击预览在自己的手机上查看相关功能点配置如何:

实现wxs处理手机号

我们可以通过配置一个wxs脚本来对手机号进行设置,如下:

设置脚本文件,如下:


   
   
  1. function splitPhone( str){
  2. if(str!== null){
  3. if(str. length !== 11) return str
  4. } else{
  5. return '未知'
  6. }
  7. var arr = str. split( '')
  8. arr. splice( 3, 0, '-')
  9. arr. splice( 8, 0, '-')
  10. return arr. join( '')
  11. }
  12. module. exports = {
  13. splitPhone:splitPhone
  14. }

最终结果如下:

最终的实现效果

根据上文对项目功能的不断增加,最终这个案例demo所呈现的效果如下:

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值