📠 HXKlineChart更新日志

🆕-新增、🚀-优化、🐞-修复

2.0.20

• 🆕 新增插件PaneIndicatorNew，支持在绘制云端指标，例如：神奇电波、趋势追踪、分时顶底等
• 🐞 禁用：-apple-system，改字体会导致部分IOS机型 手抄APP异常
• 🚀 新增autoSnapshotSubscribe方法新增参数immediateRequest，用于指定是否立即请求一次数据，默认false
• 🚀 优化separator样式，支持设置分割条操作热区配置
• 🚀 优化chart Event，click事件支持在移动端触发
• 🚀 优化新增字段时指标参数的处理

2.0.19

• 🆕 新增Session Volume Profile线型

• 🆕 新增Volume Profile线型

• 🆕 新增指标数据会挂载到dataList上，方便获取

• 🚀 优化rect基础图形，支持阴影

• 🚀 优化setOffsetRightDistance、setOffsetLeftDistance、setOffsetRightBeyondBarCount、setOffsetLeftBeyondBarCount，支持传入OffDistance类型，指定留白区域为像素或柱子数量

• 🚀 优化polygon基础图形，支持渐变

• 🚀 优化基础rect图形，支持shadow阴影

• 🚀 优化X轴日期展示规则，当跨月、跨年时，日期展示为MM/DD

• 🚀 优化键盘快捷键，现在可以直接通过↑、↓（缩放）、←、→（滚动）、+、-（缩放）

• 🚀 优化左右两侧留白，默认滚动到两侧数据起止点后，留白区域为一半图表宽度

• 🚀 优化指标涨跌色，默认与K线一致

• 🚀 优化所有指标，将默认开启单位化，默认保留2位小数

• 🚀 优化resizeAPI，支持重置坐标轴范围，并滚动到最右端

• 🚀 优化AVP指标名称，改为VWAP

• 🚀 优化Number.toFixedAPI，支持精确四舍五入

• 🚀 优化打包脚本，已支持海外离线包获取

• 🐞 修复svg在宽度计算错误导致的交互事件异常的bug

2.0.18

• 🆕 新增集合竞价集合竞价交易量(VA)技术指标
• 🆕 新增集合竞价yAxis配置，支持手动配置Y轴范围
• 🚀 优化tooltip样式，优化rect配置
• 🐞 修复overrideIndicator时会影响全部指标的bug

2.0.17

• 🆕 新增海外CDN地址
• 🚀 最高价和最低价样式优化，与Ainvest一致，将作为新的默认样式
• 🚀 文档优化

2.0.16

• 🆕 指标插件更新
• 🐞 修复埋点特殊场景下丢失的bug

2.0.15

• 🆕 指标插件更新
• 🚀 优化zoomAtCoordinate方法，scale值计算更加平滑，人性化
• 🚀 兼容至Chrome 49+
• 🐞 修复X轴刻度文本某些情况下绘制偏下的bug

2.0.14

• 🆕 指标插件更新
• 🚀 新增svg缓存机制，优化基础图形中text绘制svg时性能问题
• 🐞 修复IOS系统中，rectText兼容性（其他系统无此问题）导致的文本绘制偏下的bug

2.0.13

• 🆕 面积图支持显示最高价最低价
• 🆕 缩放APIsetZoomEnabled支持缩放方向，可以选择从左右两侧为锚点
• 🆕 主要文件新增注释，为AIGC做准备
• 🆕 tooltip新增背景色配置、支持上下左右偏移
• 🚀 tooltip中Time字段改名为Date
• 🚀 Polygon多边形支持圆角配置
• 🚀 蜡烛图性能优化
• 🚀 埋点优化：如果weblog已经初始化，则此处不再设置
• 🚀 优化两侧柱子留白逻辑，当为非蜡烛图样式时，消除两边留白
• 🚀 绘制未来时间轴时，若未来数据为空，则tooltip显示最近一个有效数据（为分时图优化）
• 🚀 全局关于PaneID的API，统一为keypaneId（原来部分为id）
• 🐞 local字段统一为locale
• 🐞 成交量VOL指标优化，都为整数

2.0.12

• 🆕 X轴星期显示支持国际化
• 🚀 坐标轴单位化逻辑优化
• 🚀 AVP指标优化
• 🚀 tooltip样式优化，新增成交额展示

2.0.11

• 🆕 新增固定范围成交量分布图（FRVP） 指标
• 🚀 文档优化

2.0.10

• 🆕 公式指标插件 和画线插件优化
• 🚀 优化build脚本，支持加速打包进程

2.0.9

• 🆕 公式指标插件 正式版，接入同花顺公式指标SDK，实现公式源码解析与绘制，已支持18种绘图函数
• 🆕 indicator 指标模板新增 onPressedMoving 事件

2.0.9-beta1~beta6

• 🆕 setScrollEnabledAPI支持isFreeMoveEnabled，开启将可以上下左右自由拖动
• 🆕 新增setHorizontalScreenAPI支持isHorizontalScreenAPI，支持通过CSS实现的横屏模式
• 🆕 新增setYAxisLimit和getYAxisLimitAPI,支持在自由移动模式下限制上下移动的范围
• 🆕 新增moveAPI,支持在自由移动模式下通过设置Y轴极值实现上下移动的范围(待定)
• 🚀 预览页面更新

2.0.8

• 🆕 新增公式指标插件非正式版，仅供测试联调用；
• 🆕 createPointFigures将ctx对象导出，现已可操作canvas对象
• 🚀 vitepress升级至正式版1.2.2
• 🚀 文档优化，功能模块更加清晰
• 🐞 修复priceMark代码与文档使用不一致的问题
• 🐞 修复setPaneOptionsapi设置gap后页面未主动刷新的bug

2.0.7

• 🆕 付费指标插件支持通过style配置颜色等样式

2.0.6

• 🆕 新增付费指标插件：本次内置主力暗盘资金、AI机构活跃度，并支持将业务方指标作为插件引入
• 🆕 覆盖物操作按钮新增hover样式

2.0.6-beta.4

• 🆕 新增主力暗盘资金、带阴影的覆盖物等4个demo示例
• 🆕 circle和Polygon支持阴影（canvas原生api）

2.0.6-beta.3

• 🆕 新增矩形选择框、双Y轴多折线等8个demo示例
• 🆕 cdn打包新增latest 版本，恒为最新版
• 🚀 分时图模式现已支持无线缩放，支持超小图
• 🐞 解决Tooltips默认值偶尔无法生效的问题
• 🐞 解决注册色板后，使用新建色板不生效的问题
• 🐞 解决昨收价存在时影响副图Y轴的问题
• 🐞 修复setRightBeyondBarCount和setRightBeyondBarCount影响默认宽度的问题

2.0.6-beta.1

• 🐞 解决registerConstants 设置主题配色后setStyles无法生效的问题

2.0.5-beta.3

• 🐞 解决setLeftBeyondBarCount和setRightBeyondBarCount方法同时设置且数量均大于3时，影响bar宽度的问题

2.0.5-beta.2

• 🐞 修复了导出类型无法正常使用的问题
• 🚀 删除图表最小高度设置，现在图表高度可以设置为0，当图表高度为0时，图表会自动隐藏，不再占用空间

2.0.5-beta.1

• 🐞 解决部分内置指标计算错的bug
• 🚀 优化setLeftBeyondBarCount和setRightBeyondBarCount方法，支持传入负数，并修复了当传入负数时，过度缩放会显示隐藏的bar的bug
• 🚀 优化文档内容
• 🆕 新增setBarSpaceLimit和getBarSpaceLimit方法，用于设置bar宽度的最大值最小值，当bar宽度设置为0时，支持无限缩放！
• 🆕 新增CND方式引用。

2.0.4

• 🆕 支持副图单独设置Y轴样式，详情见指标图样式
• 🆕 新增埋点

2.0.4-beta.3

• 🚀 优化createIndicatorAPI，防止主图异常时，指标图无法正常创建
• 🆕 setScrollEnabledAPI现支持对具体的滚动行为进行控制，可以区分touch、mouse、keyboard、api四种类型的滚动行为。

2.0.4-beta.1

• 🐞 修复两侧柱子可留白时，x轴ticktext叠加的bug

2.0.3

• 🆕 setLeftMinVisibleBarCount和setRightMinVisibleBarCount修改为setLeftBeyondBarCount和setRightBeyondBarCount，更加人性化
• 🆕 文档内容优化
• 🐞 修复画线工具栏bug
• 🐞 修复X轴设置等分后，左右两侧刻度值不对齐的bug

2.0.3-beta.10

• 🆕 新增指标图Y轴居中功能，支持指标图全局配置和单个指标配置
• 🐞 修复指标图-折柱图折线和柱子遮挡的bug，注意⚠️，修复后折线始终在柱子上方
• 🐞 修复主图设置固定数量柱子时，右侧柱子多画一根的bug

2.0.3-beta.8

• 🆕 新增实例 API：getRealDataList()，用于获取非 NaN 的数据列表（分时场景会提前绘制未来时间轴，这部分数据无收盘价，需要过滤掉）；
• 🆕 新增实例 API：getCustomApi()，用于获取自定义 API 配置；
• 🐞 修复 separator 分割线高度计算问题；
• 🐞 修复 candle.tooltip.custom 设置自定义提示文本时，缺少默认字体颜色的问题。

2.0.3-beta.3

• 🆕 crosshairsLabel 现已支持磁吸贴边效果；
• 🆕 兼容性提高："targets": "> 0.25%, not dead"；
• 🆕 修改图默认 Gap 边距上下为 20%；

2.0.3-beta.2

• 🆕 Figures的text基础图形现在支持绘制 svg 格式的图形，只要传入的 text 值以<svg开头；
• 🆕 PaneOptions类新增 styles 属性，现在允许给每个面板 pane 定义独有的 styles 样式，通过实例 apichart.createIndicator({styles: {}})来设置；
• 🆕 indicator 的tooltip样式也允许针对每个指标实例进行定制（原本是整个 chart 共用一份indicator.tooltip样式）；
• 🐞 优化模块导出方案，现在 npm 引入的 HXKlineChart 也会自动挂载到全局 window 对象上（方便某些业务组件使用）；

2.0.3-beta.1

• 🆕 【重要】HXKlineChart 组件在全局 window 挂载的模块名从klinecharts改为HXKlineChart；影响面：所有用到图表 api 的地方；

• 🆕 插件现在也会提供 ts 声明，引用路径为types/plugins/插件名.d.ts；

• 🆕 基础数据格式新增pre字段（可选）；

• 🚀 优化组件入口文件包的导出形式，现在支持 default 默认导出和命名导出，详见快速开始-HXKlineChart；

• 🚀 优化组件打包框架，支持es、cjs、umd三种方式引用；

• 🚀 优化 package.json 包入口文件路径，针对三种格式自动切换入口，解决 vite 等只支持 es6 模块化的框架使用问题；

• 🐞 组件主入口类型声明文件路径调整：index.d.ts => dist/index.d.ts；

• 🐞 插件引用路径变更，从dist/plugins/drawLinePlugins.js统一调整为dist/plugins/DrawLine.js；

• 🐞 插件模块名调整：drawLine => DrawLine（小驼峰改为大驼峰）；

• 🐞 getVisibleDrawLineDataList()实例 API 调整为异步函数，返回 Promise 对象。函数会在无画线序列号时重新调用请求获取序列号。

• 🐞 修复分时图样式 Y 轴昨收价居中时百分比样式下涨幅不为 0 的 bug

• 🐞 修复一字板时颜色固定为灰色的 bug：若今开=今收，则跟昨收对比。

• 🐞 修复executeActionAPI 使 crosshairs 消失时，crosshairs 停留在主图的 bug。

2.0.2

• 🆕 将画线能力单独打包，输出插件路径：dist/plugins/drawLinePlugins.js；
• 🐞 调整组件打包框架，将拓展功能作为插件独立打包，按需加载，减少主包大小；
• 🐞 画线覆盖物不再默认注册，仅当引入画线插件drawLinePlugins才会自动挂载。

2.0.2beta6

2023-08-03

• 🆕 X 轴支持位置设置：在主副图之间或底部，详情请见styles 文档；
• 🐞 修复setPanelHeight默认不生效的 bug；

2.0.2beta5

2023-08-03

• 🆕 画线工具体系新增CustomSettings自定义参数配置工具；ColorBtn颜色工具类代码结构优化；
• 🆕 新增画线序列 ID 生成功能，完善画线适配器，支持反编译图表上的画线覆盖物数据，返回可供画线多端同步的 xml 数据；
• 🆕 新增实例 API：zoomToShowAllData()，支持自适应缩放至展示全部 k 线数据（存在缩放极限，蜡烛尺寸限制 1 ～ 50）；
• 🆕 新增实例 API：measure()，用于测量区域内行情数据，并返回测量数据；
• 🆕 新增一般覆盖物measure；
• 🆕 新增constants常量配置DEFAULT_BG_MASK_COLOR；
• 🆕 Overlay的三个函数createPointFigures、createXAxisFigures、createYAxisFigures 新增入参dataList；
• 🆕 Overlay新增事件hideFloatingToolbar；
• 🆕 新增实例 API：getYAxisRangeInfo，获取 Y 轴的范围信息最大最小和范围

• 🚀 优化 XY 轴 label 在边界时的显示问题；
• 🚀 修改图表 APIupdateAllThemeStyles()的功能为“基于自定义样式配置，同步更新所有主题样式”，用initAllThemeStylesByConstants()来替代原本的updateAllThemeStyles()方法，具体见styles 文档；
• 🐞 修复内置工具函数clone()对null、undefined等特殊格式属性的错误处理方式；解决由此导致的setStyles()切换主题样式时部分属性丢失的问题；
• 🐞 修复画线适配器定位点判断逻辑，避免 xml 数据点位解析错误。
• 🐞 修复 X、Y 轴设置 splitNum 时等分不均匀的问题。

2.0.2beta4

2023-08-02 概览：BUG 修复

• 🐞 修复 XAxis formatter 无效的 bug
• 🚀 优化副图高度调整逻辑:影响 previous pane 改为影响 top pane 高度
• 🚀 修改默认时间格式为:yyyy/MM/dd
• 🆕 新增 API getPaneById 获取指定 pane
• 🆕 新增 API setPanelHeight 调整指定 pane 高度

2.0.2beta3

2023-08-01 概览：BUG 修复

• 🐞 修复 dragging 时，applyMoreData 闪烁的 BUG

• 🐞 修复executeAction设置crosshair参数为空对象或 null 时，crosshair仍存在的 bug

• 🐞 修复 HXKline，dispose 异常的 bug

• 🚀 统一 HXKline 时间参数为毫秒时间戳

2.0.2beta1

2023-07-26 概览：优化样式，修复基础图形 BUG

• 🐞 修复 HXKline 成交价和成交量数据异常的 bug
• 🐞 修复 HXKline 销毁图像后'timePeriod'未重置的 bug
• 🆕 locale 地区设置关联数值格式化；'zh_CN' 为中文，单位：万、亿；'en_US' 为英文，单位为：K、M、B
• 🆕 新增 API getLocale 获取当前地区设置
• 🆕 HXKline 新增onLoadMoreData API，监听滚动加载数据事件
• 🆕 HXKline 现已支持跳转到指定日期。
• 🚀 优化 Y 轴背景网格等分样式
• 🚀 优化applyMoreDataAPI，新增directionparams 支持向后追加数据

2.0.1

2023-07-24

概览：上线画线功能，支持常用线型，实现 xml 数据解析与回显；上线工具栏功能，支持颜色选择、样式编辑、文本输入、画线锁定与删除等功能；优化样式配置功能，内置黑白版样式，支持主题换肤。

• 🆕 Figure新增基础图形ellipse、arrow；新增对应styles样式配置属性：styles.overlay.ellipse、styles.overlay.arrow；

• 🆕 Overlay新增属性：showName、lineType、lineData、drawlineAdapter、needToolbar、toolbarConfig、toolbar；

• 🆕 Overlay新增事件：setDrawLineAdapter、initDrawLineAdapter、parseDrawLineData、updateDrawLineData、updateOverlayByDrawLineData、setToolbar、initToolbar、showFloatingToolbar、showSettingsDialog、checkShowSettingsDialog、toggleOverlayToolbar；

• 🆕 Overlay新增画线线型：arrowSegment, fibonacciPeriod, horizontalStraightLine, horizontalGoldenSection, parallelStraightLine, channelLine, rayLine, periodLine, polyLine, segment, straightLine, verticalStraightLine, circle, ellipse, rectangle, gannFan, timeRuler, waveRuler, amplitudeRuler, text, upArrow, downArrow, trendArrow；

• 🆕 新增画线适配器DrawLineAdapter，支持画线 xml 数据解析与反编译，实现 18 种线型数据回显与编辑；

• 🆕 新增ToolbarWidget工具类，新增通用工具：ColorPicker、Dialog、OpacitySlider、Picker、SelectPicker、Text；

• 🆕 新增画线专用工具组件：10 个功能按钮overlay/btns/*，2 个配置项工具overlay/settings/*，浮动工具栏overlay/FloatingBar，设置弹窗overlay/SettingsDialog；

• 🆕 新增画线工具栏overlay.toolbar，支持边框、背景颜色样式编辑、文本样式和内容编辑，支持画线锁定和删除；新增对应styles样式配置属性：styles.toolbar；

• 🆕 新增Palette调色盘样式配置、Constants样式常量配置体系；新增对应styles样式配置属性：styles.palette、styles.constants；

• 🆕 新增xAxis和yAxis自定义样式：分割区间数量配置styles.xAxis|yAxis.splitNum和排列方式配置styles.xAxis|yAxis.splitType，支持 xy 轴固定显示两端或其中一端的顶点坐标；

• 🆕 新增图表 API：registerPalette(theme, palette)用于添加调色盘主题配置；

• 🚀 优化styles样式配置结构，接入constants主题常量配置，将大量相近样式用统一常量来声明，实现一键快速换肤，如：DEFAULT_FONT_COLOR默认字体颜色、DEFAULT_TICK_LINE_COLOR默认坐标轴、分割线颜色等；

• 🆕 新增图表 API：registerConstants(theme, constants)、updateAllThemeStyles、overrideDefaultConstants(key, value)、updateAllThemeConstants()。

• 🆕 新增 crosshair 消失事件：返回 data 无 x,y 值；

• 🐞 修复executeAction设置crosshair时，crosshair显示异常的 bug

2.0.0

2023-07-03

• 🆕 Overlay新增事件onDoubleClick，新增属性modeSensitivity。
• 🆕 X 轴标签边界显示不全时，自动调整显示位置。
• 🆕 新增getPrePrice和setPrePrice方法，分时图 Y 轴通过setPrePrice设置按昨收价居中显示。

• 🆕 createIndicator(value, isStack, paneOptions, callback) 新增叠加主图控制开关，paneOptions 为 Boolean 时表示是否叠加到主图上
• 🆕 ZoomFromRight 设置缩放位置(默认缩放事件生效点，可选从左或右侧最后一根柱子缩放)
• 🆕 getVisibleDataList 获取当前可见数据
• 🆕 新增setDateFormat和getDateFormat处理十字光标、Tooltips、xAxis 时间格式
• 🆕 新增crosshairtextFormatter 处理十字光标文本格式
• 🆕 新增getVisibleWidth(): number，获取当前可见宽度
• 🚀 优化setLeftMinVisibleBarCount和setRightMinVisibleBarCount，方法，更加人性化
• 🐞 修复scrollToDataIndex滚动到第一根柱子时，定位不准确的 bug