【微信小程序-原生开发】实用教程06-轮播图、分类页签 tab 、成员列表(含Tdesign升级,切换调试基础库,设置全局样式,配置组件按需注入,添加图片素材,wx:for,生命周期 onLoad)

简介: 【微信小程序-原生开发】实用教程06-轮播图、分类页签 tab 、成员列表(含Tdesign升级,切换调试基础库,设置全局样式,配置组件按需注入,添加图片素材,wx:for,生命周期 onLoad)

开始前,请先完成首页的开发,详见

【微信小程序-原生开发】实用教程05-首页(含自定义调试模式、插入图片、图文排版、底部留白、添加本地图片)

https://blog.csdn.net/weixin_41192489/article/details/128729732

需求描述

今天整个稍微复杂点的,效果如下:

但在开始前,我们需要做几项其他的准备

升级到最新版的 Tdesign 组件库

按教程01 默认模板创建的项目的 Tdesign 组件不是最新版的,需手动升级一下,操作流程如下:

  1. 打开终端,执行命令
cnpm i tdesign-miniprogram -S --production

未安装 cnpm 的朋友,先执行 npm i cnpm 安装 cnpm

2. 执行 npm 构建

切换为最新版的调试基础库

默认的调试基础库版本比较低,请按下图进行切换

调整全局样式

通过 app.wxss 可以设置全局样式,以便所有页面共享,现将 app.wxss 里的代码全部替换为下方代码:

/* app.wxss 定义全局样式 */
page {
  /* 默认页面底色设置为白色 */
  background: white;
  /* 底部留白的高度需与底部导航的高度相同 */
  padding-bottom: 100rpx;
}

有了全局样式后,便可删除首页中底部的占位区间啦!

pages\index\index.wxml

<view class="blankBar"> 
</view>

pages\index\index.wxss

.blankBar {
  /* 底部留白的高度需与底部导航的高度相同 */
  height: 100rpx;
}

配置组件按需注入

修改全局配置文件 app.json

  • 删除 usingComponents 配置
  • 添加 lazyCodeLoading 配置
  "lazyCodeLoading": "requiredComponents",

这两项配置的改变,都是为了实现组件按需注入,从而提升微信小程序的加载和渲染速度。

添加网络图片素材

因微信小程序的限制,图片视频等媒体素材总大小不能超过200k,所以图片需先上传到 CDN 后引入其网址使用。

让我们将图片的网址整理存到 assets文件夹中(无相关路径的文件夹或文件,请自行创建)

assets\images\美女\data.js

export default {
   '1':'https://ucc.alicdn.com/images/user-upload-01/6dca0e87288a4c37b76e7d26e016e299.jpeg',
   '2':'https://ucc.alicdn.com/images/user-upload-01/8dd7ab28ae6246b69a1722b3ad18d506.jpeg'
}

assets\images\帅哥\data.js

export default {
   '1':'https://ucc.alicdn.com/images/user-upload-01/de253e12408f4133adf8f82982e22ce5.jpeg',
   '2':'https://ucc.alicdn.com/images/user-upload-01/e9fb6f4e461744e593ca305440760e16.jpeg',
   '3':'https://ucc.alicdn.com/images/user-upload-01/63926e3235434cd8bd30285f5612d303.jpeg',
   '4':'https://ucc.alicdn.com/images/user-upload-01/601a29123c17471dac01e358dce8e1fe.jpeg',
}

代码实现

准备工作完毕,终于可以开始开发啦!

我先给出最终的总代码,然后分别解析各部分的核心实现哈:

pages\member\index.json

{
  "usingComponents": {
    "t-swiper": "tdesign-miniprogram/swiper/swiper",
    "t-tabs": "tdesign-miniprogram/tabs/tabs",
    "t-tab-panel": "tdesign-miniprogram/tab-panel/tab-panel",
    "t-avatar": "tdesign-miniprogram/avatar/avatar"
  }
}

pages\member\index.wxml

<!-- 轮播图 -->
<view class="swiperBox">
  <t-swiper image-props="{{imageProps}}" current="{{current}}" autoplay="{{autoplay}}" duration="{{duration}}" interval="{{interval}}" list="{{swiperList}}" navigation="{{ { type: 'dots-bar' } }}" />
</view>
<!-- 分类页签 tab -->
<t-tabs defaultValue="{{defaultTab}}" theme="card" bindchange='tabChange'>
  <t-tab-panel wx:for="{{tabList}}" wx:key="index" label="{{item.label}}" value="{{item.index}}" />
</t-tabs>
<!-- 成员列表 -->
<view wx:for="{{filteredMemberList}}" wx:key="index" class="memberBox">
  <t-avatar class="avatar-example" shape="round" image="{{item.imgURL}}" />
  <view class="memberName">
    {{item.name}}
  </view>
  <view class="memberStaus">
    {{item.status}} ing
  </view>
</view>

pages\member\index.wxss

.swiperBox{
 padding: 30rpx;
}

.memberBox{
  padding: 20rpx;
  display: flex;
  align-items: center;
  border-bottom: 1rpx solid rgb(223, 217, 217);
  background-color: #ffffff;
}

.memberName{
  font-weight: bold;
  font-size: 40rpx;
  padding-left: 30rpx;
}

.memberStaus{
  padding-left: 40rpx;
}

pages\member\index.js

// 导入图片素材
import girlImgDic from '../../assets/images/美女/data'
import boyImgDic from '../../assets/images/帅哥/data'
Page({
  data: {
    // 添加轮播图片的属性
    imageProps: {
      // 图片按宽度自适应
      mode: 'widthFix'
    },
    // 轮播从下标为 0 的图片开始
    current: 0,
    // 自动轮播
    autoplay: true,
    //  每张图片的停留时间
    duration: 500,
    // 轮播时间间隔
    interval: 5000,
    // 轮播图的图片列表
    swiperList: [
      girlImgDic['1'],
      girlImgDic['2'],
      boyImgDic['4'],
    ],
    // 默认 tab 页签的 index
    defaultTab: '0',
    // 分类页签 tab 列表
    tabList: [{
        index: '0',
        label: '全部'
      },
      {
        index: '1',
        label: '男'
      },
      {
        index: '2',
        label: '女'
      },
    ],
    // 过滤后的成员列表
    filteredMemberList: [],
    // 总成员列表,其中 gender '1'为男,'2'为女
    allMemberList: [{
        imgURL: girlImgDic['1'],
        name: '小霞',
        gender: '2',
        status: '筹备婚礼'
      },
      {
        imgURL: girlImgDic['2'],
        name: '若依',
        gender: '2',
        status: '享受泡澡'
      },
      {
        imgURL: boyImgDic['1'],
        name: '约翰',
        gender: '1',
        status: '忧郁'
      },
      {
        imgURL: boyImgDic['2'],
        name: '陈翔',
        gender: '1',
        status: '思考'
      },
      {
        imgURL: boyImgDic['4'],
        name: '李阳',
        gender: '1',
        status: '沉醉'
      },
    ]
  },
  // 切换页签时触发
  tabChange: function (e) {
    let gender = e.detail.value
    if (gender !== '0') {
      this.setData({
        filteredMemberList: this.data.allMemberList.filter(item => item.gender === gender)
      })
    } else {
      this.setData({
        filteredMemberList: this.data.allMemberList
      })
    }
  },
  // 生命周期--页面加载时执行
  onLoad(options) {
    this.setData({
      filteredMemberList: this.data.allMemberList
    })
  },
  onShow() {
    this.getTabBar().init();
  },
})

轮播图

组件文档见

https://tdesign.tencent.com/miniprogram/components/swiper

<!-- 轮播图 -->
<view class="swiperBox">
  <t-swiper image-props="{{imageProps}}" current="{{current}}" autoplay="{{autoplay}}" duration="{{duration}}" interval="{{interval}}" list="{{swiperList}}" navigation="{{ { type: 'dots-bar' } }}" />
</view>
.swiperBox{
 padding: 30rpx;
}
    // 添加轮播图片的属性
    imageProps: {
      // 图片按宽度自适应
      mode: 'widthFix'
    },
    // 轮播从下标为 0 的图片开始
    current: 0,
    // 自动轮播
    autoplay: true,
    //  每张图片的停留时间
    duration: 500,
    // 轮播时间间隔
    interval: 5000,
    // 轮播图的图片列表
    swiperList: [
      girlImgDic['1'],
      girlImgDic['2'],
      boyImgDic['4'],
    ],

重点留意:

  1. 需设置 padding,因默认效果轮播图是圆角的,直接紧挨手机边缘不美观
  2. 需设置轮播图片的适配模式 widthFix,以便按手机宽度自适应。

分类页签 tab

<!-- 分类页签 tab -->
<t-tabs defaultValue="{{defaultTab}}" theme="card" bindchange='tabChange'>
  <t-tab-panel wx:for="{{tabList}}" wx:key="index" label="{{item.label}}" value="{{item.index}}" />
</t-tabs>
    // 默认 tab 页签的 index
    defaultTab: '0',
    // 分类页签 tab 列表
    tabList: [{
        index: '0',
        label: '全部'
      },
      {
        index: '1',
        label: '男'
      },
      {
        index: '2',
        label: '女'
      },
    ],

重点留意:页签的切换事件

  // 切换页签时触发
  tabChange: function (e) {
    let gender = e.detail.value
    if (gender !== '0') {
      this.setData({
        filteredMemberList: this.data.allMemberList.filter(item => item.gender === gender)
      })
    } else {
      this.setData({
        filteredMemberList: this.data.allMemberList
      })
    }
  },

此处因未访问接口,只是前端按性别字段,对成员列表进行了过滤。

成员列表

<!-- 成员列表 -->
<view wx:for="{{filteredMemberList}}" wx:key="index" class="memberBox">
  <t-avatar class="avatar-example" shape="round" image="{{item.imgURL}}" />
  <view class="memberName">
    {{item.name}}
  </view>
  <view class="memberStaus">
    {{item.status}} ing
  </view>
</view>
.memberBox{
  padding: 20rpx;
  display: flex;
  align-items: center;
  border-bottom: 1rpx solid rgb(223, 217, 217);
  background-color: #ffffff;
}

.memberName{
  font-weight: bold;
  font-size: 40rpx;
  padding-left: 30rpx;
}

.memberStaus{
  padding-left: 40rpx;
}

样式部分即最基础的 flex 布局,注意提一下 wxml 中的新语法 wx:for

wx:for

类似 vue 中的 v-for,用于循环遍历渲染列表,注意其书写格式

  • 无需在 wx:for 中声明,index 即下标
  • 无需在 wx:for 中声明,item 即被遍历的每一项
wx:for="{{filteredMemberList}}" wx:key="index" 
 
  <view class="memberName">
    {{item.name}}
  </view>

生命周期 onLoad

本例中,最终渲染的成员列表是 filteredMemberList,但其在最开始是空的,需在页面加载时,赋予初始值 allMemberList,故需使用页面加载时的生命周期 onLoad

  // 生命周期--页面加载时执行
  onLoad(options) {
    this.setData({
      filteredMemberList: this.data.allMemberList
    })
  },

目录
相关文章
|
8月前
|
人工智能 小程序 前端开发
一个小程序轻量AR体感游戏,开发实现解决方案
针对青少年运动兴趣不足问题,AR体感游戏凭借沉浸式互动体验脱颖而出。结合小程序“AI运动识别”插件与WebGL渲染技术,可实现无需外设的轻量化AR健身游戏,如跳糕、切水果等,兼具趣味性与锻炼效果,适用于儿童健身及职工团建,即开即玩,低门槛高参与。
|
8月前
|
运维 小程序 数据可视化
小程序开发平台有哪些?SaaS小程序制作平台哪个好
小程序开发模式详解:自主开发、SaaS小程序制作平台与外包全对比 选择合适的小程序开发模式,是项目成功的基石。这三种模式在成本、周期、控制力和灵活性上各有千秋,适用于不同阶段和不同类型的企业。下面我们将逐一深入剖析。
701 9
|
8月前
|
移动开发 小程序 前端开发
小程序开发平台有哪些?哪个好
小程序的开发方式丰富多元,开发团队可根据自身的技术背景、项目具体需求以及资源状况,灵活挑选最为适宜的开发路径。以下将详细介绍几种主流的小程序开发方式。
672 1
|
8月前
|
移动开发 小程序 前端开发
小程序快速开发平台有哪些?
小程序开发并非“一刀切”,需结合技术储备、资金预算、时间规划及功能需求等多维度因素综合考量。以下为您详细拆解五种主流开发方案及其适用场景,助您精准匹配开发路径。
470 3
|
8月前
|
移动开发 小程序 前端开发
小程序开发平台有哪些?小程序开发制作软件推荐
小程序开发方案全解析:5种主流方式与选择指南 小程序开发需根据技术能力、预算、时间及功能需求综合决策。以下为5种主流开发方案及适用场景分析:
26375 0
|
小程序 前端开发 Android开发
小程序微信分享功能如何开发?开放平台已绑定仍不能使用的问题?-优雅草卓伊凡
小程序微信分享功能如何开发?开放平台已绑定仍不能使用的问题?-优雅草卓伊凡
2417 29
小程序微信分享功能如何开发?开放平台已绑定仍不能使用的问题?-优雅草卓伊凡
|
10月前
|
小程序 JavaScript API
uni-halo + 微信小程序开发实录:我的第一个作品诞生记
这篇文章介绍了使用uni-halo框架进行微信小程序开发的过程,包括选择该框架的原因、开发目标以及项目配置和部署的步骤。
525 0
uni-halo + 微信小程序开发实录:我的第一个作品诞生记
|
人工智能 开发框架 小程序
工会成立100周年纪念,开发职工健身AI运动小程序、APP方案推荐
为庆祝中华全国总工会成立100周年,特推出基于AI技术的智能健身系统,以小程序和APP形式呈现,助力职工健康生活。方案包括:1) 小程序插件,支持多种运动识别,开箱即用;2) APP插件,提供更高精度的运动检测;3) 成熟的「AI乐运动」系统,支持赛事活动管理。这些方案满足不同需求,推动全民健身体验升级,彰显工会对职工健康的关怀。