candle的用法 基础操作
candle的用法核心在于把一组按周期整理的数据映射到图形组件里，用于呈现数值区间变化。你可以将数据中的起始值、最大值、最小值、结束值分别对应到 candle 的配置字段，再设置周期、宽度、颜色、图例和坐标轴，就能生成适合报表、分析页面、数据展示场景使用的图形。实际项目中，candle的用法通常用于展示连续区间数据，例如行情类、交易类、指标类、时间序列类图表。只要数据源清晰，字段映射准确，渲染容器配置完整，就可以稳定输出图形内容。
使用要点
使用 candle 时，可以先从数据、图形、交互三个方面配置。
- 数据方面：准备好每个周期对应的起始值、最大值、最小值、结束值。
- 图形方面：设置显示宽度、填充方式、边框样式、颜色搭配。
- 交互方面：设置缩放、平移、提示框、图例显示。
- 页面方面：指定绘图区域尺寸，适配报表容器和分析页面。
- 输出方面：配置坐标轴、网格线、标题、图例和周期标签。
字段配置清单
| 配置项 | 作用 | 常用写法 |
|---|---|---|
| 数据源 | 提供每个周期的数值内容 | 数组、表格字段、接口返回值 |
| 周期字段 | 标识每个图形对应的时间或顺序 | 日期、时间戳、序号 |
| 起始值 | 对应 candle 图形的一侧位置 | open、begin、start |
| 最大值 | 对应图形上边缘 | high、max |
| 最小值 | 对应图形下边缘 | low、min |
| 结束值 | 对应 candle 图形的另一侧位置 | close、end、finish |
| 图例名称 | 显示在图形右上角或标题区域 | name、title、series |
| 颜色配置 | 控制图形填充和边框显示 | color、fillColor、borderColor |
操作流程
- 准备数据列表，把每个周期整理成一行记录。
- 将周期字段设置为横轴依据，例如日期、时间、序号。
- 将起始值、最大值、最小值、结束值分别映射到 candle 图形字段。
- 设置图形宽度，使多个周期在页面上排列清晰。
- 配置填充色、边框色、图例名称和标题文字。
- 开启坐标轴、网格线、缩放和平移功能。
- 将图形渲染到指定容器，并在页面中检查显示效果。
- 根据报表或分析页面需求微调样式、布局和字段说明。
常用参数说明
| 参数方向 | 说明 | 使用建议 |
|---|---|---|
| 宽度 | 控制每个 candle 图形的粗细 | 周期较多时可适当收窄 |
| 颜色 | 区分不同数值状态 | 搭配图例和标题更易识别 |
| 边框 | 增强图形轮廓 | 页面背景较浅时适合使用细边框 |
| 提示框 | 显示当前周期数值 | 适合分析页面和报表页面 |
| 坐标轴 | 显示数值刻度 | 保持标签简洁可读 |
| 缩放 | 查看局部周期范围 | 适合长周期数据展示 |
页面适配清单
- 报表页面：适合放在数据总览区域，配合标题和图例说明。
- 分析页面：适合开启缩放、提示框、平移功能。
- 控制台页面：适合使用紧凑宽度，展示多个周期内容。
- 移动端页面：适合简化坐标轴标签，保留核心数值显示。
- 大屏页面：适合放大图形宽度，增强颜色对比和图例说明。
示例配置思路
可以把页面展示拆成几个区域，这样配置更容易理解。
```text
页面容器
├─ 标题区域
├─ candle 图形区域
├─ 图例区域
├─ 坐标轴区域
└─ 数据周期标签区域
```
```text
数据列表
├─ 周期字段
├─ 起始值字段
├─ 最大值字段
├─ 最小值字段
└─ 结束值字段
```
```text
图形渲染
├─ 读取数据
├─ 映射字段
├─ 设置样式
├─ 绑定容器
└─ 输出图形
```
最终说明
candle的用法适合用于区间数据图形化展示。只要把周期数据、数值字段、图形样式和渲染容器配置完整，就可以输出适合分析页面、报表页面、控制台页面使用的图形内容。日常使用中，建议先把数据列映射清楚，再配置宽度、颜色、图例、坐标轴，这样页面效果会整洁清晰。
【常见问题】
问题1：candle的用法适合哪些展示场景？
回答1：candle的用法适合展示按周期变化的数值区间，例如报表分析、数据总览、趋势查看、指标展示。它可以把多个周期的数值集中呈现在一个图形里，让使用者快速看到区间变化。
问题2：配置 candle的用法时，哪些字段最关键？
回答2：配置 candle的用法时，最关键的是起始值、最大值、最小值、结束值和周期字段。只要这些字段映射准确，图形就能按数据内容正常呈现。
问题3：candle的用法能否用于移动报表页面？
回答3：可以。candle的用法可以用于移动报表页面，适合调整图形宽度、坐标轴标签和图例位置，让页面在小屏幕容器里也能清楚展示数据。
问题4：想优化 candle的用法显示效果，应该从哪些位置调整？
回答4：想优化 candle的用法显示效果，可以从颜色、宽度、边框、图例、提示框、坐标轴和周期标签这几个位置调整。样式设置得简洁统一，图形整体展示会更清楚。
问题5：candle的用法需要哪些数据准备？
回答5：candle的用法需要准备按周期排列的数据，每一行数据通常包含周期字段、起始值、最大值、最小值、结束值。数据整理规范后，配置过程会更顺畅。
免责声明：以上内容用于说明 candle 的通用用法和配置思路。具体参数名称、接口写法和页面效果可按所用软件版本、项目环境及团队规范调整。实际使用前，请以产品说明、接口文档、项目配置和现场使用场景为准。