haiyang 1029488707 权重页面bug修改 3 weeks ago
..
README.md 52c3bdbbc6 feat: 券中心微信小程序初始化 1 month ago
config.ts 1029488707 权重页面bug修改 3 weeks ago
index.vue 1029488707 权重页面bug修改 3 weeks ago
store.ts 1029488707 权重页面bug修改 3 weeks ago
types.ts 52c3bdbbc6 feat: 券中心微信小程序初始化 1 month ago

README.md

tabbar 说明

tabbar 4种策略

tabbar 分为 4 种 情况:

  • 0 无 tabbar,只有一个页面入口,底部无 tabbar 显示;常用语临时活动页。

  • 1 原生 tabbar,使用 switchTab 切换 tabbartabbar 页面有缓存。

    • 优势:原生自带的 tabbar,最先渲染,有缓存。
    • 劣势:只能使用 2 组图片来切换选中和非选中状态,修改颜色只能重新换图片(或者用 iconfont)。
  • 2 有缓存自定义 tabbar,使用 switchTab 切换 tabbartabbar 页面有缓存。使用了第三方 UI 库的 tabbar 组件,并隐藏了原生 tabbar 的显示。

    • 优势:可以随意配置自己想要的 svg icon,切换字体颜色方便。有缓存。可以实现各种花里胡哨的动效等。
    • 劣势:首次点击 tabbar 会闪烁。
  • 3 无缓存自定义 tabbar,使用 navigateTo 切换 tabbartabbar 页面无缓存。使用了第三方 UI 库的 tabbar 组件。

    • 优势:可以随意配置自己想要的 svg icon,切换字体颜色方便。可以实现各种花里胡哨的动效等。
    • 劣势:首次点击 tababr 会闪烁,无缓存。

注意:花里胡哨的效果需要自己实现,本模版不提供。

tabbar 配置说明

  • 如果使用的是 原生tabbar,需要配置 nativeTabbarList,每个 item 需要配置 pathtexticonPathselectedIconPath 等属性。
  • 如果使用的是 自定义tabbar,需要配置 customTabbarList,每个 item 需要配置 pathtexticoniconType 等属性(如果是 image 图片还需要配置2种图片)。

文件说明

config.ts 专门配置 nativeTabbarListcustomTabbarList 的相关信息,请按照文件里面的注释配置相关项。

使用 原生tabbar 时,不需要关心下面2个文件:

  • store.ts ,专门给 自定义 tabbar 提供状态管理,代码几乎不需要修改。
  • index.vue ,专门给 自定义 tabbar 提供渲染逻辑,代码可以稍微修改,以符合自己的需求。

自定义tabbar的不同类型的配置

  • uniUi 图标

    {
    // ... 其他配置
    "iconType": "uniUi",
    "icon": "home",
    }
    
  • unocss 图标

    {
    // ... 其他配置
    // 注意 unocss 图标需要如下处理:(二选一)
    // 1)在fg-tabbar.vue页面上引入一下并注释掉(见tabbar/index.vue代码第2行)
    // 2)配置到 unocss.config.ts 的 safelist 中
    iconType: 'unocss',
    icon: 'i-carbon-code',
    }
    
  • iconfont 图标

    {
    // ... 其他配置
    // 注意 iconfont 图标需要额外加上 'iconfont',如下
    iconType: 'iconfont',
    icon: 'iconfont icon-my',
    }
    
  • image 本地图片

    {
    // ... 其他配置
    // 使用 ‘image’时,需要配置 icon + iconActive 2张图片(不推荐)
    // 既然已经用了自定义tabbar了,就不建议用图片了,所以不推荐
    iconType: 'image',
    icon: '/static/tabbar/home.png',
    iconActive: '/static/tabbar/homeHL.png',
    }