This is an automated email from the ASF dual-hosted git repository.
wangzx pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/echarts-doc.git
The following commit(s) were added to refs/heads/master by this push:
new 05bb8aef add doc for tooltip `displayTransition` option
(apache/echarts#20966)
05bb8aef is described below
commit 05bb8aeff1cc3297a90955dbbf202bdd4bb63f8e
Author: plainheart <[email protected]>
AuthorDate: Sat Sep 13 18:16:06 2025 +0800
add doc for tooltip `displayTransition` option (apache/echarts#20966)
---
en/option/component/tooltip.md | 12 ++++++++++++
zh/option/component/tooltip.md | 12 ++++++++++++
2 files changed, 24 insertions(+)
diff --git a/en/option/component/tooltip.md b/en/option/component/tooltip.md
index 2b3c261b..3dc500d4 100644
--- a/en/option/component/tooltip.md
+++ b/en/option/component/tooltip.md
@@ -250,6 +250,18 @@ className: 'echarts-tooltip echarts-tooltip-dark'
The transition duration of tooltip's animation, in seconds. When it is set to
be 0, it would move closely with the mouse.
+## displayTransition(boolean) = true
+
+<ExampleUIControlBoolean default="true" />
+
+{{ use: partial-version(
+ version = "6.0.0"
+) }}
+
+Whether to enable the display transition.
+
+By default, the tooltip uses the opacity fading to make itself invisible
rather than setting the DOM element's `display` property to `'none'`. This
might cause the scrollbar to be always visible when the tooltip content size is
large, even if the tooltip is already invisible. In this scenario, or if you
just want no fading, you can set this option to `false` to disable the display
transition.
+
{{ use: partial-tooltip-common(
scope = 'global',
prefix = '#'
diff --git a/zh/option/component/tooltip.md b/zh/option/component/tooltip.md
index f75360d7..c767e259 100644
--- a/zh/option/component/tooltip.md
+++ b/zh/option/component/tooltip.md
@@ -250,6 +250,18 @@ className: 'echarts-tooltip echarts-tooltip-dark'
提示框浮层的移动动画过渡时间，单位是 s，设置为 0 的时候会紧跟着鼠标移动。
+## displayTransition(boolean) = true
+
+<ExampleUIControlBoolean default="true" />
+
+{{ use: partial-version(
+ version = "6.0.0"
+) }}
+
+提示框显示/隐藏时是否启用过渡动画。
+
+默认情况下，提示框通过透明度淡入淡出过渡效果来实现显示/隐藏，而不是直接将 DOM 元素的 `display` 属性设置为
`'none'`。这在提示框内容比较多出现滚动条时，可能导致提示框隐藏后滚动条仍然存在的问题。在这种情况下，或者如果只是不想使用淡入淡出效果，可以将此选项设置为
`false` 以禁用显示/隐藏过渡动画。
+
{{ use: partial-tooltip-common(
scope = 'global',
prefix = '#'
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
