Tabbar 标签栏
使用场景如下:
- 底部导航栏,用于在不同页面之间进行切换
- 标签切换
- 选项卡
引用
js
import { Tabbar, TabbarItem, regist } from "litos-ui";
regist([Tabbar, TabbarItem]);
1
2
3
2
3
演示
导航栏模式
将 type
设置为 nav
[默认]; 通过 name
标记选项卡项,icon
标记渲染图标; 然后通过 slot="icon"
来渲染图标
选项卡模式
基础的、简洁的选项卡,设置 type
为 bar
。
卡片式
具有卡片风格的标签。只需要设置 type
属性为 card
就可以使选项卡改变为标签风格。 同时可以通过 gap
调整选项卡之间的间距。
排列方式
主轴的排列方式,只对 bar
类型生效。只需要将 justify-content
的属性设置为 justify-content 可用值即可。
API
Tabbar Attibutes
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
name | 选中的选项卡 | string | - |
type | 风格 | nav 、bar 、card | nav |
gap | 选项卡之间的间距 | number 、string | 0 |
justify-content | 主轴排列方式 | string | flex-start |
Tabbar Slots
名称 | 说明 |
---|---|
default | 只能为 l-tabbar-item 标签 |
Tabbar Events
事件名 | 说明 | 回调参数 |
---|---|---|
change | 选项卡切换时触发, e.detail.name 获取选中值 | (e: Event) |
TabbarItem
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
name | 选项卡项的名称, 必填 | string | - |
icon | 是否渲染图标 | off | - |
only-icon | 是否仅渲染图标 | off | - |
Tabbar CSS Variables
变量名 | 说明 | 默认值 |
---|---|---|
--l-tabbar-hover-color | 选项卡的鼠标悬浮时的颜色 | var(--l-primary-color-light1) |
--l-tabbar-active-color | 选项卡的选中时的颜色 | var(--l-primary-color) |
--l-tabbar-item-gap | 选项卡之间的间距 | 0 |
--l-tabbar-height | 选项卡的高度 | 38px [nav 时默认为: 50px ] |
--l-tabbar-line-color | 下划线的颜色 | var(--l-primary-color) |
--l-tabbar-card-border-color | 卡片选项卡的边框颜色 | #f5f7fa |
--l-tabbar-card-border-radius | 卡片选项卡的边框圆角 | 5px |