my-openlayer 2.5.5 → 3.0.2

package/core/map/ConfigManager.d.ts

@@ -1,36 +1,35 @@
+import type { Positioning } from "ol/Overlay";
 /**
- * 配置管理类
- * 用于统一管理默认配置和验证
+ * P2-1：内部默认配置存储与 setDefaults 覆盖机制。
+ *
+ * 设计要点：
+ * - 每组默认值都通过 getter 暴露，运行时 setDefaults 可叠加 partial 覆盖
+ * - 旧 callsite 直接 spread `ConfigManager.DEFAULT_X` 不需要改一行代码
+ * - 嵌套对象（如 flowSymbol）做深合并
  */
-export default class ConfigManager {
-    /**
-     * 默认点位配置
-     */
-    static readonly DEFAULT_POINT_OPTIONS: {
+interface DefaultsRegistry {
+    POINT_OPTIONS: {
         visible: boolean;
         zIndex: number;
     };
-    static readonly DEFAULT_POINT_TEXT_OPTIONS: {
+    POINT_TEXT_OPTIONS: {
         textFont: string;
         textFillColor: string;
         textStrokeColor: string;
         textStrokeWidth: number;
         textOffsetY: number;
     };
-    static readonly DEFAULT_POINT_ICON_SCALE = 1;
-    static readonly DEFAULT_CLUSTER_OPTIONS: {
+    POINT_ICON_SCALE: number;
+    CLUSTER_OPTIONS: {
         distance: number;
         minDistance: number;
         zIndex: number;
     };
-    static readonly DEFAULT_DOM_POINT_OVERLAY_OPTIONS: {
-        readonly positioning: "center-center";
-        readonly stopEvent: false;
+    DOM_POINT_OVERLAY_OPTIONS: {
+        positioning: Positioning;
+        stopEvent: boolean;
     };
-    /**
-     * 默认线配置
-     */
-    static readonly DEFAULT_LINE_OPTIONS: {
+    LINE_OPTIONS: {
         type: string;
         strokeColor: string;
         strokeWidth: number;
@@ -38,34 +37,8 @@ export default class ConfigManager {
         layerName: string;
         zIndex: number;
     };
-    /**
-     * 默认流动线动画配置
-     */
-    static readonly DEFAULT_FLOW_LINE_OPTIONS: {
-        readonly duration: 4000;
-        readonly loop: true;
-        readonly autoStart: true;
-        readonly showBaseLine: true;
-        readonly animationMode: "icon";
-        readonly flowSymbol: {
-            readonly scale: 0.8;
-            readonly rotateWithView: true;
-            readonly count: 1;
-            readonly spacing: 0.15;
-        };
-        readonly trailEnabled: false;
-        readonly trailLength: 0;
-        readonly zIndex: 16;
-        readonly type: string;
-        readonly strokeColor: string;
-        readonly strokeWidth: number;
-        readonly visible: boolean;
-        readonly layerName: string;
-    };
-    /**
-     * 默认面配置
-     */
-    static readonly DEFAULT_POLYGON_OPTIONS: {
+    FLOW_LINE_OPTIONS: any;
+    POLYGON_OPTIONS: {
         zIndex: number;
         visible: boolean;
         textFont: string;
@@ -73,96 +46,160 @@ export default class ConfigManager {
         textStrokeColor: string;
         textStrokeWidth: number;
     };
-    static readonly DEFAULT_POLYGON_COLOR_MAP: {
-        '0': string;
-        '1': string;
-        '2': string;
-        '3': string;
-    };
-    /**
-     * 默认图片图层配置
-     */
-    static readonly DEFAULT_IMAGE_OPTIONS: {
+    POLYGON_COLOR_MAP: Record<string, string>;
+    IMAGE_OPTIONS: {
         opacity: number;
         visible: boolean;
         layerName: string;
         zIndex: number;
     };
-    /**
-     * 默认遮罩图层配置
-     */
-    static readonly DEFAULT_MASK_OPTIONS: {
+    MASK_OPTIONS: {
         fillColor: string;
         opacity: number;
         visible: boolean;
         layerName: string;
+        zIndex: number;
     };
-    /**
-     * 默认文本配置
-     */
-    static readonly DEFAULT_TEXT_OPTIONS: {
+    TEXT_OPTIONS: {
         textFont: string;
         textFillColor: string;
         textStrokeColor: string;
         textStrokeWidth: number;
     };
-    static readonly DEFAULT_HEATMAP_OPTIONS: {
+    HEATMAP_OPTIONS: {
         blur: number;
         radius: number;
         zIndex: number;
         opacity: number;
     };
-    static readonly DEFAULT_HEATMAP_VALUE_KEY = "value";
-    static readonly TIANDITU_CONFIG: {
-        readonly BASE_URL: "//t{0-7}.tianditu.gov.cn/DataServer";
-        readonly PROJECTION: "EPSG:4326";
-        readonly DEFAULT_ZINDEX: 9;
-        readonly ANNOTATION_ZINDEX_OFFSET: 10;
+    HEATMAP_VALUE_KEY: string;
+    TIANDITU_CONFIG: {
+        BASE_URL: string;
+        PROJECTION: string;
+        DEFAULT_ZINDEX: number;
+        ANNOTATION_ZINDEX_OFFSET: number;
     };
-    static readonly DEFAULT_MAP_LAYERS_OPTIONS: {
-        zIndex: 9;
+    MAP_LAYERS_OPTIONS: {
+        zIndex: number;
         annotation: boolean;
         mapClip: boolean;
-        mapClipData: undefined;
+        mapClipData: any;
     };
-    static readonly DEFAULT_MYOL_OPTIONS: {
-        layers: undefined;
+    MYOL_OPTIONS: {
+        layers: any;
         zoom: number;
         center: number[];
-        extent: undefined;
-    };
-    static readonly DEFAULT_VUE_TEMPLATE_POINT_OPTIONS: {
-        readonly positioning: "center-center";
-        readonly stopEvent: false;
-        readonly visible: true;
-        readonly zIndex: 1;
-    };
-    static readonly DEFAULT_RIVER_LEVEL_WIDTH_MAP: {
-        1: number;
-        2: number;
-        3: number;
-        4: number;
-        5: number;
-    };
-    static readonly DEFAULT_RIVER_LAYERS_BY_ZOOM_OPTIONS: {
+        extent: any;
+    };
+    VUE_TEMPLATE_POINT_OPTIONS: {
+        positioning: Positioning;
+        stopEvent: boolean;
+        visible: boolean;
+        zIndex: number;
+    };
+}
+/**
+ * 配置管理类
+ * 用于统一管理默认配置和验证
+ *
+ * 运行时修改默认值：调用 ConfigManager.setDefaults('LINE_OPTIONS', { strokeWidth: 4 })
+ * 之后所有新创建的 Line/FlowLine 都将以此为默认。
+ */
+export default class ConfigManager {
+    /** 运行时覆盖默认配置。partial 会与现有 default 做深合并，未提到的键保持原值。 */
+    static setDefaults<K extends keyof DefaultsRegistry>(group: K, partial: Partial<DefaultsRegistry[K]>): void;
+    /** 取当前运行时 default（含 setDefaults 覆盖后的结果），返回深拷贝避免被外部修改。 */
+    static getDefaults<K extends keyof DefaultsRegistry>(group: K): DefaultsRegistry[K];
+    /** 把所有 setDefaults 覆盖清掉，恢复到内置默认值。 */
+    static resetDefaults(group?: keyof DefaultsRegistry): void;
+    static get DEFAULT_POINT_OPTIONS(): {
+        visible: boolean;
+        zIndex: number;
+    };
+    static get DEFAULT_POINT_TEXT_OPTIONS(): {
+        textFont: string;
+        textFillColor: string;
+        textStrokeColor: string;
+        textStrokeWidth: number;
+        textOffsetY: number;
+    };
+    static get DEFAULT_POINT_ICON_SCALE(): number;
+    static get DEFAULT_CLUSTER_OPTIONS(): {
+        distance: number;
+        minDistance: number;
+        zIndex: number;
+    };
+    static get DEFAULT_DOM_POINT_OVERLAY_OPTIONS(): {
+        positioning: Positioning;
+        stopEvent: boolean;
+    };
+    static get DEFAULT_LINE_OPTIONS(): {
         type: string;
-        levelCount: number;
-        zoomOffset: number;
         strokeColor: string;
         strokeWidth: number;
         visible: boolean;
+        layerName: string;
+        zIndex: number;
+    };
+    static get DEFAULT_FLOW_LINE_OPTIONS(): any;
+    static get DEFAULT_POLYGON_OPTIONS(): {
         zIndex: number;
+        visible: boolean;
+        textFont: string;
+        textFillColor: string;
+        textStrokeColor: string;
+        textStrokeWidth: number;
+    };
+    static get DEFAULT_POLYGON_COLOR_MAP(): Record<string, string>;
+    static get DEFAULT_IMAGE_OPTIONS(): {
+        opacity: number;
+        visible: boolean;
         layerName: string;
-        removeExisting: boolean;
+        zIndex: number;
     };
-    static readonly DEFAULT_RIVER_WIDTH_BY_LEVEL_OPTIONS: {
-        type: string;
+    static get DEFAULT_MASK_OPTIONS(): {
+        fillColor: string;
+        opacity: number;
+        visible: boolean;
         layerName: string;
-        strokeColor: string;
-        strokeWidth: number;
+        zIndex: number;
+    };
+    static get DEFAULT_TEXT_OPTIONS(): {
+        textFont: string;
+        textFillColor: string;
+        textStrokeColor: string;
+        textStrokeWidth: number;
+    };
+    static get DEFAULT_HEATMAP_OPTIONS(): {
+        blur: number;
+        radius: number;
+        zIndex: number;
+        opacity: number;
+    };
+    static get DEFAULT_HEATMAP_VALUE_KEY(): string;
+    static get TIANDITU_CONFIG(): {
+        BASE_URL: string;
+        PROJECTION: string;
+        DEFAULT_ZINDEX: number;
+        ANNOTATION_ZINDEX_OFFSET: number;
+    };
+    static get DEFAULT_MAP_LAYERS_OPTIONS(): {
+        zIndex: number;
+        annotation: boolean;
+        mapClip: boolean;
+        mapClipData: any;
+    };
+    static get DEFAULT_MYOL_OPTIONS(): {
+        layers: any;
+        zoom: number;
+        center: number[];
+        extent: any;
+    };
+    static get DEFAULT_VUE_TEMPLATE_POINT_OPTIONS(): {
+        positioning: Positioning;
+        stopEvent: boolean;
         visible: boolean;
         zIndex: number;
-        removeExisting: boolean;
     };
     /**
      * 合并配置选项
@@ -184,3 +221,4 @@ export default class ConfigManager {
      */
     static deepClone<T>(obj: T): T;
 }
+export {};

package/core/map/ConfigManager.js

@@ -1,8 +1,151 @@
+const BUILTIN_DEFAULTS = {
+    POINT_OPTIONS: { visible: true, zIndex: 21 },
+    POINT_TEXT_OPTIONS: {
+        textFont: '12px Calibri,sans-serif',
+        textFillColor: '#FFF',
+        textStrokeColor: '#000',
+        textStrokeWidth: 3,
+        textOffsetY: 20
+    },
+    POINT_ICON_SCALE: 1,
+    CLUSTER_OPTIONS: { distance: 40, minDistance: 0, zIndex: 21 },
+    DOM_POINT_OVERLAY_OPTIONS: { positioning: 'center-center', stopEvent: false },
+    LINE_OPTIONS: {
+        type: 'line',
+        strokeColor: 'rgba(3, 122, 255, 1)',
+        strokeWidth: 2,
+        visible: true,
+        layerName: 'lineLayer',
+        zIndex: 15
+    },
+    FLOW_LINE_OPTIONS: {
+        type: 'line',
+        strokeColor: 'rgba(3, 122, 255, 1)',
+        strokeWidth: 2,
+        visible: true,
+        layerName: 'lineLayer',
+        duration: 4000,
+        loop: true,
+        autoStart: true,
+        showBaseLine: true,
+        animationMode: 'icon',
+        flowSymbol: {
+            scale: 0.8,
+            rotateWithView: true,
+            count: 1,
+            spacing: 0.15
+        },
+        trailEnabled: false,
+        trailLength: 0,
+        zIndex: 16
+    },
+    POLYGON_OPTIONS: {
+        zIndex: 11,
+        visible: true,
+        textFont: '14px Calibri,sans-serif',
+        textFillColor: '#FFF',
+        textStrokeColor: '#409EFF',
+        textStrokeWidth: 2
+    },
+    POLYGON_COLOR_MAP: {
+        '0': 'rgba(255, 0, 0, 0.6)',
+        '1': 'rgba(245, 154, 35, 0.6)',
+        '2': 'rgba(255, 238, 0, 0.6)',
+        '3': 'rgba(1, 111, 255, 0.6)'
+    },
+    IMAGE_OPTIONS: { opacity: 1, visible: true, layerName: 'imageLayer', zIndex: 11 },
+    MASK_OPTIONS: { fillColor: 'rgba(0, 0, 0, 0.5)', opacity: 1, visible: true, layerName: 'maskLayer', zIndex: 12 },
+    TEXT_OPTIONS: { textFont: '14px Calibri,sans-serif', textFillColor: '#FFF', textStrokeColor: '#409EFF', textStrokeWidth: 2 },
+    HEATMAP_OPTIONS: { blur: 15, radius: 10, zIndex: 11, opacity: 1 },
+    HEATMAP_VALUE_KEY: 'value',
+    TIANDITU_CONFIG: {
+        BASE_URL: '//t{0-7}.tianditu.gov.cn/DataServer',
+        PROJECTION: 'EPSG:4326',
+        DEFAULT_ZINDEX: 9,
+        ANNOTATION_ZINDEX_OFFSET: 10
+    },
+    MAP_LAYERS_OPTIONS: { zIndex: 9, annotation: false, mapClip: false, mapClipData: undefined },
+    MYOL_OPTIONS: { layers: undefined, zoom: 10, center: [119.81, 29.969], extent: undefined },
+    VUE_TEMPLATE_POINT_OPTIONS: { positioning: 'center-center', stopEvent: false, visible: true, zIndex: 1 }
+};
+/**
+ * 当前生效的 defaults。运行时通过 setDefaults 修改这里的值，getter 再合并。
+ * 深拷贝一份避免外部意外修改 BUILTIN_DEFAULTS。
+ */
+const currentDefaults = deepClone(BUILTIN_DEFAULTS);
+function deepClone(obj) {
+    if (obj === null || typeof obj !== 'object')
+        return obj;
+    if (obj instanceof Date)
+        return new Date(obj.getTime());
+    if (Array.isArray(obj))
+        return obj.map(item => deepClone(item));
+    const cloned = {};
+    for (const k in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, k))
+            cloned[k] = deepClone(obj[k]);
+    }
+    return cloned;
+}
+function deepMerge(base, partial) {
+    const result = Array.isArray(base) ? [...base] : { ...base };
+    for (const k of Object.keys(partial)) {
+        const v = partial[k];
+        if (v && typeof v === 'object' && !Array.isArray(v) && !(v instanceof Date)) {
+            result[k] = deepMerge(result[k] ?? {}, v);
+        }
+        else {
+            result[k] = v;
+        }
+    }
+    return result;
+}
 /**
  * 配置管理类
  * 用于统一管理默认配置和验证
+ *
+ * 运行时修改默认值：调用 ConfigManager.setDefaults('LINE_OPTIONS', { strokeWidth: 4 })
+ * 之后所有新创建的 Line/FlowLine 都将以此为默认。
  */
-class ConfigManager {
+export default class ConfigManager {
+    /** 运行时覆盖默认配置。partial 会与现有 default 做深合并，未提到的键保持原值。 */
+    static setDefaults(group, partial) {
+        currentDefaults[group] = deepMerge(currentDefaults[group], partial);
+    }
+    /** 取当前运行时 default（含 setDefaults 覆盖后的结果），返回深拷贝避免被外部修改。 */
+    static getDefaults(group) {
+        return deepClone(currentDefaults[group]);
+    }
+    /** 把所有 setDefaults 覆盖清掉，恢复到内置默认值。 */
+    static resetDefaults(group) {
+        if (group) {
+            currentDefaults[group] = deepClone(BUILTIN_DEFAULTS[group]);
+        }
+        else {
+            Object.keys(BUILTIN_DEFAULTS).forEach(k => {
+                currentDefaults[k] = deepClone(BUILTIN_DEFAULTS[k]);
+            });
+        }
+    }
+    // ---------------- 兼容性 getter（旧 callsite 直接读字段，setDefaults 透明生效）----------------
+    static get DEFAULT_POINT_OPTIONS() { return currentDefaults.POINT_OPTIONS; }
+    static get DEFAULT_POINT_TEXT_OPTIONS() { return currentDefaults.POINT_TEXT_OPTIONS; }
+    static get DEFAULT_POINT_ICON_SCALE() { return currentDefaults.POINT_ICON_SCALE; }
+    static get DEFAULT_CLUSTER_OPTIONS() { return currentDefaults.CLUSTER_OPTIONS; }
+    static get DEFAULT_DOM_POINT_OVERLAY_OPTIONS() { return currentDefaults.DOM_POINT_OVERLAY_OPTIONS; }
+    static get DEFAULT_LINE_OPTIONS() { return currentDefaults.LINE_OPTIONS; }
+    static get DEFAULT_FLOW_LINE_OPTIONS() { return currentDefaults.FLOW_LINE_OPTIONS; }
+    static get DEFAULT_POLYGON_OPTIONS() { return currentDefaults.POLYGON_OPTIONS; }
+    static get DEFAULT_POLYGON_COLOR_MAP() { return currentDefaults.POLYGON_COLOR_MAP; }
+    static get DEFAULT_IMAGE_OPTIONS() { return currentDefaults.IMAGE_OPTIONS; }
+    static get DEFAULT_MASK_OPTIONS() { return currentDefaults.MASK_OPTIONS; }
+    static get DEFAULT_TEXT_OPTIONS() { return currentDefaults.TEXT_OPTIONS; }
+    static get DEFAULT_HEATMAP_OPTIONS() { return currentDefaults.HEATMAP_OPTIONS; }
+    static get DEFAULT_HEATMAP_VALUE_KEY() { return currentDefaults.HEATMAP_VALUE_KEY; }
+    static get TIANDITU_CONFIG() { return currentDefaults.TIANDITU_CONFIG; }
+    static get DEFAULT_MAP_LAYERS_OPTIONS() { return currentDefaults.MAP_LAYERS_OPTIONS; }
+    static get DEFAULT_MYOL_OPTIONS() { return currentDefaults.MYOL_OPTIONS; }
+    static get DEFAULT_VUE_TEMPLATE_POINT_OPTIONS() { return currentDefaults.VUE_TEMPLATE_POINT_OPTIONS; }
     /**
      * 合并配置选项
      * @param defaultOptions 默认配置
@@ -29,179 +172,6 @@ class ConfigManager {
      * @returns 克隆后的对象
      */
     static deepClone(obj) {
-        if (obj === null || typeof obj !== 'object') {
-            return obj;
-        }
-        if (obj instanceof Date) {
-            return new Date(obj.getTime());
-        }
-        if (Array.isArray(obj)) {
-            return obj.map(item => ConfigManager.deepClone(item));
-        }
-        const cloned = {};
-        for (const key in obj) {
-            if (obj.hasOwnProperty(key)) {
-                cloned[key] = ConfigManager.deepClone(obj[key]);
-            }
-        }
-        return cloned;
+        return deepClone(obj);
     }
 }
-/**
- * 默认点位配置
- */
-ConfigManager.DEFAULT_POINT_OPTIONS = {
-    visible: true,
-    zIndex: 21
-};
-ConfigManager.DEFAULT_POINT_TEXT_OPTIONS = {
-    textFont: '12px Calibri,sans-serif',
-    textFillColor: '#FFF',
-    textStrokeColor: '#000',
-    textStrokeWidth: 3,
-    textOffsetY: 20
-};
-ConfigManager.DEFAULT_POINT_ICON_SCALE = 1;
-ConfigManager.DEFAULT_CLUSTER_OPTIONS = {
-    distance: 40,
-    minDistance: 0,
-    zIndex: 21
-};
-ConfigManager.DEFAULT_DOM_POINT_OVERLAY_OPTIONS = {
-    positioning: 'center-center',
-    stopEvent: false
-};
-/**
- * 默认线配置
- */
-ConfigManager.DEFAULT_LINE_OPTIONS = {
-    type: 'line',
-    strokeColor: 'rgba(3, 122, 255, 1)',
-    strokeWidth: 2,
-    visible: true,
-    layerName: 'lineLayer',
-    zIndex: 15
-};
-/**
- * 默认流动线动画配置
- */
-ConfigManager.DEFAULT_FLOW_LINE_OPTIONS = {
-    ...ConfigManager.DEFAULT_LINE_OPTIONS,
-    duration: 4000,
-    loop: true,
-    autoStart: true,
-    showBaseLine: true,
-    animationMode: 'icon',
-    flowSymbol: {
-        scale: 0.8,
-        rotateWithView: true,
-        count: 1,
-        spacing: 0.15
-    },
-    trailEnabled: false,
-    trailLength: 0,
-    zIndex: 16
-};
-/**
- * 默认面配置
- */
-ConfigManager.DEFAULT_POLYGON_OPTIONS = {
-    zIndex: 11,
-    visible: true,
-    textFont: '14px Calibri,sans-serif',
-    textFillColor: '#FFF',
-    textStrokeColor: '#409EFF',
-    textStrokeWidth: 2
-};
-ConfigManager.DEFAULT_POLYGON_COLOR_MAP = {
-    '0': 'rgba(255, 0, 0, 0.6)',
-    '1': 'rgba(245, 154, 35, 0.6)',
-    '2': 'rgba(255, 238, 0, 0.6)',
-    '3': 'rgba(1, 111, 255, 0.6)'
-};
-/**
- * 默认图片图层配置
- */
-ConfigManager.DEFAULT_IMAGE_OPTIONS = {
-    opacity: 1,
-    visible: true,
-    layerName: 'imageLayer',
-    zIndex: 11
-};
-/**
- * 默认遮罩图层配置
- */
-ConfigManager.DEFAULT_MASK_OPTIONS = {
-    fillColor: 'rgba(0, 0, 0, 0.5)',
-    opacity: 1,
-    visible: true,
-    layerName: 'maskLayer'
-};
-/**
- * 默认文本配置
- */
-ConfigManager.DEFAULT_TEXT_OPTIONS = {
-    textFont: '14px Calibri,sans-serif',
-    textFillColor: '#FFF',
-    textStrokeColor: '#409EFF',
-    textStrokeWidth: 2
-};
-ConfigManager.DEFAULT_HEATMAP_OPTIONS = {
-    blur: 15,
-    radius: 10,
-    zIndex: 11,
-    opacity: 1
-};
-ConfigManager.DEFAULT_HEATMAP_VALUE_KEY = 'value';
-ConfigManager.TIANDITU_CONFIG = {
-    BASE_URL: '//t{0-7}.tianditu.gov.cn/DataServer',
-    PROJECTION: 'EPSG:4326',
-    DEFAULT_ZINDEX: 9,
-    ANNOTATION_ZINDEX_OFFSET: 10
-};
-ConfigManager.DEFAULT_MAP_LAYERS_OPTIONS = {
-    zIndex: ConfigManager.TIANDITU_CONFIG.DEFAULT_ZINDEX,
-    annotation: false,
-    mapClip: false,
-    mapClipData: undefined
-};
-ConfigManager.DEFAULT_MYOL_OPTIONS = {
-    layers: undefined,
-    zoom: 10,
-    center: [119.81, 29.969],
-    extent: undefined
-};
-ConfigManager.DEFAULT_VUE_TEMPLATE_POINT_OPTIONS = {
-    positioning: 'center-center',
-    stopEvent: false,
-    visible: true,
-    zIndex: 1
-};
-ConfigManager.DEFAULT_RIVER_LEVEL_WIDTH_MAP = {
-    1: 2,
-    2: 1,
-    3: 0.5,
-    4: 0.5,
-    5: 0.5
-};
-ConfigManager.DEFAULT_RIVER_LAYERS_BY_ZOOM_OPTIONS = {
-    type: 'river',
-    levelCount: 5,
-    zoomOffset: 8,
-    strokeColor: 'rgb(0,113,255)',
-    strokeWidth: 3,
-    visible: true,
-    zIndex: 15,
-    layerName: 'riverLayer',
-    removeExisting: false
-};
-ConfigManager.DEFAULT_RIVER_WIDTH_BY_LEVEL_OPTIONS = {
-    type: 'river',
-    layerName: 'river',
-    strokeColor: 'rgba(3, 122, 255, 1)',
-    strokeWidth: 2,
-    visible: true,
-    zIndex: 15,
-    removeExisting: false
-};
-export default ConfigManager;

package/core/map/MapBaseLayers.d.ts

@@ -8,6 +8,7 @@ import { Tile as TileLayer } from "ol/layer";
 import { TileWMS } from "ol/source";
 import WMTSTileGrid from "ol/tilegrid/WMTS";
 import XYZ from "ol/source/XYZ";
+import BaseLayer from "ol/layer/Base";
 import { MapLayersOptions, TiandituType, AnnotationLayerOptions, AnnotationType } from "../../types";
 /**
  * GeoServer图层选项接口
@@ -100,6 +101,11 @@ export default class MapBaseLayers {
      * 获取当前底图类型
      */
     getCurrentBaseLayerType(): string | null;
+    /**
+     * 获取当前可见底图对应的 BaseLayer 数组（多 layer 的底图类型会返回多个）。
+     * 用于 MapTools.setMapClip 等需要直接操作底图实例的场景。
+     */
+    getCurrentBaseLayers(): BaseLayer[];
     /**
      * 获取默认底图类型
      * @private

package/core/map/MapBaseLayers.js

@@ -183,6 +183,15 @@ export default class MapBaseLayers {
     getCurrentBaseLayerType() {
         return this.currentBaseLayerType;
     }
+    /**
+     * 获取当前可见底图对应的 BaseLayer 数组（多 layer 的底图类型会返回多个）。
+     * 用于 MapTools.setMapClip 等需要直接操作底图实例的场景。
+     */
+    getCurrentBaseLayers() {
+        if (!this.currentBaseLayerType)
+            return [];
+        return (this.layers[this.currentBaseLayerType] ?? []);
+    }
     /**
      * 获取默认底图类型
      * @private