chbim-time-axis-v2 0.2.2 → 0.2.3

package/README.md

@@ -25,6 +25,10 @@
 - **🔍 灵活的缩放控制**:
   - **自定义最小缩放级别**: 支持通过 `minZoomLevel` 属性设置最小缩放层级（分钟、小时、天）。
 
+## ⚠️ 注意事项
+
+- **初始化数据**: 建议在获取到完整的 `tasks`、`projectStartTime` 和 `projectEndTime` 数据后再渲染组件（使用 `v-if`）。如果在组件挂载后再异步填充数据，可能会导致 `handleTaskEnter` 等事件在初始化阶段被重复触发。
+
 ## 📦 安装
 
 ```bash
@@ -322,6 +326,7 @@ roamController.start();
 | `toggleMaximize` | -    | 切换最大化模式                                                   |
 | `toggleMinimize` | -    | 切换最小化模式                                                   |
 | `getSnapshot`    | -    | 获取当前时间点的快照（包含当前时间、活跃任务、块、瞬时点和分组） |
+| `handleResetView`| -    | 自动调整视图范围以适应任务列表。如果没有任务，则尝试适应项目起止时间；如果也没有，则以当前时间为中心。 |
 
 ### Slots (插槽)
 

package/dist/chbim-time-axis-v2.es.js

@@ -13371,9 +13371,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       };
       return filterCollapsed(tasksWithComputedData.value);
     });
-    const fitToTasks = (tasks) => {
-      if (tasks.length === 0)
-        return { minTime: 0, maxTime: 0 };
+    const calculateTasksRange = (tasks) => {
       let minTime = Number.MAX_SAFE_INTEGER;
       let maxTime = Number.MIN_SAFE_INTEGER;
       const checkTask = (t) => {
@@ -13408,6 +13406,37 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           t.children.forEach(checkTask);
       };
       tasks.forEach(checkTask);
+      return { minTime, maxTime };
+    };
+    const autoFitView = () => {
+      let minTime = Number.MAX_SAFE_INTEGER;
+      let maxTime = Number.MIN_SAFE_INTEGER;
+      let source = "";
+      if (processedTasks.value.length > 0) {
+        const range = calculateTasksRange(processedTasks.value);
+        if (range.minTime <= range.maxTime && range.minTime !== Number.MAX_SAFE_INTEGER) {
+          minTime = range.minTime;
+          maxTime = range.maxTime;
+          source = "tasks";
+        }
+      }
+      if (source === "" && props.projectStartTime && props.projectEndTime) {
+        const pStart = dayjs(props.projectStartTime).valueOf();
+        const pEnd = dayjs(props.projectEndTime).valueOf();
+        if (!isNaN(pStart) && !isNaN(pEnd) && pStart <= pEnd) {
+          minTime = pStart;
+          maxTime = pEnd;
+          source = "project";
+        }
+      }
+      if (source === "") {
+        const now = dayjs(currentTime.value).valueOf();
+        if (!isNaN(now)) {
+          minTime = dayjs(now).subtract(15, "day").valueOf();
+          maxTime = dayjs(now).add(15, "day").valueOf();
+          source = "clock";
+        }
+      }
       if (minTime <= maxTime && minTime !== Number.MAX_SAFE_INTEGER) {
         let duration = maxTime - minTime;
         if (duration === 0) {
@@ -13423,24 +13452,16 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             timelineRef.value.setScrollLeft(0);
           }
         }, 100);
+        return { minTime, maxTime };
       }
-      return { minTime, maxTime };
+      return { minTime: 0, maxTime: 0 };
     };
-    const initialized = ref(false);
-    watch(
-      () => processedTasks.value,
-      (newTasks) => {
-        if (newTasks.length > 0 && !initialized.value) {
-          fitToTasks(newTasks);
-          initialized.value = true;
-        }
-      },
-      { deep: true, immediate: true }
-    );
     onMounted(() => {
-      if (props.tasks.length > 0 && !initialized.value) {
-        fitToTasks(props.tasks);
-        initialized.value = true;
+      if (props.tasks.length === 0) {
+        console.warn(
+          "%c[CesiumGantt] 性能提示:\n建议在渲染组件前已获取所有必要资源(如 tasks, projectStartTime, projectEndTime)。\n推荐做法: 使用 v-if 控制组件渲染，直到数据准备就绪。\n风险: 数据逐步加载可能导致 handleTaskEnter 等事件在初始化阶段被重复或意外触发。",
+          "color: #e6a23c; font-weight: bold;"
+        );
       }
       window.addEventListener("click", closeContextMenu);
       window.addEventListener("click", closeBuiltinMenu);
@@ -13518,7 +13539,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       }
     };
     const handleResetView = () => {
-      const { minTime, maxTime } = fitToTasks(processedTasks.value);
+      const { minTime, maxTime } = autoFitView();
       if (minTime !== Number.MAX_SAFE_INTEGER && minTime !== 0 && minTime <= maxTime) {
         if (timelineRef.value) {
           const { clientWidth } = timelineRef.value.getScrollState();
@@ -13786,7 +13807,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     __expose({
       toggleMaximize,
       toggleMinimize,
-      getSnapshot
+      getSnapshot,
+      handleResetView
     });
     return (_ctx, _cache) => {
       return openBlock(), createElementBlock("div", {
@@ -14004,8 +14026,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const CesiumGantt_vue_vue_type_style_index_0_scoped_0bb78765_lang = "";
-const CesiumGantt = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-0bb78765"]]);
+const CesiumGantt_vue_vue_type_style_index_0_scoped_ca04f53e_lang = "";
+const CesiumGantt = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-ca04f53e"]]);
 class ViewportRoam {
   constructor(viewer, data, intervals) {
     __publicField(this, "viewer");