Vue 组件
<KlineChart> 的属性、事件与插槽，由 KLineChart.vue 生成。
| 属性 | 类型 | 默认值 | 说明 |
|---|
symbols | ReadonlyArray<SymbolSpec> | — | 受控品种列表；传入时由组件同步到图表数据源。 |
indicators | ReadonlyArray<ChartIndicatorConfig> | — | 受控指标实例列表；传入时完整替换当前指标实例。 |
custom-markers | ReadonlyArray<CustomMarkerEntity> | — | 受控自定义标记列表；传入时完整替换当前自定义标记。 |
market-sessions | ChartMountOptions['marketSessions'] | — | 当前图表实例的市场交易时段覆盖 |
y-padding-px | number | 20 | 价格区上下留白（CSS 像素）。 |
min-k-width | number | 1 | 缩到最小时的 K 线宽度（CSS 像素）。 |
max-k-width | number | 50 | 放到最大时的 K 线宽度（CSS 像素）。 |
right-axis-width | number | 0 | 右侧价格轴宽度 |
left-axis-width | number | — | 左侧价格轴宽度（默认 0，不显示） |
bottom-axis-height | number | 24 | 底部时间轴高度 |
price-label-width | number | 60 | 价格标签额外宽度（用于显示涨跌幅，默认 60px） |
zoom-levels | number | 20 | 缩放级别数量（默认 10） |
initial-zoom-level | number | 3 | 初始缩放级别（1 ~ zoomLevels，默认居中） |
is-fullscreen | boolean | — | 是否全屏（受控）。不绑定时为非受控模式，组件内部接管全屏 DOM 操作 |
timezone | string | 'Asia/Shanghai' | 时区，默认 Asia/Shanghai |
settings | Partial<ChartSettings> | — | 图表设置。逐 key 覆盖：显式声明的 key 优先，未声明的回落到 localStorage 存量， 最后用默认值补齐。未传时等价于 localStorage 存量 + 默认值。 |
legend | LegendOptions | — | Canvas 主图图例配置；默认由 Core 绘制，不进入 Vue 更新路径。 |
custom-data | CustomDataSource | — | 用户自定义数据源（传入后 bypass fetcher，使用此数据） |
| 事件 | 参数 | 说明 |
|---|
@zoom-level-change | level: number, kWidth: number | 缩放级别变化。 |
@toggle-fullscreen | — | 点击了全屏按钮。 |
@update:is-fullscreen | value: boolean | 供 v-model:is-fullscreen 使用的全屏状态。 |
@theme-change | theme: 'light' | 'dark' | 用户切换了明暗主题。 |
@k-line-level-change | level: string | 用户切换了周期。 |
@k-line-adjust-change | adjust: 'qfq' | 'hfq' | 'splits' | 'none' | 用户切换了复权方式。 |
@controller-ready | controller: ChartController | 无头 ChartController 已就绪，可用于命令式调用。 |
| 插槽 | 作用域 | 说明 |
|---|
#source-management | — | 宿主管理行情连接与凭据；图表不持有密钥。 |
#toolbar-start | — | 顶部工具栏起始位置，放宿主控件（如账户菜单）。 |
#toolbar-end | — | 顶部工具栏末尾位置。 |
#legend | LegendSlotProps | 替换主图默认图例，作用域为 Core 的图例模板上下文。 |
#kline-tooltip | KlineTooltipSlotProps | 自定义 K 线提示框，悬停时渲染（移动端除外），携带当前 K 线。 |
#marker-tooltip | MarkerTooltipSlotProps | 自定义标记提示框，悬停标记时渲染。 |