更新记录

1.0.0(2025-03-20)

  • 新增 tab-bar 组件

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue app-nvue
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
×

tab-bar

现代化底部导航栏组件

介绍

一个基于 uni-app 的现代化底部导航栏组件,采用 Google Material Design 设计风格,配合精美的毛玻璃效果,提供出色的视觉体验。

特性

  • 🎨 现代毛玻璃设计
  • 🌈 优雅的动画过渡
  • 📱 完美支持 iPhone 安全区域
  • 💪 跨平台兼容(H5、App、小程序)
  • 🎯 精确的视觉反馈
  • ✨ 精致的视觉细节

使用方法

安装依赖

本组件依赖 uni-icons 组件,请确保项目中已安装:

  1. 在插件市场打开 uni-icons
  2. 点击"使用 HBuilderX 导入插件"
  3. 或者点击"下载插件ZIP",解压到项目的 uni_modules 目录

引入组件

<tab-bar 
  :current="current" 
  :tab-list="tabList" 
  @change="handleChange"
/>

配置参数

data() {
  return {
    current: 0,
    tabList: [
      {
        text: '首页',
        icon: 'home',            // uni-icons 的图标名
        selectedIcon: 'home-filled'  // 选中时的图标名
      },
      {
        text: '分析',
        icon: 'chart',
        selectedIcon: 'chart-filled'
      },
      // ... 更多选项
    ]
  }
}

可用图标

组件使用 uni-icons 图标库,以下是推荐的图标搭配:

功能 默认图标 选中图标
首页 home home-filled
分类 grid grid-filled
发现 star star-filled
消息 chat chat-filled
我的 person person-filled
设置 settings settings-filled
收藏 heart heart-filled
订单 list list-filled
购物车 cart cart-filled
搜索 search search
通知 notification notification-filled
分析 chart chart-filled

更多图标请参考 uni-icons 文档

API

Props

参数 说明 类型 默认值
current 当前选中标签的索引值 Number 0
tabList 标签配置列表 Array []

tabList 项配置

参数 说明 类型 必填
text 标签文本 String
icon 未选中时的图标(使用uni-icons图标名) String
selectedIcon 选中时的图标(使用uni-icons图标名) String

Events

事件名 说明 回调参数
@change 切换标签时触发 index: 选中项的索引值

样式定制

组件采用 SCSS 编写,主要样式变量:

// 主题色
$primary-color: #018786;

// 文字颜色
$text-color: rgba(0, 0, 0, 0.65);

// 选中状态背景
$active-bg: rgba(1, 135, 134, 0.08);

平台差异说明

H5/小程序

  • 自动适配底部安全区域
  • 支持毛玻璃效果

App

  • 根据机型自动调整底部间距
  • 完整支持所有动画效果

更新日志

1.0.0

  • 全新的毛玻璃视觉设计
  • 优化动画过渡效果
  • 改进跨平台兼容性
  • 完善底部安全区域适配

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问