Dark Horse Little Rabbit Xianer uniapp 小規模プログラム開発 - 推奨モジュール - day03

Dark Horse Little Rabbit Xianer uniapp 小規模プログラム開発-02 ホームページ モジュール_Soft Worker のブログ-CSDN ブログ

このコースは、ネットワーク全体で vue3 と TS で書かれた最初の uniapp プロジェクトです。多数の独自のコンポーネント ライブラリをカプセル化しています。コースは uni-app の基礎から始まり、段階的に完全な e コマース ショッピング プロセス ビジネスを実装します。 9 つの主要な電子商取引ビジネス モジュールに、人気のおすすめ、製品分類、製品詳細、WeChat ログイン、ユーザー管理、アドレス管理、ショッピング カート管理、注文管理、その他の機能を網羅しています。WeChat ログイン、WeChat 支払い、その他のサービスが含まれます。複数の端末用のコードのセットは、WeChat アプレット端末、H5 端末、APP 端末を包括的にカバーします。

このコースを完了すると、uni-app + Vue3 を使用して中規模のプロジェクトを開発できるようになります。

リトルラビット西安 - 推奨モジュール - day03

主にタブのインタラクションと複数タブのリスト ページのデータ読み込みを実装します。

データを動的に取得する

リファレンスエフェクト

レコメンデーション モジュールのレイアウト構造は同じであるため、同じページとインタラクションを再利用できますが、表示されるデータは異なります。

静的構造

新しい人気の推奨事項ページ ファイルを作成し、pages.jsonルートを追加します (VS Code プラグインは自動的に完了します)。

// /src/pages/hot/hot.vue
<script setup lang="ts">
// 热门推荐页 标题和url
const hotMap = [
  { type: '1', title: '特惠推荐', url: '/hot/preference' },
  { type: '2', title: '爆款推荐', url: '/hot/inVogue' },
  { type: '3', title: '一站买全', url: '/hot/oneStop' },
  { type: '4', title: '新鲜好物', url: '/hot/new' },
]
</script>

<template>
  <view class="viewport">
    <!-- 推荐封面图 -->
    <view class="cover">
      <image
        src="http://yjy-xiaotuxian-dev.oss-cn-beijing.aliyuncs.com/picture/2021-05-20/84abb5b1-8344-49ae-afc1-9cb932f3d593.jpg"
      ></image>
    </view>
    <!-- 推荐选项 -->
    <view class="tabs">
      <text class="text active">抢先尝鲜</text>
      <text class="text">新品预告</text>
    </view>
    <!-- 推荐列表 -->
    <scroll-view scroll-y class="scroll-view">
      <view class="goods">
        <navigator
          hover-class="none"
          class="navigator"
          v-for="goods in 10"
          :key="goods"
          :url="`/pages/goods/goods?id=`"
        >
          <image
            class="thumb"
            src="https://yanxuan-item.nosdn.127.net/5e7864647286c7447eeee7f0025f8c11.png"
          ></image>
          <view class="name ellipsis">不含酒精，使用安心爽肤清洁湿巾</view>
          <view class="price">
            <text class="symbol">¥</text>
            <text class="number">29.90</text>
          </view>
        </navigator>
      </view>
      <view class="loading-text">正在加载...</view>
    </scroll-view>
  </view>
</template>

<style lang="scss">
page {
  height: 100%;
  background-color: #f4f4f4;
}
.viewport {
  display: flex;
  flex-direction: column;
  height: 100%;
  padding: 180rpx 0 0;
  position: relative;
}
.cover {
  width: 750rpx;
  height: 225rpx;
  border-radius: 0 0 40rpx 40rpx;
  overflow: hidden;
  position: absolute;
  left: 0;
  top: 0;
}
.scroll-view {
  flex: 1;
}
.tabs {
  display: flex;
  justify-content: space-evenly;
  height: 100rpx;
  line-height: 90rpx;
  margin: 0 20rpx;
  font-size: 28rpx;
  border-radius: 10rpx;
  box-shadow: 0 4rpx 5rpx rgba(200, 200, 200, 0.3);
  color: #333;
  background-color: #fff;
  position: relative;
  z-index: 9;
  .text {
    margin: 0 20rpx;
    position: relative;
  }
  .active {
    &::after {
      content: '';
      width: 40rpx;
      height: 4rpx;
      transform: translate(-50%);
      background-color: #27ba9b;
      position: absolute;
      left: 50%;
      bottom: 24rpx;
    }
  }
}
.goods {
  display: flex;
  flex-wrap: wrap;
  justify-content: space-between;
  padding: 0 20rpx 20rpx;
  .navigator {
    width: 345rpx;
    padding: 20rpx;
    margin-top: 20rpx;
    border-radius: 10rpx;
    background-color: #fff;
  }
  .thumb {
    width: 305rpx;
    height: 305rpx;
  }
  .name {
    height: 88rpx;
    font-size: 26rpx;
  }
  .price {
    line-height: 1;
    color: #cf4444;
    font-size: 30rpx;
  }
  .symbol {
    font-size: 70%;
  }
  .decimal {
    font-size: 70%;
  }
}

.loading-text {
  text-align: center;
  font-size: 28rpx;
  color: #666;
  padding: 20rpx 0 50rpx;
}
</style>

ページパラメータを取得する

人気のレコメンデーション ページでは、ページ パラメーターに基づいてどのタイプのレコメンデーション リストを取得する必要があるかを区別し、対応するインターフェイスを呼び出してさまざまなデータを取得し、それをページにレンダリングする必要があります。

プロジェクトのホームページ (パラメータの受け渡し)

// src/pages/index/components/HotPanel.vue
<navigator :url="`/pages/hot/hot?type=${item.type}`">
  …省略  
</navigator>

人気のおすすめページ (パラメータの取得)

// src/pages/hot/hot.vue
<script setup lang="ts">
// 热门推荐页 标题和url
const hotMap = [
  { type: '1', title: '特惠推荐', url: '/hot/preference' },
  { type: '2', title: '爆款推荐', url: '/hot/inVogue' },
  { type: '3', title: '一站买全', url: '/hot/oneStop' },
  { type: '4', title: '新鲜好物', url: '/hot/new' },
]
// uniapp 获取页面参数
const query = defineProps<{
  type: string
}>()
// console.log(query)
const currHot = hotMap.find((v) => v.type === query.type)
// 动态设置标题
uni.setNavigationBarTitle({ title: currHot!.title })
</script>

さまざまなページパラメータを渡し、推奨されるページタイトルを動的に設定します。

データを取得する

アドレスパラメータ

推奨事項のタイプが異なると、異なる API インターフェイスを呼び出す必要があります。

タイプ	推奨タイプ	インターフェースパス
1	特別オファーの推奨事項	/ホット/好み
2	人気のおすすめ	/ホット/インヴォーグ
3	ワンストップですべてを購入	/ホット/ワンストップ
4	新鮮で良いもの	/ホット/新しい

インターフェース呼び出し

インターフェイスを呼び出して推奨製品リストのデータを取得し、データをレンダリングします。

インターフェイスアドレス: 上の表を参照してください。

リクエストメソッド：GET

リクエストパラメータ:

クエリ:

フィールド名	それは必要ですか	デフォルト値	述べる
サブタイプ	いいえ	なし	推奨リストのタブ項目の ID
ページ	いいえ	1	ページ番号
ページサイズ	いいえ	10	ページあたりのアイテム数

リクエストのカプセル化

分析の結果、推奨されるリクエスト URL の種類は異なりますが、リクエスト パラメーターと応答形式は一貫しているため、インターフェイス呼び出しをカプセル化できます。参考コードは次のとおりです。

import { http } from '@/utils/http'
import type { PageParams } from '@/types/global'

type HotParams = PageParams & {
  /** Tab 项的 id，默认查询全部 Tab 项的第 1 页数据 */
  subType?: string
}
/**
 * 通用热门推荐类型
 * @param url 请求地址
 * @param data 请求参数
 */
export const getHotRecommendAPI = (url: string, data?: HotParams) => {
  return http<HotResult>({
    method: 'GET',
    url,
    data,
  })
}

型宣言

電子商取引プロジェクトでは製品の表示が一般的です。製品タイプは再利用可能で、次のsrc/types/global.d.tsファイルにパッケージ化されています。

// src/types/global.d.ts
/** 通用商品类型 */
export type GoodsItem = {
  /** 商品描述 */
  desc: string
  /** 商品折扣 */
  discount: number
  /** id */
  id: string
  /** 商品名称 */
  name: string
  /** 商品已下单数量 */
  orderNum: number
  /** 商品图片 */
  picture: string
  /** 商品价格 */
  price: number
}

実際、好みの製品タイプも同じだと思います。共通の製品タイプを再利用してsrc/services/home.tsファイルにカプセル化できます。

// src/services/home.ts
import type { GoodsItem } from '@/types/global'

// GuessItem 和 GoodsItem 类型相同
export type GuessItem = GoodsItem

一般的な推奨タイプは次のとおりです。新しいsrc/types/hot.d.tsファイルを作成します。

import type { PageResult, GoodsItem } from './global'

/** 热门推荐 */
export type HotResult = {
  /** id信息 */
  id: string
  /** 活动图片 */
  bannerPicture: string
  /** 活动标题 */
  title: string
  /** 子类选项 */
  subTypes: SubTypeItem[]
}

/** 热门推荐-子类选项 */
export type SubTypeItem = {
  /** 子类id */
  id: string
  /** 子类标题 */
  title: string
  /** 子类对应的商品集合 */
  goodsItems: PageResult<GoodsItem>
}

最後に、取得したデータをテンプレート構文と組み合わせてページにレンダリングします。

複数のタブのページネーションの読み込み

現在のユーザーが選択したタブに従って、対応するリスト データをロードする必要があります。

タブ操作の基本

ページ上のTabをクリックすると、該当する商品一覧が表示されるようになっており、比較的シンプルな機能なのですぐに実装できます。

参照コード

<script setup lang="ts">
// 高亮的下标
const activeIndex = ref(0)
</script>

<template>
  <!-- 推荐选项 -->
  <view class="tabs">
    <text
      class="text"
      v-for="(item, index) in subTypes"
      :key="item.id"
      :class="{ active: index === activeIndex }"
      @tap="activeIndex = index"
    >
      {
   
   { item.title }}
    </text>
  </view>
  <!-- 推荐列表 -->
  <scroll-view
    scroll-y
    class="scroll-view"
    v-for="(item, index) in subTypes"
    :key="item.id"
    v-show="activeIndex === index"
  >
    ...省略
  </scroll-view>
</template>

選択したタブのページング データをロードします

現在のユーザーが選択したタブに従って、対応するリスト データをロードします。

作業手順

1. 強調表示された添え字に従って、対応するリスト データを取得します
2. リクエストを送信するためのリストのページングパラメータを抽出します。
3. スクロールボトミングイベント、ページ番号の蓄積、配列の追加、終了判定などのサービスは、基本的に通常のページングと同様です。

参考コード（合計）

人気のおすすめページ

<script setup lang="ts">
import { getHotRecommendAPI } from '@/services/hot'
import type { SubTypeItem } from '@/types/hot'
import { onLoad } from '@dcloudio/uni-app'
import { ref } from 'vue'

// 热门推荐页 标题和url
const hotMap = [
  { type: '1', title: '特惠推荐', url: '/hot/preference' },
  { type: '2', title: '爆款推荐', url: '/hot/inVogue' },
  { type: '3', title: '一站买全', url: '/hot/oneStop' },
  { type: '4', title: '新鲜好物', url: '/hot/new' },
]

// uniapp 获取页面参数
const query = defineProps<{
  type: string
}>()
// 获取当前推荐信息
const currHot = hotMap.find((v) => v.type === query.type)
// 动态设置标题
uni.setNavigationBarTitle({ title: currHot!.title })

// 推荐封面图
const bannerPicture = ref('')
// 推荐选项
const subTypes = ref<(SubTypeItem & { finish?: boolean })[]>([])
// 高亮的下标
const activeIndex = ref(0)
// 获取热门推荐数据
const getHotRecommendData = async () => {
  const res = await getHotRecommendAPI(currHot!.url, {
    // 技巧：环境变量，开发环境，修改初始页面方便测试分页结束
    page: import.meta.env.DEV ? 30 : 1,
    pageSize: 10,
  })
  // 保存封面
  bannerPicture.value = res.result.bannerPicture
  // 保存列表
  subTypes.value = res.result.subTypes
}

// 页面加载
onLoad(() => {
  getHotRecommendData()
})

// 滚动触底
const onScrolltolower = async () => {
  // 获取当前选项
  const currsubTypes = subTypes.value[activeIndex.value]
  // 分页条件
  if (currsubTypes.goodsItems.page < currsubTypes.goodsItems.pages) {
    // 当前页码累加
    currsubTypes.goodsItems.page++
  } else {
    // 标记已结束
    currsubTypes.finish = true
    // 退出并轻提示
    return uni.showToast({ icon: 'none', title: '没有更多数据了~' })
  }

  // 调用API传参
  const res = await getHotRecommendAPI(currHot!.url, {
    subType: currsubTypes.id,
    page: currsubTypes.goodsItems.page,
    pageSize: currsubTypes.goodsItems.pageSize,
  })
  // 新的列表选项
  const newsubTypes = res.result.subTypes[activeIndex.value]
  // 数组追加
  currsubTypes.goodsItems.items.push(...newsubTypes.goodsItems.items)
}
</script>

<template>
  <view class="viewport">
    <!-- 推荐封面图 -->
    <view class="cover">
      <image :src="bannerPicture"></image>
    </view>
    <!-- 推荐选项 -->
    <view class="tabs">
      <text
        v-for="(item, index) in subTypes"
        :key="item.id"
        class="text"
        :class="{ active: index === activeIndex }"
        @tap="activeIndex = index"
        >{
   
   { item.title }}</text
      >
    </view>
    <!-- 推荐列表 -->
    <scroll-view
      v-for="(item, index) in subTypes"
      :key="item.id"
      v-show="activeIndex === index"
      scroll-y
      class="scroll-view"
      @scrolltolower="onScrolltolower"
    >
      <view class="goods">
        <navigator
          hover-class="none"
          class="navigator"
          v-for="goods in item.goodsItems.items"
          :key="goods.id"
          :url="`/pages/goods/goods?id=${goods.id}`"
        >
          <image class="thumb" :src="goods.picture"></image>
          <view class="name ellipsis">{
   
   { goods.name }}</view>
          <view class="price">
            <text class="symbol">¥</text>
            <text class="number">{
   
   { goods.price }}</text>
          </view>
        </navigator>
      </view>
      <view class="loading-text">
        {
   
   { item.finish ? '没有更多数据了~' : '正在加载...' }}
      </view>
    </scroll-view>
  </view>
</template>

---