Highcharts Accessibility 模块为何导致重绘后显示已禁用的 marker？

2026-11-04数据小陈

加载 Accessibility 模块后，即使运行时的 marker.enabled 变为 true，也不一定是配置失效。部分实现会创建透明的 marker，供无障碍交互使用。如果重绘后原本隐藏的 marker 一直可见，则需要进一步排查状态恢复或渲染问题。

目前缺少 Highcharts 版本和完整 JSFiddle，无法确认具体缺陷，也无法确定某个版本已经修复。建议先用相同配置对比启用和禁用 accessibility 的结果，再决定是否升级或临时绕过。

为什么 enabled 变为 true，图上却可能没有 marker？

原问题的数据点配置是：

{x:1, y:1.61, marker: {enabled: false}}

这段配置用于隐藏该数据点的 marker。Highcharts 仓库中的一个历史 issue 展示过这样的内部处理：将 marker.enabled 改为 true，同时把普通状态下的透明度设为 0。也就是说，运行时创建了 marker，它仍可能不可见。这条历史记录可以解释这种机制，但不能证明当前问题与它属于同一个缺陷。相关历史记录

排查时要区分两种现象：

运行时 enabled 为 true，但 marker 仍然不可见：可能属于模块内部处理。
初始不可见，切换图例后持续可见：需要检查重绘时透明度、普通状态与数据点配置是否发生变化。

“除第一个系列外都会出错”也只是给定示例中的观察结果，不能据此认定 Accessibility 对所有图表都有这样的规则。

先确认配置层级和复现条件

Highcharts 使用的配置名是 marker，不是 markers。如果整个系列默认隐藏 marker，应将配置写在系列上；少数数据点需要例外时，再在数据点上覆盖。marker 配置说明

下面使用示例数据来缩小问题范围，并非完整还原原 JSFiddle。假设页面已经加载 Highcharts 和对应的 Accessibility 模块，且存在 container 容器：

const chart = Highcharts.chart('container', {
    chart: {
        type: 'line'
    },
    accessibility: {
        enabled: true
    },
    series: [{
        name: 'Series 1',
        marker: {
            enabled: false
        },
        data: [
            { x: 1, y: 1.61, marker: { enabled: false } },
            { x: 2, y: 2.1, marker: { enabled: true } },
            { x: 3, y: 1.8, marker: { enabled: false } }
        ]
    }, {
        name: 'Series 2',
        marker: {
            enabled: false
        },
        data: [
            { x: 1, y: 1.2, marker: { enabled: false } },
            { x: 2, y: 1.7, marker: { enabled: false } },
            { x: 3, y: 1.4, marker: { enabled: false } }
        ]
    }]
});

点击第一个系列的图例，将其隐藏后再显示，观察第二个系列的 marker。观察时将鼠标移出绘图区，避免把 hover marker 当成普通状态下的异常。

然后销毁图表，用同样的数据和配置重新创建图表，只将图表级 accessibility.enabled 改为 false。该选项会禁用当前图表的无障碍功能，适合用于对照验证。accessibility.enabled 配置说明

如果只有启用 accessibility 时才出现问题，可以把排查范围缩小到模块参与后的行为，但仍无法区分模块缺陷、版本混用和其他扩展代码的影响。

如何处理重绘后的异常？

1. 检查版本和应用更新代码

先记录版本：

console.log(Highcharts.version);

检查 Highcharts 主库与 Accessibility 模块是否来自同一发布版本。使用 CDN 时核对脚本 URL；使用包管理器时检查依赖与构建入口，确认没有重复加载不同版本的 Highcharts。

同时检查应用是否在图例事件、render 或数据更新逻辑中重新设置了 marker、替换了 data，或者复用了已交给图表处理的配置对象。做对照实验时应重新创建配置，避免沿用运行时可能已被调整过的对象。

如果准备升级，应在候选版本上运行相同的复现步骤，不能仅凭相似的修复描述认定当前问题已经解决。

2. 有条件地禁用受影响系列的 accessibility

如果暂时允许某个系列退出无障碍功能，可以在新建图表时对该系列配置：

{
    name: 'Series 2',
    accessibility: {
        enabled: false
    },
    marker: {
        enabled: false
    },
    data: [
        { x: 1, y: 1.2, marker: { enabled: false } },
        { x: 2, y: 1.7, marker: { enabled: false } }
    ]
}

series.accessibility.enabled 用于控制单个系列的无障碍功能，可以用于进一步验证或临时绕过。禁用它会影响该系列的辅助技术访问能力，还需要在实际版本中验证是否能避开异常。系列级配置说明

如果必须保留完整无障碍功能，应继续定位问题并采用经过复现验证的修复，不宜把禁用 accessibility 当作最终方案。

3. 提交包含完整依赖的最小复现

若版本一致、没有额外更新逻辑，问题仍能稳定复现，应向 Highcharts 提供完整示例，包括主库和模块版本、两个系列的配置、图例操作顺序，以及启用和禁用 accessibility 的对照结果。

不建议直接在每次 render 中反复写回 point.options.marker.enabled = false。这种做法可能与模块的内部处理相互覆盖，单独改变布尔值也未必能恢复实际图形状态。最终显示效果、键盘导航和屏幕阅读器行为都需要一并验证。