From 6ec3a8abc32dd01a4cd0580a3f9742000a9ced41 Mon Sep 17 00:00:00 2001
From: diysimon <diysimon@gmail.com>
Date: Tue, 20 Oct 2026 08:00:56 +0800
Subject: [PATCH] docs(heatmap): document cell cursor options

Refs apache/echarts#20569 and apache/echarts#21798.

Generated-by: OpenAI Codex
---
 en/option/series/heatmap.md | 14 ++++++++++++++
 zh/option/series/heatmap.md | 14 ++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/en/option/series/heatmap.md b/en/option/series/heatmap.md
index dc7fed9d..aa08939f 100644
--- a/en/option/series/heatmap.md
+++ b/en/option/series/heatmap.md
@@ -32,6 +32,12 @@ Here are the examples using it in rectangular coordinate and geographic coordina
     matrix = true
 ) }}
 
+{{ use: partial-cursor(
+    version = "6.1.0"
+) }}
+
+Applies to heatmap cells on `cartesian2d`, `calendar`, and `matrix`, including progressive rendering. Individual cells can override it with [data.cursor](~series-heatmap.data.cursor). Geo heatmaps render a silent raster image and do not support this option.
+
 ## pointSize(number) = 20
 
 Point size of each data point. It is valid with [coordinateSystem](~series-heatmap.coordinateSystem) of 'geo' value.
@@ -148,6 +154,14 @@ Configurations of select state. Available when [selectedMode](~series-heatmap.se
 
 {{ use: partial-2d-data-desc() }}
 
+### cursor(string)
+
+{{ use: partial-version(
+    version = "6.1.0"
+) }}
+
+The mouse cursor when hovering over this cell. Inherits [series.cursor](~series-heatmap.cursor) when not specified. Only applies to `cartesian2d`, `calendar`, and `matrix` heatmaps.
+
 ### name(string)
 
 Name of data item.
diff --git a/zh/option/series/heatmap.md b/zh/option/series/heatmap.md
index 1ca2afe2..6ab3d735 100644
--- a/zh/option/series/heatmap.md
+++ b/zh/option/series/heatmap.md
@@ -83,6 +83,12 @@ option = {
     matrix = true
 ) }}
 
+{{ use: partial-cursor(
+    version = "6.1.0"
+) }}
+
+适用于 `cartesian2d`、`calendar` 和 `matrix` 坐标系中的热力图单元格，包括渐进式渲染。可通过 [data.cursor](~series-heatmap.data.cursor) 为单个单元格覆盖此配置。地理坐标系热力图使用不响应鼠标事件的栅格图像，不支持此配置。
+
 ## pointSize(number) = 20
 
 每个点的大小，在地理坐标系([coordinateSystem](~series-heatmap.coordinateSystem): 'geo')上有效。
@@ -199,6 +205,14 @@ option = {
 
 {{ use: partial-2d-data-desc() }}
 
+### cursor(string)
+
+{{ use: partial-version(
+    version = "6.1.0"
+) }}
+
+鼠标悬浮在此单元格上时的光标样式。未设置时继承 [series.cursor](~series-heatmap.cursor)。仅适用于 `cartesian2d`、`calendar` 和 `matrix` 坐标系中的热力图。
+
 ### name(string)
 
 数据项名称。