Feat/calculate top default

common/changes/@visactor/vchart/feat-calculate-top-default_2025-03-28-03-03.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@visactor/vchart",
+      "comment": "feat: add \\`alwayCalculateTotal\\` for total label",
+      "type": "none"
+    }
+  ],
+  "packageName": "@visactor/vchart"
+}

packages/vchart/src/chart/stack.ts

@@ -56,6 +56,10 @@ export class Stack {
     }
     // total label need percent
     const hasTotalLabel = series.some(s => {
+      // 如果设置了alwayCalculateTotal，那么一定需要计算total
+      if (s.getSpec()?.totalLabel?.alwayCalculateTotal) {
+        return true;
+      }
       return s.getSpec()?.totalLabel?.visible;
     });
     const hasPercent = hasTotalLabel || series.some(s => s.getPercent());

packages/vchart/src/component/label/interface.ts

@@ -152,6 +152,11 @@ export type ITotalLabelSpec = Pick<
    * @default 'top'
    */
   position?: 'top' | 'bottom';
+  /**
+   * 不管总计标签是否展示，内部都默认计算总计值
+   * @default false
+   */
+  alwayCalculateTotal?: boolean;
 };
 
 export interface ITotalLabelTheme

packages/vchart/src/event/event.ts

@@ -111,7 +111,13 @@ export class Event implements IEvent {
     return this;
   }
 
-  prevent<Evt extends EventType>(eType: Evt, except?: EventCallback<EventParamsDefinition[Evt]>) {
+  prevent<Evt extends EventType>(
+    eType: Evt,
+    except?: {
+      handler: EventCallback<EventParamsDefinition[Evt]>;
+      level: EventBubbleLevel;
+    }
+  ): this {
     this._eventDispatcher.prevent(eType, except);
     return this;
   }