区块组件
区块组件
区块是基于一个或多个组件封装的黑盒工具，对内封装业务相关的组件样式、组件布局、数据配置、交互事件、节点编程等业务逻辑，对外可定义抛出的事件、动作等操作。
在使用区块时，将区块作为一个整体，无需关注内部逻辑，只需要设置对外定义的区块接口即可。
区块可以帮助用户提炼常用功能、沉淀业务场景、模块化功能复用、提高开发效率。
进入区块管理页面操作步骤如下：
登录河图账号。
在主界面选择数据可视化窗口。
点击左侧边栏
我的组件按钮进入区块管理页面。
新建
新建空白区块
操作步骤如下：
进入区块管理页面。
选择新建： 点击页面右上角新建。
填写新建空白区块信息：
区块名称： 输入区块名称。
区块编码： 输入编码。编码具有唯一性，用于区块标识。
区块尺寸： 设置区块尺寸，默认为 800*800。
序号（可选）： 设置序号，指定新建空白区块在区块列表中的位置。
点击创建，完成创建区块并进入区块设计器。
区块模板创建
操作步骤如下：
进入区块管理页面。
选择新建： 点击页面右上角新建。
切换区块类型： 点击新建弹窗左上角的
区块模版创建，从展示的区块列表中选择想要使用的模版区块。
复制区块： 点击模版区块上的复制按钮填写区块名称，点击确定后会将复制的区块存储到用户所在目录。
编辑
用户可以对已创建的区块进行编辑，包括修改布局、调整图表、更新数据等。
操作步骤如下：
进入区块管理页面： 在区块管理页面中，找到需要编辑的区块文件。
点击编辑区块： 鼠标悬停在区块上，点击编辑大屏。
编辑： 具体操作查看区块设计器。
节点编程
操作步骤如下：
进入区块管理页面： 在区块管理页面中，找到需要编辑的区块文件。
点击节点编程： 鼠标悬停在区块上，点击节点编程。
编辑： 具体操作查看节点编程。
预览
预览功能允许用户在发布前查看区块的显示效果，确保布局、数据和交互符合预期。
操作步骤如下：
进入区块管理页面： 在区块管理页面中，找到需要预览的区块文件。
点击预览： 鼠标悬停在区块上，点击预览。
查看效果： 在新页面中查看区块的显示效果，检查布局是否合理、数据是否准确、交互是否流畅。
发布
进入区块管理页面： 在区块管理页面中，找到需要预览的区块文件。
点击发布： 鼠标悬停在区块上，点击发布。
发布历史
发布历史记录每次发布的版本信息，帮助用户追踪区块的变更历程。
操作步骤如下：
进入区块管理页面
选择发布历史： 鼠标悬停在区块上，点击
...选择发布历史。查看历史版本： 可查看版本、发布人、发布时间。
恢复历史版本： 需要恢复到某个历史版本，点击右侧的
按钮。删除历史版本： 需要删除某个历史版本，点击右侧的
按钮。
发布为模板
将区块发布为模板，供其他用户复制和使用。具体请参见发布为模板。
区块设计器 4.5+
区块设计器是区块编辑最主要的功能区域。区块的组件配置、布局样式、配色方案、以及数据资源与图表之间的绑定都在设计器中完成。
区块主题： 用于设置区块主题样式，当不设置区块主题的时候，在大屏中使用区块时，将使用大屏主题。
缩放方式： 区块的缩放方式，在区块中使用区块，当改变区块宽高时，会根据区块内设置的缩放方式展示。
1:1：大屏中改变区块组件宽高，当宽高大于区块默认尺寸的时，区块组件完整显示；当宽高小于区块默认尺寸时，区块组件显示滚动条；
裁剪：大屏中改变区块组件宽高，当宽高大于区块默认尺寸的时，区块组件完整显示；当尺寸小于区块原来的大小时做相应裁剪；
全屏铺满：大屏中改变区块组件宽高，区块内容根据调整自适应铺满；
等比缩放宽度铺满：大屏中改变区块组件宽高，区块内容根据调整宽度等比缩放；
等比缩放高度铺满：大屏中改变区块组件宽高，区块内容根据调整高度等比缩放；
区块节点说明
区块定义内部和外部的数据传输、事件交互，都依靠节点编程中的事件节点和动作节点进行配置。
区块事件
用于接收内部组件的事件，并向外抛出数据。
添加区块事件
事件列表
① 名称：设置事件名称。
② 描述：事件描述信息。
③ 数据：上游组件传递的数据，包含字段名、中文名、字段类型、备注等字段。
区块动作
用于接收外部组件触发的动作，并使得内部组件执行相应的业务逻辑。
添加区块动作
动作列表
① 名称：设置动作名称。
② 描述：动作描述信息。
③ 数据：上游组件传递的数据，包括字段、名称、说明、类型、必填、默认值等字段。
使用区块 4.5+
大屏添加区块
在大屏设计器右侧区找到区块列表，拖拽区块添加至当前大屏使用。
右键菜单操作
区块右键： 大屏内选中区块右键。
区块编辑器：
大屏内新增区块：点击【区块编辑器】菜单直接进入区块编辑器。
当大屏从资源广场创建，且已经包含区块组件：点击【区块编辑器】菜单，先提示创建区块，再进入区块编辑器。
刷新区块：在不刷新整个页面的情况下，区块区域刷新。
恢复默认尺寸：恢复区块原始尺寸。
组件右键： 大屏内多选组件右键。
- 导出为区块：多选大屏上组件，导出为区块，默认发布。
示例展示
区块向大屏传值
目标： 实现在大屏内部，区块组件内部数据和状态向大屏组件传递。
1、使用按钮组切换大屏内组的轮播。
2、点击饼图将扇区数据传递给大屏的数据卡片，并且数字大于 30 的显示红色，小于 30 显示蓝色。
实现：
1.1、新建区块，添加按钮组并设置相应数据，保存，发布；
1.2、进入区块节点编程，新增区块【按钮组点击索引】事件，并且与按钮组、转换器相互关联
1.3、新建大屏，拖拽使用区块，大屏内部新建轮播组，新建大屏变量池 index 变量，保存；
1.4、进入大屏节点编程，通过区块的事件，经过转化器设置交互变量，保存，预览；
2.1、区块内新增饼图，并设置数据，发布；
2.2、进入区块节点编程，新增【饼图扇区点击】事件，关联饼图和区块事件；
2.3、在大屏中，拖拽使用区块，大屏内部使用数字卡片并设置数据，保存；
2.4、进入大屏节点编程，使用区块扇区点击事件，经过转换器导入数据和更新数字卡片样式，预览；
大屏向区块传值
目标： 实现在大屏内部，大屏组件向区块组件传值。
1、点击地图散点，传递省名称给区块的仪表盘组件，仪表盘根据省名称查询对应省的数量。
实现：
1.1、在区块内，添加仪表盘组件相应数据，设置变量池，交互绑定数据响应，保存，发布；
1.2、进入区块节点编程，新增区块【更新 province 变量】动作，并新增转换器、设置变量且关联；
1.3、在大屏中，拖拽使用区块，大屏内部使用中国地图组件；
1.4、进入大屏节点编程，使用中国地图组件散点层，转换器，区块等节点，响应关联，预览；
