基础多边形层(v4.x版本)

本文介绍基础多边形层各配置项的含义。

图表样式

基础多边形层是基础平面地图 4.0的子组件,支持独立的样式、数据和交互配置,包括区域的颜色、边线、鼠标交互事件以及位置信息等,以瓦片形式表现地理位置上的区域信息。

以下为该图层支持呈现的效果。

image

样式面板

image

说明

样式面板中设置交互效果时,点击和悬浮显示方式相关配置仅在预览、发布或启用交互模式时可见。

  • 搜索配置:单击样式面板右上角的搜索配置项图标image,可在搜索配置面板中输入您需要搜索的配置项名称,快速定位到该配置项,系统支持模糊匹配。详情请参见搜索配置项

  • 通用:设置基础多边形层的通用配置参数项。

    参数

    说明

    可见级别

    设置基础多边形层的可见级别,在设定的级别范围内基础多边形层可见,级别之外不可见。

    不透明度

    设置基础多边形层的不透明度,取值范围为0~100,单位%。数值越大热力层样式越不透明。

  • 图形:设置基础多边形层的图形样式参数项。

    参数

    说明

    填充颜色

    配置区域的颜色样式,数据中最大、最小及为空的value值对应区域的颜色。请参见颜色映射器使用说明,配置不同区域的映射颜色样式。

    描边样式

    基础多边形层各区域边线的颜色、粗细和线的类型。

    说明

    线型支持数字输入,如:4,4,第一个数字表示实线长度,第二个数字表示间隔长度。

  • 交互:基础多边形层的交互配置项。

    图形交互:单击左侧的眼睛图标图标,可控制是否开启图形交互功能。

    参数

    说明

    悬停样式

    单击悬停样式左侧眼睛图标图标,可控制悬停交互功能的开启或关闭。开启后可设置鼠标悬停时区域的填充颜色、区域描边线颜色和粗细,仅在预览发布或开启交互模式时才能看到效果。

  • 条件:条件样式说明,通过条件筛选将满足条件的区域配置为特殊颜色。

    条件样式:设置特殊的条件,具体请参见条件树使用说明

    图形:打开开关,配置该样式中的图形配置项;关闭开关,无法配置该样式下的图形配置项。

    参数

    说明

    填充颜色

    单击左侧的眼睛图标图标,可控制是否应用该条件下的区域填充颜色。

  • 自定义弹框样式:设置基础多边形层内自定义弹框的样式参数。请设置 info 字段作为弹框内容,info 支持配置 HTML 片段。

    参数

    说明

    弹框开关

    打开开关,可以通过点击悬浮触发弹框。

    显示方式

    设置基础多边形层弹框显示的方式,包括点击悬浮两种方式。

    相对偏移

    设置弹窗在水平和垂直方向的相对偏移像素距离,取值范围为-1000~1000,单位px。

    文本样式

    设置弹框内的文本样式,包括文本的字体样式、字号大小、颜色和文本粗细值。

    显示空值

    打开开关,在无info字段或空info字段对象上可以弹框显示为“无数据”,关闭开关时,对于无info字段的数据,交互不会弹出对应的弹框。

    弹框样式

    • 内边距:设置弹框文本的内容距离上下左右四个方向的边距值。

    • 边框样式:设置弹框边框的圆角值、线宽和颜色。

    • 背景颜色:设置弹框的背景颜色。

    • 投影样式:设置弹框投影的模糊色、模糊半径、X偏移和Y偏移。

    • 关闭按钮:打开开关,基础多边形层的弹框显示关闭按钮和按钮的颜色。

    • 指向箭头:打开开关,基础多边形层的弹框显示指向箭头。

数据源面板

image

图层数据源需带有业务数据的geojson格式数据,具体可参见示例数据。字段映射如下:

字段

说明

colorField

可选,地区的颜色映射字段。

info

可选,自定义弹窗内容。

popupType

可选,弹窗类型(需要搭配二次开发功能使用)。

数据项配置

说明

数据源

组件的数据源中通过代码编辑可视化编辑展示了组件所包含的数据字段。也可以修改数据类型,灵活配置组件数据。

数据映射

当您需要自定义图表字段配置时,可以在数据映射模块设置不同的字段映射内容,将这些字段映射到组件对应的字段上。无需修改数据源中的字段,就可以实现数据的实时匹配。也可以单击image图标对字段分别样式配置。

过滤器

打开过滤器,选择已创建的数据过滤器或新建数据过滤器,并配置数据过滤器脚本,实现数据的筛选功能。详情请参见管理数据过滤器

数据响应结果

实时展示了组件所使用的数据。当组件数据源发生变化时,数据响应结果会对应展示最新的数据。如果系统反应延迟,您可以单击右侧的image图标,查看数据响应结果,也可以单击右侧的image图标,获取组件的最新数据。您也可以单击查看示例,查看当前组件的响应结果示例。

禁止加载态

勾选复选框,在组件更新和预览数据看板时,将看不到组件初始化时的加载内容,去勾选则相反。默认为去勾选状态。

受控模式

勾选复选框,组件初始化状态下不请求数据,仅通过全局变量或蓝图编辑器配置的方法发起请求数据;去勾选复选框,可以使用自动更新请求数据。默认为去勾选状态。

自动更新请求

勾选复选框,可以手动输入轮询的时间频次设置动态轮询。清除后则不会自动更新,需要手动刷新页面,或通过蓝图编辑器和全局变量事件来触发请求更新数据。

高级面板

image

通过高级面板配置交互事件或关联全局变量,实现组件之间的联动。具体操作请参见组件交互配置

蓝图交互

  1. 单击页面左上角的image图标,进入蓝图页面。

  2. 图层节点页签下,添加当前组件至主画布中。

  3. 查看蓝图配置参数。image

    说明

    图层事件和动作的参数提示信息,可以在画布右侧的锚点配置中单击image图标查看。

    • 事件

      事件

      说明

      当数据更新时

      当数据返回结果发生变化时触发事件并抛出数据。

      当数据请求状态变化时

      当数据请求状态发生变化时(例如,返回成功或失败状态)触发事件并抛出数据。

      当点击区域时

      当单击图层某区域时触发事件并抛出数据。

      当双击区域

      当双击图层某区域时触发事件并抛出数据。

      当点击图层外区域时

      当单击图层外区域时触发事件并抛出数据。

      当鼠标移入要素时

      当鼠标移入图层的某区域时触发事件并抛出数据。

      当鼠标移出要素时

      当鼠标移出图层的某区域时触发事件并抛出数据。

      当鼠标在要素上移动时

      当鼠标在图层的某区域移动时触发事件并抛出数据。

      组件加载完成

      数据接口请求返回并经过过滤器处理后抛出的事件,同时抛出处理后的JSON格式的数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据源页签的数据响应结果区域。

    • 动作

      动作

      说明

      导入接口

      按组件绘制格式处理数据后,导入组件,重新绘制。不需要重新请求服务端数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据源页签的数据响应结果区域。

      请求接口

      重新请求服务端数据,上游数据处理节点或图层节点抛出的数据将作为参数。例如基础多边形层配置了API数据源为https://api.test,传到请求数据接口动作的数据为{ id: '1'},则最终请求接口为https://api.test?id=1

      切换显隐

      切换显隐显示隐藏组件默认不需要参数,可以按需添加动画配置,参考数据示例。

      {
        //动画方式,可选值为:appear|fade|slideToUp,默认值为 fade,不填无动画。
        "animationType": "fade",
        //动画延迟,默认值为1000,单位ms。
        "animationDuration": 1000,
        //动画曲线,可选值为:linear|easeInOutQuad|easeInOutExpo,默认值为 linear。
        "animationEasing": "linear"
      }

      显示

      隐藏

      更新组件配置

      动态更新组件的样式配置。需要先在组件的样式面板中,单击复制配置到剪贴板,获取组件配置数据。再根据需要在蓝图编辑器配置页面的数据处理节点中更改对应样式的字段值。