bricks/docs/ai/line.md

ChartLine

控件功能：用于展示折线图，基于 ECharts 扩展实现，支持通过配置数据源、字段映射和图表选项动态生成多条折线的数据可视化。
类型：普通控件
父类控件：bricks.EchartsExt

初始化参数

参数名	类型	说明
data_url	string	（可选）获取图表数据的接口 URL，若提供则自动请求数据
data_params	object	（可选）发送请求时携带的参数，配合 data_url 使用
method	string	（可选）请求数据时使用的 HTTP 方法，默认为 'GET'
data	array	（可选）直接传入的静态数据数组，格式为对象数组，如 [{ name: 'A', value1: 10, value2: 20 }]
line_options	object	（可选）额外的 ECharts 系列配置项，用于自定义线条样式、动画等
nameField	string	指定数据中作为 X 轴显示的字段名称，例如时间或类别字段
valueFields	array	指定一个或多个数值字段，每个字段将生成一条折线，如 ['sales', 'profit']

注：data 和 data_url 可二选一；若两者都存在，优先使用 data_url 获取数据。

主要事件

• load
  触发时机：控件初始化并成功加载/渲染数据后触发。
  回调参数：{ chart: ECharts 实例, data: 当前渲染的数据 }
  用途：可用于在图表渲染完成后执行自定义逻辑，如添加标记点、绑定外部交互。

• click
  触发时机：用户点击图表中的某一点时触发。
  回调参数：ECharts 原生 click 事件对象，包含 seriesName, name, value, data 等信息。
  用途：实现数据点详情查看、联动其他组件等功能。

• datafetch
  触发时机：从 data_url 成功获取数据后，但在渲染之前触发。
  回调参数：{ data: 服务器返回的原始数据 }
  用途：可在数据处理前进行拦截和修改。