feat(theme): support tooltip.trigger and tooltip.triggerOut

Author: kiramyby

packages/vchart/src/component/tooltip/interface/theme.ts

@@ -1,7 +1,15 @@
 import type { ITextAttribute } from '@visactor/vrender-core';
-import type { ILayoutNumber, ITooltipShapePattern, StringOrNumber, TextAlign, TextBaseLine } from '../../../typings';
+import type {
+  ILayoutNumber,
+  ITooltipShapePattern,
+  StringOrNumber,
+  TextAlign,
+  TextBaseLine,
+  MaybeArray
+} from '../../../typings';
 import type { Padding } from '@visactor/vrender-components';
 import type { ITokenKey } from '../../../theme/token/interface';
+import type { EventSourceType, EventType } from '../../../event/interface';
 
 export interface ITooltipTextTheme<ColorType = string> {
   /**
@@ -126,4 +134,24 @@ export interface ITooltipTheme<ColorType = string> {
    * @since 1.11.5
    */
   align?: 'left' | 'right';
+  /**
+   * tooltip触发方式
+   * hover: 鼠标悬停时显示
+   * click: 点击时显示
+   * none: 不显示
+   */
+  trigger?:
+    | MaybeArray<'hover' | 'click' | { eventType: EventType; source?: EventSourceType; consume?: boolean }>
+    | 'none';
+  /**
+   * 隐藏tooltip的触发方式（目前仅支持和trigger一致的设置以及none）
+   * （*会影响自定义handler）
+   */
+  triggerOff?:
+    | MaybeArray<
+        | 'hover'
+        | 'click'
+        | { eventType: EventType; source?: EventSourceType; consume?: boolean; checkOutside?: boolean }
+      >
+    | 'none';
 }

packages/vchart/src/component/tooltip/tooltip-transformer.ts

@@ -13,9 +13,16 @@ export class TooltipSpecTransformer extends BaseComponentSpecTransformer<any> {
 
   protected _initTheme(spec: any, chartSpec: any): { spec: any; theme: any } {
     const { spec: newSpec, theme } = super._initTheme(spec, chartSpec);
+
+    // 合并样式和配置
     newSpec.style = mergeSpec({}, this._theme, newSpec.style);
     newSpec.offset = mergeSpec({}, theme.offset, spec.offset);
     newSpec.transitionDuration = spec.transitionDuration ?? theme.transitionDuration;
+
+    // 合并交互相关配置
+    newSpec.trigger = spec.trigger ?? theme.trigger;
+    newSpec.triggerOff = spec.triggerOff ?? theme.triggerOff;
+
     return { spec: newSpec, theme };
   }