选项卡

文档基于选项卡v1.4.27版本

组件说明

选项卡组件可以通过网格布局、背景、选中样式等配置项修改组件样式；常用于多组件、多页面之间的效果切换，用于交互效果的实现。

效果案例

如下案例所示，通过“显示/关闭”选项卡切换组件间显藏状态，通过“abc”选项卡切换基本面积图组件状态。

一、样式

在样式中可以设置组件的基本属性、全局、样式和数据系列。

1、基本属性

位置尺寸

位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。

尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。

基本柱状图组件尺寸不影响组件内容显示、组件动画。

默认隐藏

勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制。

2、全局

在全局配置中可以调整组件默认选中、自动轮播、文字、网格布局、滚动条。

默认选中

默认状态下选项卡选中选项：默认配置为1，若删除该项即为0时默认不选中任何选项。当设置为1时会自动选择选项卡中的第一个选项，同理设置为2即第二个选项。

文字

在文字中可以针对选项卡中的选项进行调整，包括文字横排/竖排显示和垂直对齐方式。

网格布局

在网格布局中可以调整选项卡的布局，如下示例图所示，将布局调整为2行2列，在数据中写好数据后则显示2x2的数据。

在间距中可以针对行距和列距再调整。

自动轮播

自动轮播即选项卡内选项会按排序自动轮播选项，当开启自动轮播后，可以设置间隔时长和点击停留时间。

如下示例所示，当开启自动轮播功能后，设置了2s的间隔时长，3s的点击停留；预览效果可以看到示例图片通过设置好的2s的间隔时长自动切换显隐状态，当点击“显示”时图片停留了3s后选项卡自动切换到了关闭状态。

滚动条

当选项卡默认关闭，当点击“眼睛”图标开启后，可以设置滚动条的粗细，轨道和滑块。

如下示例图所示，将粗细调整为10，轨道颜色设置为“绿色”，将滑块颜色设置为了“蓝色”。

组件联动

回调参数的值和选项卡匹配时会触发选项卡切换。

如下示例所示，三个选项卡配置相同的回调值后，点击一个选项卡即会触发另外组件选项切换。

允许取消选中

开启允许取消选中后，再点击选中的选项卡就能取消选中状态。

3、样式

样式分为默认/选中两个不同情况，配置项相同，当前以默认情况为例。

文字

文本样式：

当有特定字体需求时，对坐标轴显示字体进行调整，可以对字体、字体大小、字体颜色、加粗、斜体、字距、行距进行设置。当需要调整时，可以根据效果逐步修改。

偏移：

偏移用来调整选项文字的偏移量，以px为单位在“选项框内”进行偏移。

阴影：

选项卡按钮未选中时的文字阴影，如下示例图所示将阴影调整为了粉色，可以通过x/y模糊/扩展四项配置进行进一步调整。

背景

背景可以设置为颜色或者自定义图片两种背景方式。

如下示例图所示将背景填充方式设置为蓝色：

如下示例图所示将背景填充方式设置为一张纯色底图：

描边

描边设置的是选项卡内选项的描边程度，如下示例图所示，为凸显配置将选项粗细设置为8，还可以通过颜色进行进一步调整。

图标

默认为关闭图标，可以选择开启。

图标为选项卡每个选项前的小图片，可以自行上传图片修改。同时可以修改图标的尺寸和在选项卡中的显示边距。

4、系列

数据系列

在数据系列中，可以针对某个选项卡进行个性化的设定，如下示例图所示，"s"字段值为1即针对数据中"s"值为1的"Tab A"选项进行了整体偏移。

数据系列配置项说明：

背景可自定义图片或者颜色，当选择为颜色时可进一步配置默认颜色和选中颜色；

当选择为自定义时，可进一步设置默认图片和选中图片样式。

二、数据

组件数据格式

*数据格式说明

JSON数据案例

[
	{
		"s": "1",
		"content": "Tab A"
	},
	{
		"s": "2",
		"content": "Tab B"
	},
	{
		"s": "3",
		"content": "Tab C"
	},
	{
		"s": "4",
		"content": "Tab D"
	}
]

数据对接详情

数据对接详情请见以下文档👇

项目交付——数据对接入门

三、交互

载入动画

所有组件均提供移入、移入(小)、划变三种组件载入动画。

载入动画选择无时，则组件没有载入动画。

载入动画仅在可视化应用预览、发布组件加载时显示。

载入动画配置项：

回调参数

回调参数即为全局性的参数变量，用于控制组件之间参数的传递，可通过设置回调参数来实现数据驱动交互。

其中，字段值即参数变量，变量名即对字段值的重命名。

详细的回调参数教学👉 回调的使用

如下示例中拖过“abc”选项卡中发出的不同参数来控制基本面积图不同的状态。

首先看下“abc”选项卡中的数据，“user”字段设置为了“abc”不同参数

在设置回调参数时，将“user”字段作为字段值以“user”作为变量名（变量名可任意英文字母，当前示例以user作为示例）的方式发出参数进而控制基本面积图中“abc”数据的不同状态

自定义事件

简单而言，自定义事件通过事件类型+条件去控制其他组件的不同状态。

❗需要注意的是，若要配置不同选项配置其他不同组件，需要添加不同s=n（第几个选项）条件的多个鼠标点击事件。

自定义事件为「交互事件」的增强模块，支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑。

详细的自定义事件教学👉自定义事件教学

教学视频：

📎选项卡 基础版..mp4

选项卡切换教程展示：

欢迎您在评论区留下您对该组件的意见，管理员会及时回复您，如长时间未回复欢迎您搜索钉钉群：33782396或者扫描以下二维码添加微信群说出您的想法，采纳后将送出定制礼品。

也可以通过问卷来向我们反馈需求：https://jinshuju.net/f/XyCXU0