uni-app 自带的 tabbar
时间: 2025-04-08 22:21:48 浏览: 69
### uni-app 中自带 TabBar 的使用方法及配置教程
在 `uni-app` 开发框架中,TabBar 是一种常见的导航控件,用于实现多页面之间的切换功能。通过合理的配置,可以自定义 TabBar 的外观和行为。
#### 1. 基本概念
TabBar 可以通过全局配置文件 `manifest.json` 来设置其表现形式和关联的页面[^1]。它支持静态配置,也可以动态修改某些属性。
#### 2. 配置方式
以下是 TabBar 的具体配置步骤:
##### (1) 打开 `manifest.json`
进入项目的根目录,找到并打开 `manifest.json` 文件,在其中定位到 `"tabBar"` 字段。
##### (2) 设置基础参数
以下是一些常用的 TabBar 参数及其含义:
| 属性名 | 类型 | 描述 |
|----------------|----------|----------------------------------------------------------------------|
| list | Array | Tab 页面列表,每一项描述一个 Tab 页面的信息 |
| selectedColor | String | Tab 上的文字选中时的颜色 |
| color | String | Tab 上文字默认颜色 |
| backgroundColor| String | Tab 背景色 |
示例代码如下:
```json
{
"tabBar": {
"list": [
{
"pagePath": "pages/index/index",
"text": "首页",
"iconPath": "static/icons/home.png",
"selectedIconPath": "static/icons/home-active.png"
},
{
"pagePath": "pages/cart/cart",
"text": "购物车",
"iconPath": "static/icons/cart.png",
"selectedIconPath": "static/icons/cart-active.png"
}
],
"color": "#000000",
"selectedColor": "#FF0000",
"backgroundColor": "#FFFFFF"
}
}
```
上述代码表示设置了两个 Tab 页面:“首页” 和 “购物车”,分别指向不同的路径,并指定了图标、文字颜色等样式。
##### (3) 动态修改 TabBar
除了静态配置外,还可以通过 API 动态调整 TabBar 的状态或内容。例如隐藏/显示 TabBar 或更改某个 Tab 的徽章数。
- **隐藏/显示 TabBar**
使用 `uni.hideTabBar()` 方法可隐藏当前 TabBar;而 `uni.showTabBar()` 则重新显示。
示例代码:
```javascript
uni.hideTabBar({
animation: true // 是否启用动画效果
});
```
- **更新 Tab 徽章**
如果需要给某一个 Tab 添加消息提示(如未读数量),可以调用 `uni.setTabBarItem()` 修改特定 Tab 的内容。
示例代码:
```javascript
uni.setTabBarItem({
index: 1, // 对应第几个 Tab(从 0 开始)
text: '新购物车', // 更新文字
iconPath: '/static/new-cart-icon.png' // 更换图标
});
```
#### 3. 注意事项
- TabBar 的 `list` 数组长度不得超过 5 个,这是平台限制。
- 图标的大小建议控制在合理范围内(通常不超过 40px * 40px),以免影响视觉效果。
- 若需更复杂的交互逻辑,可通过事件监听配合动态接口完成。
---
### 总结
以上介绍了如何在 `uni-app` 中配置和使用 TabBar 控件的方法。无论是简单的静态配置还是高级的动态操作,都可以满足不同场景下的需求。
阅读全文
相关推荐

















