my-openlayer 2.4.2 → 2.4.4

package/core/SelectHandler.d.ts

@@ -1,33 +1,10 @@
-import Map from "ol/Map";
+import OlMap from "ol/Map";
 import { FeatureLike } from "ol/Feature";
 import { Style } from "ol/style";
 import { SelectOptions, SelectMode, ProgrammaticSelectOptions } from "../types";
 /**
  * 要素选择处理器类
  * 用于在地图上选择和高亮显示要素，支持单选、多选等多种选择模式
- *
- * @example
- * ```typescript
- * const selectHandler = new SelectHandler(map);
- *
- * // 启用点击选择
- * selectHandler.enableSelect('click', {
- *   layerFilter: ['pointLayer', 'polygonLayer'],
- *   multi: false,
- *   onSelect: (event) => {
- *     console.log('选中要素:', event.selected);
- *   }
- * });
- *
- * // 获取当前选中的要素
- * const selected = selectHandler.getSelectedFeatures();
- *
- * // 清除选择
- * selectHandler.clearSelection();
- *
- * // 禁用选择
- * selectHandler.disableSelect();
- * ```
  */
 export default class SelectHandler {
     /** OpenLayers 地图实例 */
@@ -36,14 +13,18 @@ export default class SelectHandler {
     private readonly eventManager;
     /** 错误处理器实例 */
     private readonly errorHandler;
-    /** Select 交互实例 */
-    private selectInteraction?;
+    /** 主 Select 交互实例（只负责交互，不负责渲染） */
+    private mainSelectInteraction?;
+    /** 额外的 Select 交互实例列表（用于编程式选择） */
+    private extraSelectInteractions;
+    /** 渲染用 Select 交互实例映射（用于交互式选择的高亮渲染） featureUID -> Select */
+    private renderInteractions;
     /** 当前选择模式 */
     private currentMode?;
-    /** 当前配置选项 */
-    private currentOptions?;
     /** 是否已启用选择 */
     private isEnabled;
+    /** 当前自定义样式函数（用于交互式选择） */
+    private currentSelectStyle?;
     /** 默认选中样式 - 点要素 */
     private readonly defaultPointStyle;
     /** 默认选中样式 - 线要素 */
@@ -54,7 +35,7 @@ export default class SelectHandler {
      * 构造函数
      * @param map OpenLayers地图实例
      */
-    constructor(map: Map);
+    constructor(map: OlMap);
     /**
      * 启用要素选择
      * @param mode 选择模式：'click'（点击）、'hover'（悬停）、'ctrl'（Ctrl+点击）
@@ -68,7 +49,7 @@ export default class SelectHandler {
      */
     disableSelect(): this;
     /**
-     * 获取当前选中的要素
+     * 获取当前选中的要素（仅返回主交互中的要素）
      * @returns 选中的要素数组
      */
     getSelectedFeatures(): FeatureLike[];
@@ -79,75 +60,45 @@ export default class SelectHandler {
     clearSelection(): this;
     /**
      * 通过要素ID选择要素
-     * @param featureIds 要素ID数组
-     * @param options 编程式选择配置选项
-     * @returns SelectHandler 实例（支持链式调用）
      */
     selectByIds(featureIds: string[], options?: ProgrammaticSelectOptions): this;
     /**
      * 通过属性选择要素
-     * @param propertyName 属性名称
-     * @param propertyValue 属性值
-     * @param options 编程式选择配置选项
-     * @returns SelectHandler 实例（支持链式调用）
      */
     selectByProperty(propertyName: string, propertyValue: any, options?: ProgrammaticSelectOptions): this;
     /**
-     * 判断选择是否已启用
-     * @returns 是否已启用
+     * 应用选择（编程式）
      */
-    isSelectEnabled(): boolean;
+    private applySelection;
     /**
-     * 获取当前选择模式
-     * @returns 当前选择模式
+     * 添加额外的交互实例（用于函数式样式结果）
      */
+    private addExtraInteraction;
+    private findFeaturesByIds;
+    private findFeaturesByProperty;
+    private ensureMainInteraction;
+    isSelectEnabled(): boolean;
     getCurrentMode(): SelectMode | undefined;
-    /**
-     * 定位至要素
-     * @private
-     * @param features 要素数组
-     * @param duration 动画持续时间（毫秒），默认500
-     * @param padding 边距（像素），默认100
-     */
+    updateSelectStyle(selectStyle: Style | Style[] | ((feature: FeatureLike, resolution: number) => Style | Style[])): this;
     private fitToFeatures;
-    /**
-     * 销毁选择处理器，清理所有资源
-     */
     destroy(): void;
-    /**
-     * 合并选项配置
-     * @private
-     */
-    private mergeOptions;
-    /**
-     * 创建 Select 交互
-     * @private
-     */
-    private createSelectInteraction;
-    /**
-     * 获取选择条件
-     * @private
-     */
     private getSelectCondition;
+    private createLayerFilter;
     /**
-     * 创建图层过滤器
-     * @private
+     * 计算样式（解析函数或返回默认）
      */
-    private createLayerFilter;
+    private calculateStyle;
     /**
-     * 创建选择样式
-     * @private
+     * 为单个要素创建并添加渲染交互
      */
-    private createSelectStyle;
+    private createRenderInteraction;
     /**
-     * 更新选择样式
-     * @param selectStyle 新的选择样式
-     * @returns SelectHandler 实例（支持链式调用）
+     * 移除单个要素的渲染交互
      */
-    updateSelectStyle(selectStyle: Style | Style[] | ((feature: FeatureLike) => Style | Style[])): this;
+    private removeRenderInteraction;
     /**
-     * 附加事件监听器
-     * @private
+     * 清理所有交互式渲染交互
      */
+    private clearRenderInteractions;
     private attachEventListeners;
 }