bricks/aidocs/line.md

bricks.ChartLine 技术文档

基于 ECharts 扩展的折线图组件，用于快速渲染多系列折线图。

---

概述

bricks.ChartLine 是 bricks.EchartsExt 的子类，封装了基于 ECharts 的折线图配置逻辑。它支持从远程数据源或本地数据动态生成折线图，并自动构建图表所需的 options 配置对象。

该组件通过工厂模式注册为 'ChartLine' 类型，可通过 bricks.Factory.create('ChartLine', config) 实例化。

---

依赖

• bricks.EchartsExt：基础 ECharts 扩展类。
• bricks.Factory：用于组件注册与创建的工厂类。

---

属性（配置项）

属性名	类型	必填	描述
data_url	String	否	数据请求的 URL 地址。若提供，则通过 AJAX 获取数据。
data_params	Object	否	请求数据时携带的参数（GET 或 POST）。
method	String	否	请求方法，默认为 'GET'。可选 'POST'。
data	Array	否	直接传入的本地数据数组，格式为对象数组。例如：[{name: 'A', value1: 10, value2: 20}]。
line_options	Object	否	自定义 ECharts 配置的扩展选项，会合并到最终的 options 中。
nameField	String	是	用作 X 轴分类字段的键名（如时间、类别等）。
valueFields	Array	是	一个字符串数组，表示需要绘制为折线的字段名称（Y 轴数据）。每个字段将生成一条折线。

⚠️ 注意：data 和 data_url 二选一。若两者都存在，优先使用 data_url 异步加载数据。

---

方法

values_from_data(data, name)

从数据数组中提取指定字段的所有值。

参数

• data (Array