HiDocs
Search K

Appearance

4. 分类 ​

image-20221004224829719

4.0 创建 cate 分支 ​

运行如下的命令，基于 master 分支在本地创建 cate 子分支，用来开发分类页面相关的功能：

bash
git checkout -b cate

4.1 渲染分类页面的基本结构 ​

  1. 定义页面结构如下：

    注：scroll-view + view 是可滑动区域，也就是可以用手指滑动的区域

    swiper + swiper-item 是轮播图，两者是不一样

    xml
    <template>
  <view>
    <view class="scroll-view-container">
      <!-- 左侧的滚动视图区域，scroll-y设置为纵向，高度为动态指定的 窗口的可用高度wh -->
      <scroll-view class="left-scroll-view" scroll-y :style="{height: wh + 'px'}">
        <view class="left-scroll-view-item active">xxx</view>
        <view class="left-scroll-view-item">xxx</view>
        <view class="left-scroll-view-item">xxx</view>
        <view class="left-scroll-view-item">xxx</view>
        <view class="left-scroll-view-item">xxx</view>
        <view class="left-scroll-view-item">多复制一些节点，演示纵向滚动效果...</view>
      </scroll-view>
      <!-- 右侧的滚动视图区域 -->
      <scroll-view class="right-scroll-view" scroll-y :style="{height: wh + 'px'}">
        <view class="left-scroll-view-item">zzz</view>
        <view class="left-scroll-view-item">zzz</view>
        <view class="left-scroll-view-item">zzz</view>
        <view class="left-scroll-view-item">zzz</view>
        <view class="left-scroll-view-item">多复制一些节点，演示纵向滚动效果</view>
      </scroll-view>
    </view>
  </view>
</template>

  2. 动态计算窗口的剩余高度：

    vue
    <script>
  export default {
    data() {
      return {
        // 窗口的可用高度wh = 屏幕高度 - navigationBar高度 - tabBar 高度（但是不需要我们自己计算）
        wh: 0
      };
    },
    onLoad() {
      // 获取当前系统的信息，里面包含了窗口的可用高度信息windowHeight
      // 还有屏幕高度screenHeight
      const sysInfo = uni.getSystemInfoSync()
      // 为 wh 窗口可用高度动态赋值
      this.wh = sysInfo.windowHeight
    }
  }
</script>

  3. 美化页面结构：

    scss
    .scroll-view-container {
  display: flex;

  .left-scroll-view {
    width: 120px;

    .left-scroll-view-item {
      line-height: 60px;
      background-color: #f7f7f7;
      text-align: center;
      font-size: 12px;

      // 激活项的样式
      &.active { //&是scss里父选择器的标识符，表示and，即既有.left-scroll-view-item又有.active类名时
        background-color: #ffffff;
        position: relative; //为了垂直居中

        // 伪元素：::before和::after下特有的content，用于在css渲染中向元素的逻辑上的头部或尾部添加内容。这些添加不会出现在DOM中，不会改变文档内容，不可复制，仅仅是在css渲染层加入
        // ::before和::after必须配合content属性来使用，content用来定义插入的内容，content必须有值，至少是空。默认情况下，伪类元素的display是默认值inline，可以通过设置display:block来改变其显示
        // 渲染激活项左侧的红色指示边线
        &::before { //即.left-scroll-view-item::before
          content: ' ';
          display: block;
          width: 3px;
          height: 30px;
          background-color: #c00000;
          position: absolute;
          left: 0;
          top: 50%; //垂直居中
          transform: translateY(-50%); //垂直居中
        }
      }
    }
  }
}

4.2 获取分类数据 ​

  1. 在 data 中定义分类数据节点：

    js
    data() {
  return {
    // 分类数据列表
    cateList: []
  }
}

  2. 调用获取分类列表数据的方法：

    js
    onLoad() {
  // 调用获取分类列表数据的方法
  this.getCateList()
}

  3. 定义获取分类列表数据的方法：

    js
    methods: {
  async getCateList() {
    // 发起请求
    const { data: res } = await uni.$http.get('/api/public/v1/categories')
    // 判断是否获取失败
    if (res.meta.status !== 200) return uni.$showMsg()
    // 转存数据
    this.cateList = res.message
  }
}

4.3 动态渲染左侧的一级分类列表 ​

注：一级分类就是左侧栏的选项

  1. 循环渲染列表结构：

    xml
    <!-- 左侧的滚动视图区域 -->
<scroll-view class="left-scroll-view" scroll-y :style="{height: wh + 'px'}">
  <!-- block是不会渲染在dom中的标签 -->
  <block v-for="(item, i) in cateList" :key="i">
    <view class="left-scroll-view-item">{{item.cat_name}}</view>
  </block>
</scroll-view>

  2. 在 data 中定义默认选中项的索引：

    js
    data() {
  return {
    // 当前选中项的索引，默认让第一项被选中
    active: 0
  }
}

  3. 循环渲染结构时，为选中项动态添加 .active 类名：

    xml
    <block v-for="(item, i) in cateList" :key="i">
  <!--active不仅是类名同时也是被激活的索引号-->
  <view :class="['left-scroll-view-item', i === active ? 'active' : '']">{{item.cat_name}}</view>
</block>

  4. 为一级分类的 Item 项绑定点击事件处理函数 activeChanged：

    xml
    <block v-for="(item, i) in cateList" :key="i">
  <view :class="['left-scroll-view-item', i === active ? 'active' : '']" @click="activeChanged(i)">{{item.cat_name}}</view>
</block>

  5. 定义 activeChanged 事件处理函数，动态修改选中项的索引：

    js
    methods: {
  // 选中项改变的事件处理函数
  activeChanged(i) {
    this.active = i
  }
}

4.4 动态渲染右侧的二级分类列表 ​

注：二级分类是右侧的众多标题

  1. 在 data 中定义二级分类列表的数据节点：

    js
    data() {
  return {
    // 二级分类列表
    cateLevel2: []
  }
}

  2. 修改 getCateList 方法，在请求到数据之后，为二级分类列表数据赋值：

    js
    async getCateList() {
  const { data: res } = await uni.$http.get('/api/public/v1/categories')
  if (res.meta.status !== 200) return uni.$showMsg()
  this.cateList = res.message // 得到的整个数据，包括一类和二类
  // 为二级分类赋值，暂时只附第一个分类的二级分类的值.children
  this.cateLevel2 = res.message[0].children
}

  3. 修改 activeChanged 方法，在一级分类选中项改变之后，为二级分类列表数据重新赋值：

    js
    activeChanged(i) {
  this.active = i
  // 为二级分类列表重新赋值：保证二级分类的值是当前被激活的分类的子类
  this.cateLevel2 = this.cateList[i].children
}

  4. 循环渲染右侧二级分类列表的 UI 结构：

    xml
    <!-- 右侧的滚动视图区域 -->
<scroll-view class="right-scroll-view" scroll-y :style="{height: wh + 'px'}">
  <view class="cate-lv2" v-for="(item2, i2) in cateLevel2" :key="i2">
    <view class="cate-lv2-title">/ {{item2.cat_name}} /</view>
  </view>
</scroll-view>

  5. 美化二级分类的标题样式：

    scss
    .cate-lv2-title {
  font-size: 12px;
  font-weight: bold;
  text-align: center;
  padding: 15px 0;
}

4.5 动态渲染右侧的三级分类列表 ​

注：三级分类就是右侧的每个最小项

  1. 在二级分类的 <view> 组件中，循环渲染三级分类的列表结构：

    xml
    <!-- 右侧的滚动视图区域 -->
<scroll-view class="right-scroll-view" scroll-y :style="{height: wh + 'px'}">
  <view class="cate-lv2" v-for="(item2, i2) in cateLevel2" :key="i2">
    <view class="cate-lv2-title">/ {{item2.cat_name}} /</view>
    <!-- 动态渲染三级分类的列表数据 -->
    <view class="cate-lv3-list">
      <!-- 三级分类 Item 项 -->
      <view class="cate-lv3-item" v-for="(item3, i3) in item2.children" :key="i3">
        <!-- 图片 -->
        <image :src="item3.cat_icon"></image>
        <!-- 文本 -->
        <text>{{item3.cat_name}}</text>
      </view>
    </view>
  </view>
</scroll-view>

  2. 美化三级分类的样式：

    scss
    .cate-lv3-list {
  display: flex;
  flex-wrap: wrap; //商品横向布局，自动换行

  .cate-lv3-item { //每一个商品的文本和图片需要竖向布局
    width: 33.33%; //每行三个
    margin-bottom: 10px;
    display: flex;
    flex-direction: column; //竖向布局
    justify-content: center; //垂直居中
    align-items: center; //横向居中

    image {
      width: 60px;
      height: 60px;
    }

    text {
      font-size: 12px;
    }
  }
}

4.6 切换一级分类后重置滚动条的位置 ​

  1. 在 data 中定义 滚动条距离顶部的距离：

    js
    data() {
  return {
    // 滚动条距离顶部的距离
    scrollTop: 0
  }
}

  2. 动态为右侧的 <scroll-view> 组件绑定 scroll-top 属性的值：

    xml
    <!-- 右侧的滚动视图区域，scroll-top属性是滚动条距离顶部的距离
注：如果 scroll-top属性 赋值前后的值一样，是不会进行滚动条重置的！！！
-->
<scroll-view class="right-scroll-view" scroll-y :style="{height: wh + 'px'}" :scroll-top="scrollTop"></scroll-view>

  3. 切换一级分类时，动态设置 scrollTop 的值：

    js
    // 选中项改变的事件处理函数
activeChanged(i) {
  this.active = i
  this.cateLevel2 = this.cateList[i].children

  // 添加如下代码：
  // 由于scroll-top属性的特性： 如果 scroll-top属性 赋值前后的值一样，是不会进行滚动条重置的
  // 让 scrollTop 的值在 0 与 1 之间切换：保证每次切换时，滚动条都在最上方（1px对于用户是感觉不出来的）
  this.scrollTop = this.scrollTop === 0 ? 1 : 0 

  // 可以简化为如下的代码：
  // this.scrollTop = this.scrollTop ? 0 : 1 //在js中，0相当于false，1相当于true
}

4.7 点击三级分类跳转到商品列表页面 ​

  1. 为三级分类的 Item 项绑定点击事件处理函数如下：

    xml
    <view class="cate-lv3-item" v-for="(item3, i3) in item2.children" :key="i3" @click="gotoGoodsList(item3)">
  <image :src="item3.cat_icon"></image>
  <text>{{item3.cat_name}}</text>
</view>

  2. 定义事件处理函数如下：

    js
    // 点击三级分类项跳转到商品列表页面
gotoGoodsList(item3) {
  uni.navigateTo({ //跳转到非tabBar页面
    url: '/subpkg/goods_list/goods_list?cid=' + item3.cat_id
  })
}

4.8 分支的合并与提交 ​

  1. 将 cate 分支进行本地提交：

    bash
    git add .
git commit -m "完成了分类页面的开发"

  2. 将本地的 cate 分支推送到码云：

    bash
    git push -u origin cate

  3. 将本地 cate 分支中的代码合并到 master 分支：

    bash
    git checkout master
git merge cate
git push

  4. 删除本地的 cate 分支：

    bash
    git branch -d cate