From 2b2a02fe885ca3f105ef7a3288b48d72e111d7f5 Mon Sep 17 00:00:00 2001
From: MSuMshk <2039814060@qq.com>
Date: Thu, 12 Mar 2026 09:20:46 +0800
Subject: [PATCH] feat: implement custom mini-program tab bar

---
 README.md                         |   1 +
 config/index.ts                   |   7 ++-
 mini/custom-tab-bar/index.js      |  49 +++++++++++++++
 mini/custom-tab-bar/index.json    |   3 +
 mini/custom-tab-bar/index.wxml    |  20 ++++++
 mini/custom-tab-bar/index.wxss    |  42 +++++++++++++
 src/components/tab-bar/index.vue  | 101 ------------------------------
 src/pages/home/index.config.ts    |   3 +-
 src/pages/home/index.vue          |  10 +--
 src/pages/home/styles/base.scss   |   5 --
 src/pages/menu/index.config.ts    |   3 +-
 src/pages/menu/index.vue          |   7 +--
 src/pages/orders/index.config.ts  |   3 +-
 src/pages/orders/index.vue        |   6 +-
 src/pages/profile/index.config.ts |   3 +-
 src/pages/profile/index.vue       |   6 +-
 src/utils/useTabBarSelection.ts   |  35 +++++++++++
 17 files changed, 176 insertions(+), 128 deletions(-)
 create mode 100644 mini/custom-tab-bar/index.js
 create mode 100644 mini/custom-tab-bar/index.json
 create mode 100644 mini/custom-tab-bar/index.wxml
 create mode 100644 mini/custom-tab-bar/index.wxss
 delete mode 100644 src/components/tab-bar/index.vue
 create mode 100644 src/utils/useTabBarSelection.ts

diff --git a/README.md b/README.md
index c023901..a36d828 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,7 @@ pnpm lint
 ## 目录结构
 - `src/pages`：按页面域拆分，每个页面保持 `index.vue + composables + styles`
 - `src/components`：复用组件目录，统一使用 `src/components/<kebab-name>/index.vue`
+- `mini/custom-tab-bar`：微信小程序原生 `custom-tab-bar` 源文件，会在构建时复制到 `dist/custom-tab-bar`
 - `src/stores`：`app`、`cart`
 - `src/services`：请求封装与 Mini API 领域接口
 - `src/shared`：类型、常量、mock 数据、格式化函数
diff --git a/config/index.ts b/config/index.ts
index 8a4cfb7..42e72d5 100644
--- a/config/index.ts
+++ b/config/index.ts
@@ -35,7 +35,12 @@ export default defineConfig<'vite'>(async (merge) => {
       __TENANT_CODE__: JSON.stringify(tenantCode)
     },
     copy: {
-      patterns: [],
+      patterns: [
+        {
+          from: 'mini/custom-tab-bar',
+          to: 'dist/custom-tab-bar'
+        }
+      ],
       options: {}
     },
     framework: 'vue3',
diff --git a/mini/custom-tab-bar/index.js b/mini/custom-tab-bar/index.js
new file mode 100644
index 0000000..47622d9
--- /dev/null
+++ b/mini/custom-tab-bar/index.js
@@ -0,0 +1,49 @@
+Component({
+  data: {
+    selected: 0,
+    list: [
+      {
+        pagePath: 'pages/home/index',
+        text: '首页',
+        iconPath: '../assets/tabbar/home.png',
+        selectedIconPath: '../assets/tabbar/home-active.png'
+      },
+      {
+        pagePath: 'pages/menu/index',
+        text: '点餐',
+        iconPath: '../assets/tabbar/menu.png',
+        selectedIconPath: '../assets/tabbar/menu-active.png'
+      },
+      {
+        pagePath: 'pages/orders/index',
+        text: '订单',
+        iconPath: '../assets/tabbar/orders.png',
+        selectedIconPath: '../assets/tabbar/orders-active.png'
+      },
+      {
+        pagePath: 'pages/profile/index',
+        text: '我的',
+        iconPath: '../assets/tabbar/profile.png',
+        selectedIconPath: '../assets/tabbar/profile-active.png'
+      }
+    ]
+  },
+  methods: {
+    setCurrent(index) {
+      this.setData({ selected: index })
+    },
+    switchTab(event) {
+      const index = Number(event.currentTarget.dataset.index)
+      const currentItem = this.data.list[this.data.selected]
+      const targetItem = this.data.list[index]
+      const currentPath = currentItem ? currentItem.pagePath : ''
+
+      if (!targetItem || currentPath === targetItem.pagePath) {
+        return
+      }
+
+      this.setData({ selected: index })
+      wx.switchTab({ url: `/${targetItem.pagePath}` })
+    }
+  }
+})
diff --git a/mini/custom-tab-bar/index.json b/mini/custom-tab-bar/index.json
new file mode 100644
index 0000000..467ce29
--- /dev/null
+++ b/mini/custom-tab-bar/index.json
@@ -0,0 +1,3 @@
+{
+  "component": true
+}
diff --git a/mini/custom-tab-bar/index.wxml b/mini/custom-tab-bar/index.wxml
new file mode 100644
index 0000000..e3ac504
--- /dev/null
+++ b/mini/custom-tab-bar/index.wxml
@@ -0,0 +1,20 @@
+<view class="custom-tab-bar">
+  <view
+    wx:for="{{list}}"
+    wx:key="pagePath"
+    class="custom-tab-bar__item"
+    data-index="{{index}}"
+    bindtap="switchTab"
+  >
+    <image
+      class="custom-tab-bar__icon"
+      src="{{selected === index ? item.selectedIconPath : item.iconPath}}"
+      mode="aspectFit"
+    />
+    <text
+      class="custom-tab-bar__label {{selected === index ? 'custom-tab-bar__label--active' : ''}}"
+    >
+      {{item.text}}
+    </text>
+  </view>
+</view>
diff --git a/mini/custom-tab-bar/index.wxss b/mini/custom-tab-bar/index.wxss
new file mode 100644
index 0000000..08cb746
--- /dev/null
+++ b/mini/custom-tab-bar/index.wxss
@@ -0,0 +1,42 @@
+.custom-tab-bar {
+  display: flex;
+  align-items: flex-start;
+  padding-top: 14px;
+  padding-bottom: calc(6px + constant(safe-area-inset-bottom));
+  padding-bottom: calc(6px + env(safe-area-inset-bottom));
+  min-height: 72px;
+  background: #ffffff;
+  border-top: 1rpx solid #e5e7eb;
+  box-shadow: 0 -4px 18px rgba(15, 23, 42, 0.05);
+}
+
+.custom-tab-bar__item {
+  flex: 1;
+  min-height: 44px;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: flex-start;
+}
+
+.custom-tab-bar__icon {
+  width: 26px;
+  height: 26px;
+  display: block;
+  flex-shrink: 0;
+  margin-bottom: -3px;
+}
+
+.custom-tab-bar__label {
+  display: block;
+  margin-top: 0;
+  font-size: 12px;
+  line-height: 1;
+  color: #64748b;
+  font-weight: 500;
+}
+
+.custom-tab-bar__label--active {
+  color: #16a34a;
+  font-weight: 600;
+}
diff --git a/src/components/tab-bar/index.vue b/src/components/tab-bar/index.vue
deleted file mode 100644
index 74d2212..0000000
--- a/src/components/tab-bar/index.vue
+++ /dev/null
@@ -1,101 +0,0 @@
-<template>
-  <view class="tab-bar">
-    <view
-      v-for="(item, idx) in tabs"
-      :key="item.pagePath"
-      class="tab-bar__item"
-      @tap="onSwitch(idx)"
-    >
-      <view class="tab-bar__icon">
-        <image
-          class="tab-bar__icon-img"
-          :src="current === idx ? item.activeIcon : item.icon"
-          mode="aspectFit"
-        />
-      </view>
-      <text
-        class="tab-bar__label"
-        :class="{ 'tab-bar__label--active': current === idx }"
-      >
-        {{ item.text }}
-      </text>
-    </view>
-  </view>
-</template>
-
-<script setup lang="ts">
-import Taro from '@tarojs/taro'
-
-import homeIcon from '@/assets/tabbar/home.png'
-import homeActiveIcon from '@/assets/tabbar/home-active.png'
-import menuIcon from '@/assets/tabbar/menu.png'
-import menuActiveIcon from '@/assets/tabbar/menu-active.png'
-import ordersIcon from '@/assets/tabbar/orders.png'
-import ordersActiveIcon from '@/assets/tabbar/orders-active.png'
-import profileIcon from '@/assets/tabbar/profile.png'
-import profileActiveIcon from '@/assets/tabbar/profile-active.png'
-
-defineProps<{ current: number }>()
-
-const tabs = [
-  { pagePath: '/pages/home/index', text: '首页', icon: homeIcon, activeIcon: homeActiveIcon },
-  { pagePath: '/pages/menu/index', text: '点餐', icon: menuIcon, activeIcon: menuActiveIcon },
-  { pagePath: '/pages/orders/index', text: '订单', icon: ordersIcon, activeIcon: ordersActiveIcon },
-  { pagePath: '/pages/profile/index', text: '我的', icon: profileIcon, activeIcon: profileActiveIcon }
-]
-
-function onSwitch(idx: number) {
-  Taro.switchTab({ url: tabs[idx].pagePath })
-}
-</script>
-
-<style lang="scss">
-.tab-bar {
-  display: flex;
-  align-items: center;
-  justify-content: space-around;
-  position: fixed;
-  bottom: 0;
-  left: 0;
-  right: 0;
-  height: 100px;
-  padding-bottom: env(safe-area-inset-bottom);
-  background-color: #fff;
-  border-top: 1rpx solid #e5e7eb;
-  z-index: 999;
-
-  &__item {
-    display: flex;
-    flex-direction: column;
-    align-items: center;
-    justify-content: center;
-    flex: 1;
-    padding: 8px 0;
-  }
-
-  &__icon {
-    width: 44px;
-    height: 44px;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    overflow: hidden;
-  }
-
-  &__icon-img {
-    width: 44px;
-    height: 44px;
-  }
-
-  &__label {
-    font-size: 20px;
-    color: #64748b;
-    margin-top: 2px;
-    line-height: 1.2;
-
-    &--active {
-      color: #16a34a;
-    }
-  }
-}
-</style>
diff --git a/src/pages/home/index.config.ts b/src/pages/home/index.config.ts
index 12abc5f..cd12ca7 100644
--- a/src/pages/home/index.config.ts
+++ b/src/pages/home/index.config.ts
@@ -1,3 +1,4 @@
 export default definePageConfig({
-  navigationBarTitleText: '首页'
+  navigationBarTitleText: '首页',
+  usingComponents: {}
 })
diff --git a/src/pages/home/index.vue b/src/pages/home/index.vue
index e00d5ae..de7681e 100644
--- a/src/pages/home/index.vue
+++ b/src/pages/home/index.vue
@@ -134,12 +134,6 @@
       </view>
     </view>
 
-    <!-- Bottom Spacer (TabBar safe area) -->
-    <view class="hp__spacer" />
-
-    <!-- Custom TabBar -->
-    <TabBar :current="0" />
-
     <!-- Floating Cart FAB -->
     <view v-if="cartCount > 0" class="hp__fab" @click="goMenu">
       <view class="hp__fab-ico">
@@ -154,9 +148,11 @@
 
 <script setup lang="ts">
 import { Search as IconSearch, Cart2 as IconCart, Scan2 as IconScan } from '@nutui/icons-vue-taro'
-import TabBar from '@/components/tab-bar/index.vue'
+import { useTabBarSelection } from '@/utils/useTabBarSelection'
 import { useHomePage } from './composables/useHomePage'
 
+useTabBarSelection(0)
+
 const {
   cartCount,
   categoryCards,
diff --git a/src/pages/home/styles/base.scss b/src/pages/home/styles/base.scss
index a532b87..be9ad6e 100644
--- a/src/pages/home/styles/base.scss
+++ b/src/pages/home/styles/base.scss
@@ -226,8 +226,3 @@
   flex-shrink: 0;
 }
 
-// ─── Bottom Spacer ───
-.hp__spacer {
-  height: 80px;
-  flex-shrink: 0;
-}
diff --git a/src/pages/menu/index.config.ts b/src/pages/menu/index.config.ts
index cb4fd10..64edf3a 100644
--- a/src/pages/menu/index.config.ts
+++ b/src/pages/menu/index.config.ts
@@ -1,3 +1,4 @@
 export default definePageConfig({
-  navigationBarTitleText: '点餐'
+  navigationBarTitleText: '点餐',
+  usingComponents: {}
 })
diff --git a/src/pages/menu/index.vue b/src/pages/menu/index.vue
index 84acab3..8ec1a22 100644
--- a/src/pages/menu/index.vue
+++ b/src/pages/menu/index.vue
@@ -102,9 +102,6 @@
       @change-qty="(key, delta) => cartStore.changeQuantity(key, delta)"
     />
 
-    <!-- Custom TabBar -->
-    <TabBar :current="1" />
-
     <!-- Spec Popup -->
     <SpecPopup
       v-if="detailVisible && activeDetail"
@@ -129,9 +126,11 @@
 import ProductCard from '@/components/product-card/index.vue'
 import CartDrawer from '@/components/cart-drawer/index.vue'
 import SpecPopup from '@/components/spec-popup/index.vue'
-import TabBar from '@/components/tab-bar/index.vue'
+import { useTabBarSelection } from '@/utils/useTabBarSelection'
 import { useMenuPage } from './composables/useMenuPage'
 
+useTabBarSelection(1)
+
 const {
   activeDetail,
   appStore,
diff --git a/src/pages/orders/index.config.ts b/src/pages/orders/index.config.ts
index 1ff18e0..4fac182 100644
--- a/src/pages/orders/index.config.ts
+++ b/src/pages/orders/index.config.ts
@@ -1,3 +1,4 @@
 export default definePageConfig({
-  navigationBarTitleText: '订单'
+  navigationBarTitleText: '订单',
+  usingComponents: {}
 })
diff --git a/src/pages/orders/index.vue b/src/pages/orders/index.vue
index c9c6f66..f4ea23f 100644
--- a/src/pages/orders/index.vue
+++ b/src/pages/orders/index.vue
@@ -62,17 +62,17 @@
       </view>
     </view>
 
-    <!-- Custom TabBar -->
-    <TabBar :current="2" />
   </view>
 </template>
 
 <script setup lang="ts">
 import { Button as NutButton, Empty, Price, Tag } from '@nutui/nutui-taro'
 import PageHero from '@/components/page-hero/index.vue'
-import TabBar from '@/components/tab-bar/index.vue'
+import { useTabBarSelection } from '@/utils/useTabBarSelection'
 import { useOrdersPage } from './composables/useOrdersPage'
 
+useTabBarSelection(2)
+
 const {
   activeTab,
   goMenu,
diff --git a/src/pages/profile/index.config.ts b/src/pages/profile/index.config.ts
index 2bd0633..36f20ab 100644
--- a/src/pages/profile/index.config.ts
+++ b/src/pages/profile/index.config.ts
@@ -1,3 +1,4 @@
 export default definePageConfig({
-  navigationBarTitleText: '我的'
+  navigationBarTitleText: '我的',
+  usingComponents: {}
 })
diff --git a/src/pages/profile/index.vue b/src/pages/profile/index.vue
index 99dc165..8386084 100644
--- a/src/pages/profile/index.vue
+++ b/src/pages/profile/index.vue
@@ -45,17 +45,17 @@
       </view>
     </view>
 
-    <!-- Custom TabBar -->
-    <TabBar :current="3" />
   </view>
 </template>
 
 <script setup lang="ts">
 import { Button as NutButton } from '@nutui/nutui-taro'
 import PageHero from '@/components/page-hero/index.vue'
-import TabBar from '@/components/tab-bar/index.vue'
+import { useTabBarSelection } from '@/utils/useTabBarSelection'
 import { useProfilePage } from './composables/useProfilePage'
 
+useTabBarSelection(3)
+
 const {
   customerStore,
   draftName,
diff --git a/src/utils/useTabBarSelection.ts b/src/utils/useTabBarSelection.ts
new file mode 100644
index 0000000..30c8f80
--- /dev/null
+++ b/src/utils/useTabBarSelection.ts
@@ -0,0 +1,35 @@
+import Taro, { useDidShow } from '@tarojs/taro'
+import { onMounted } from 'vue'
+
+type CustomTabBarInstance = {
+  setCurrent: (index: number) => void
+}
+
+function syncTabBarSelection(index: number, retries = 6) {
+  const page = Taro.getCurrentInstance().page
+
+  if (!page) {
+    return
+  }
+
+  const tabBar = Taro.getTabBar<CustomTabBarInstance>(page)
+
+  if (tabBar?.setCurrent) {
+    tabBar.setCurrent(index)
+    return
+  }
+
+  if (retries > 0) {
+    setTimeout(() => syncTabBarSelection(index, retries - 1), 16)
+  }
+}
+
+export function useTabBarSelection(index: number) {
+  onMounted(() => {
+    syncTabBarSelection(index)
+  })
+
+  useDidShow(() => {
+    syncTabBarSelection(index)
+  })
+}