跳到主要内容

顶部选项卡

Tabs

适用场景

用于提供顶部的选项卡布局,支持切换多个选项标签

基础能力说明

使用选项卡组件可以实现页面的 Tab 切换效果,当在组件配置区点击新增选项卡标签时,在大纲树中会生成对应的内容插槽,我们可以通过在内容插槽中放置对应组件实现不同 Tab 的的内容构建,以下文为例:

  1. 在选项卡的两个内容插槽中分别添加两个文本组件,并为两个文本组件设置不同的内容

  2. 可以看到,当进行 Tab 切换时,不同的 Tab 便呈现出了不同的文本组件内容

    1. tab1
    2. tab2

扩展场景说明

切换选项卡标签时,动态过滤展示列表的不同数据

  1. 关闭组件的「启用多个插槽」属性
  2. 在「标签列表」属性按需设置选项标签,标签值写入要进行数据过滤的值
  3. 组件插槽中放入一个数据列表,绑定所需数据源
  4. 创建一个 tab 变量,文本类型
  5. 设置组件的「选项卡切换」事件触发变量赋值动作,为变量赋值表达式:event.detail.value,通过该方法,可以获取到选项卡组件当前切换展示的选项标签的「标签值」
  6. 数据列表组件的数据筛选属性中,配置筛选条件,将变量 tab 作为右值,参与过滤,即可实现切换选项卡标签式,动态筛选展示列表的不同数据

通过数据模型数据动态生成选项卡标签

  1. 创建 1 个数据模型,在其中新建一个状态名称字段
  2. 在该模型中录入几个状态的示例值,如:待发货、待收货、待评价
  3. 创建一个变量 tabs,数组类型,数据模型选择刚创建的模型
  4. 页面加载事件触发调用该数据模型的查看列表方法,查询该数据模型的列表数据,并将出参存入变量 tabs
  5. 关闭「启用多个插槽」属性,点击组件标签列表属性右侧的数据绑定模式按钮
  6. 点击变量属性右侧的数据绑定按钮,变量属性绑定该 tabs 变量
  7. 标签名称和标签值属性输入数据模型中状态名称字段的字段标识,即可发现选项卡标签名称展示为了数据模型中提前录入的数据

属性介绍

组件接收的外部传入的属性

属性名
属性标识
类型
说明
启用多个插槽isMultipleSlotboolean

启用多个插槽后,不支持给标签列表绑定动态数据

示例:true

标签列表tabsarray

更改选项卡标签的标题

示例:[ { "title": "标签1", "value": "标签1" }, { "title": "标签2", "value": "标签2" }, { "title": "标签3", "value": "标签3" } ]

选中标签selectedIndexnumber

当该属性绑定动态值时,请传入从0开始的整数索引值

示例:0

事件介绍

组件暴露的事件,可以监听组件的事件来触发一些外部的动作

事件名
事件code
事件出参 event.detail
适用情况
说明
选项卡切换changeobject
  • value: string选中的标签值 默认值:
兼容三端

通过事件可以获取到选中的选项卡信息,在该事件的处理方法中可以通过 event.detail.value 来获取选中的标签值