首页技术栈归档照片墙音乐日记随想收藏夹友链留言关于

uni-app

写作时间:2026-07-08

7. 商品详情

7.0 创建 goodsdetail 分支

运行如下的命令,基于 master 分支在本地创建 goodsdetail 子分支,用来开发商品详情页相关的功能:

git checkout -b goodsdetail

7.1 添加商品详情页的编译模式

  1. 在微信开发者工具中,点击工具栏上的编译模式下拉菜单,选择 添加编译模式 选项:

    img

  2. 勾选 启动页面 的路径,并填写了 启动参数 之后,点击 确定 按钮,添加详情页面的编译模式:

    img

7.2 获取商品详情数据

  1. 在 data 中定义商品详情的数据节点:

    data() {
      return {
        // 商品详情对象
        goods_info: {}
      }
    }
    
  2. 在 onLoad 中获取商品的 Id,并调用请求商品详情的方法:

    onLoad(options) {
      // 获取商品 Id
      const goods_id = options.goods_id
      // 调用请求商品详情数据的方法
      this.getGoodsDetail(goods_id)
    }
    
  3. 在 methods 中声明 getGoodsDetail 方法:

    methods: {
      // 定义请求商品详情数据的方法
      async getGoodsDetail(goods_id) {
        const { data: res } = await uni.$http.get('/api/public/v1/goods/detail', { goods_id })
        if (res.meta.status !== 200) return uni.$showMsg()
        // 为 data 中的数据赋值
        this.goods_info = res.message
      }
    }
    

7.3 渲染商品详情页的 UI 结构

7.3.1 渲染轮播图区域

  1. 使用 v-for 指令,循环渲染如下的轮播图 UI 结构:

    <!-- 轮播图区域 -->
    <swiper :indicator-dots="true" :autoplay="true" :interval="3000" :duration="1000" :circular="true">
      <swiper-item v-for="(item, i) in goods_info.pics" :key="i">
        <image :src="item.pics_big"></image>
      </swiper-item>
    </swiper>
    
  2. 美化轮播图的样式:

    swiper {
      height: 750rpx;
    
      image {
        width: 100%;
        height: 100%;
      }
    }
    

7.3.2 实现轮播图预览效果

  1. 为轮播图中的 image 图片绑定 click 事件处理函数:

  1. 在 methods 中定义 preview 事件处理函数:

    // 实现轮播图的预览效果
    preview(i) {
      // 调用 uni.previewImage() 方法预览图片
      uni.previewImage({
        // 预览时,默认显示图片的索引
        current: i,
        // 所有图片 url 地址的数组
        urls: this.goods_info.pics.map(x => x.pics_big)
      })
    }
    

7.3.3 渲染商品信息区域

  1. 定义商品信息区域的 UI 结构如下:

    <!-- 商品信息区域 -->
    <view class="goods-info-box">
      <!-- 商品价格 -->
      <view class="price">¥{{goods_info.goods_price}}</view>
      <!-- 信息主体区域 -->
      <view class="goods-info-body">
        <!-- 商品名称 -->
        <view class="goods-name">{{goods_info.goods_name}}</view>
        <!-- 收藏 -->
        <view class="favi">
          <uni-icons type="star" size="18" color="gray"></uni-icons>
          <text>收藏</text>
        </view>
      </view>
      <!-- 运费 -->
      <view class="yf">快递:免运费</view>
    </view>
    
  2. 美化商品信息区域的样式:

    // 商品信息区域的样式
    .goods-info-box {
      padding: 10px;
      padding-right: 0;
    
      .price {
        color: #c00000;
        font-size: 18px;
        margin: 10px 0;
      }
    
      .goods-info-body {
        display: flex;
        justify-content: space-between;
    
        .goods-name {
          font-size: 13px;
          padding-right: 10px;
        }
        // 收藏区域
        .favi {
          width: 120px;
          font-size: 12px;
          display: flex;
          flex-direction: column;
          justify-content: center;
          align-items: center;
          border-left: 1px solid #efefef;
          color: gray;
        }
      }
    
      // 运费
      .yf {
        margin: 10px 0;
        font-size: 12px;
        color: gray;
      }
    }
    

7.3.4 渲染商品详情信息

  1. 在页面结构中,使用 rich-text 组件,将带有 HTML 标签的内容,渲染为小程序的页面结构:

    <!-- 商品详情信息 -->
    <rich-text :nodes="goods_info.goods_introduce"></rich-text>
    
  2. 修改 getGoodsDetail 方法,从而解决图片底部 空白间隙 的问题:

// 定义请求商品详情数据的方法 async getGoodsDetail(goods_id) { const { data: res } = await uni.http.get(′/api/public/v1/goods/detail′,goodsid)if(res.meta.status!==200)returnuni.http.get('/api/public/v1/goods/detail', { goods_id }) if (res.meta.status !== 200) return uni.http.get(′/api/public/v1/goods/detail′,goodsi​d)if(res.meta.status!==200)returnuni.showMsg()

 // 使用字符串的 replace() 方法,为 img 标签添加行内的 style 样式,从而解决图片底部空白间隙的问题

res.message.goods_introduce = res.message.goods_introduce.replace(/<img /g, '<img style="display:block;" ') this.goods_info = res.message }


3. 解决 `.webp` 格式图片在 `ios` 设备上无法正常显示的问题:

```js
// 定义请求商品详情数据的方法
async getGoodsDetail(goods_id) {
const { data: res } = await uni.$http.get('/api/public/v1/goods/detail', { goods_id })
  if (res.meta.status !== 200) return uni.$showMsg()

  // 使用字符串的 replace() 方法,将 webp 的后缀名替换为 jpg 的后缀名
res.message.goods_introduce = res.message.goods_introduce.replace(/<img /g, '<img style="display:block;" ').replace(/webp/g, 'jpg')
  this.goods_info = res.message
}

7.3.5 解决商品价格闪烁的问题

  1. 导致问题的原因:在商品详情数据请求回来之前,data 中 goods_info 的值为 {},因此初次渲染页面时,会导致 商品价格、商品名称 等闪烁的问题。

  2. 解决方案:判断 goods_info.goods_name 属性的值是否存在,从而使用 v-if 指令控制页面的显示与隐藏:

7.4 渲染详情页底部的商品导航区域

7.4.1 渲染商品导航区域的 UI 结构

基于 uni-ui 提供的 GoodsNav 组件来实现商品导航区域的效果

  1. 在 data 中,通过 options 和 buttonGroup 两个数组,来声明商品导航组件的按钮配置对象:

data() { return { // 商品详情对象 goods_info: {}, // 左侧按钮组的配置对象 options: [{ icon: 'shop', text: '店铺' }, { icon: 'cart', text: '购物车', info: 2 }], // 右侧按钮组的配置对象 buttonGroup: [{ text: '加入购物车', backgroundColor: '#ff0000', color: '#fff' }, { text: '立即购买', backgroundColor: '#ffa200', color: '#fff' } ] } }


2. 在页面中使用 `uni-goods-nav` 商品导航组件:

```xml
<!-- 商品导航组件 -->
<view class="goods_nav">
  <!-- fill 控制右侧按钮的样式 -->
  <!-- options 左侧按钮的配置项 -->
  <!-- buttonGroup 右侧按钮的配置项 -->
  <!-- click 左侧按钮的点击事件处理函数 -->
  <!-- buttonClick 右侧按钮的点击事件处理函数 -->
  <uni-goods-nav :fill="true" :options="options" :buttonGroup="buttonGroup" @click="onClick" @buttonClick="buttonClick" />
</view>
  1. 美化商品导航组件,使之固定在页面最底部:

    .goods-detail-container {
      // 给页面外层的容器,添加 50px 的内padding,
      // 防止页面内容被底部的商品导航组件遮盖
      padding-bottom: 50px;
    }
    
    .goods_nav {
      // 为商品导航组件添加固定定位
      position: fixed;
      bottom: 0;
      left: 0;
      width: 100%;
    }
    

7.4.2 点击跳转到购物车页面

  1. 点击商品导航组件左侧的按钮,会触发 uni-goods-nav 的 @click 事件处理函数,事件对象 e 中会包含当前点击的按钮相关的信息:

// 左侧按钮的点击事件处理函数 onClick(e) { console.log(e) }


打印的按钮信息对象如下:

![img](data:image/png;base64,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)

2. 根据 `e.content.text` 的值,来决定进一步的操作:

   ```js
// 左侧按钮的点击事件处理函数
   onClick(e) {
  if (e.content.text === '购物车') {
       // 切换到购物车页面
    uni.switchTab({
         url: '/pages/cart/cart'
    })
     }
}

7.5 分支的合并与提交

  1. 将 goodsdetail 分支进行本地提交:

    git add .
    git commit -m "完成了商品详情页面的开发"
    
  2. 将本地的 goodsdetail 分支推送到码云:

    git push -u origin goodsdetail
    
  3. 将本地 goodsdetail 分支中的代码合并到 master 分支:

    git checkout master
    git merge goodsdetail
    git push
    
  4. 删除本地的 goodsdetail 分支:

    git branch -d goodsdetail
    
avatar

yuanyourdomain

写代码,做研究,记录生活。

RECOMMENDED

MyBatis 动态 SQL

2026-07-08

Nginx 基础入门

2026-07-08

Maven 多模块与私服

2026-07-08