@xingm/vmap-cesium-toolbar 0.0.6 → 1.0.0

package/dist/core/services/toolbar/buttons/SearchButtonHandler.d.ts

@@ -0,0 +1,111 @@
+import { BaseButtonHandler } from './BaseButtonHandler';
+import { ToolbarButton } from '../../../../components/ToolbarButton';
+interface SearchContainerStyleConfig {
+    containerStyle?: Partial<CSSStyleDeclaration>;
+    inputStyle?: Partial<CSSStyleDeclaration>;
+    actionButtonStyle?: Partial<CSSStyleDeclaration>;
+    actionIconStyle?: Partial<CSSStyleDeclaration>;
+    resultStyle?: Partial<CSSStyleDeclaration>;
+    resultItemStyle?: Partial<CSSStyleDeclaration>;
+    resultItemHoverStyle?: Partial<CSSStyleDeclaration>;
+    resultItemActiveStyle?: Partial<CSSStyleDeclaration>;
+    buttonStyle?: Partial<CSSStyleDeclaration>;
+    resultItemIconStyle?: Partial<CSSStyleDeclaration>;
+}
+/**
+ * 搜索按钮处理器配置
+ */
+export interface SearchButtonHandlerOptions {
+    /** 搜索服务实例 */
+    searchService?: any;
+    /** 搜索框样式 */
+    searchContainerStyle?: SearchContainerStyleConfig;
+    /** 默认动作图标 */
+    idleActionIcon?: string | HTMLElement;
+    /** 清空动作图标 */
+    clearActionIcon?: string | HTMLElement;
+    /** 搜索回调 */
+    onSearch?: (query: string) => Promise<any[]>;
+    /** 搜索选择回调 */
+    onSelect?: (result: any) => void;
+}
+/**
+ * 搜索按钮处理器类
+ */
+export declare class SearchButtonHandler extends BaseButtonHandler {
+    readonly id = "search";
+    private static readonly SCROLLBAR_STYLE_ID;
+    private static readonly INPUT_SEARCH_DEBOUNCE_MS;
+    private options;
+    private styleConfig;
+    private searchContainer;
+    private searchTimer;
+    private latestSearchToken;
+    private normalizeStyleConfig;
+    private ensureScrollbarStyles;
+    private clearSearchResults;
+    private getEmptyResultText;
+    private resetSearchTimer;
+    private scheduleInputSearch;
+    /**
+     * 构造函数
+     * @param viewer Cesium Viewer 实例
+     * @param options 配置选项
+     * @param i18n 国际化实例
+     * @param useI18n 是否使用国际化
+     */
+    constructor(viewer: any, options?: SearchButtonHandlerOptions, i18n?: any, useI18n?: boolean);
+    updateOptions(options: Partial<SearchButtonHandlerOptions>): void;
+    /**
+     * 获取默认样式
+     */
+    private getDefaultStyles;
+    /**
+     * 初始化按钮
+     * @param button 按钮实例
+     */
+    initialize(button: ToolbarButton): void;
+    /**
+     * 处理点击事件
+     */
+    handleClick(): void;
+    /**
+     * 处理鼠标离开事件
+     */
+    handleMouseLeave(): void;
+    /**
+     * 销毁处理器
+     */
+    destroy(): void;
+    /**
+     * 切换搜索框显示
+     * @param anchor 锚点元素
+     */
+    toggleSearch(anchor: HTMLElement): void;
+    /**
+     * 显示搜索框
+     * @param anchor 锚点元素
+     */
+    private showSearch;
+    /**
+     * 执行搜索
+     * @param query 搜索关键词
+     */
+    private doSearch;
+    /**
+     * 显示搜索结果
+     * @param results 搜索结果数组
+     */
+    private showSearchResults;
+    /**
+     * 调整搜索框位置避免溢出视口
+     */
+    private adjustSearchPosition;
+    private createActionIconElement;
+    private isImagePath;
+    /**
+     * 关闭搜索框
+     */
+    closeSearch(): void;
+}
+export {};

package/dist/core/services/toolbar/buttons/SimpleButtonHandler.d.ts

@@ -0,0 +1,79 @@
+import { BaseButtonHandler } from './BaseButtonHandler';
+import { ToolbarButton } from '../../../../components/ToolbarButton';
+/**
+ * 简单按钮配置
+ */
+export interface SimpleButtonConfig {
+    /** 按钮 ID */
+    id: string;
+    /** 按钮标题 */
+    title: string;
+    /** 标题翻译键 */
+    titleKey?: string;
+    /** 图标 */
+    icon: string | HTMLElement;
+    /** 激活态图标 */
+    activeIcon?: string | HTMLElement;
+    /** 点击回调 */
+    onClick?: () => void;
+    /** 是否需要激活状态 */
+    toggleable?: boolean;
+}
+/**
+ * 地图控制器接口
+ */
+export interface MapControllerLike {
+    toggle2D3D?: (button: HTMLElement) => void;
+    resetLocation?: () => void;
+    zoomIn?: () => void;
+    zoomOut?: () => void;
+    toggleFullscreen?: () => void;
+}
+/**
+ * 简单按钮处理器类
+ */
+export declare class SimpleButtonHandler extends BaseButtonHandler {
+    readonly id: string;
+    private config;
+    private mapController?;
+    /**
+     * 构造函数
+     * @param config 按钮配置
+     * @param viewer Cesium Viewer 实例
+     * @param mapController 地图控制器
+     * @param i18n 国际化实例
+     * @param useI18n 是否使用国际化
+     */
+    constructor(config: SimpleButtonConfig, viewer: any, mapController?: MapControllerLike, i18n?: any, useI18n?: boolean);
+    /**
+     * 初始化按钮
+     * @param button 按钮实例
+     */
+    initialize(button: ToolbarButton): void;
+    /**
+     * 处理点击事件
+     */
+    handleClick(): void;
+    /**
+     * 销毁处理器
+     */
+    destroy(): void;
+    /**
+     * 设置地图控制器
+     * @param controller 地图控制器
+     */
+    setMapController(controller: MapControllerLike): void;
+    /**
+     * 切换激活状态
+     */
+    toggleActive(): void;
+    /**
+     * 设置激活状态
+     * @param active 是否激活
+     */
+    setActive(active: boolean): void;
+}
+/**
+ * 创建简单按钮处理器的工厂函数
+ */
+export declare function createSimpleButtonHandler(config: SimpleButtonConfig, viewer: any, mapController?: MapControllerLike, i18n?: any, useI18n?: boolean): SimpleButtonHandler;

package/dist/core/services/toolbar/config.d.ts

@@ -0,0 +1,7 @@
+import { CustomButtonConfig, MapType, ToolbarConfig } from '../../types';
+import { MeasureMenuItem } from './types';
+export declare const DEFAULT_BUTTON_SORTS: Record<string, number>;
+export declare const DEFAULT_BUTTON_CONFIGS: CustomButtonConfig[];
+export declare const DEFAULT_MEASURE_ITEMS: MeasureMenuItem[];
+export declare const DEFAULT_TOOLBAR_STYLE: ToolbarConfig;
+export declare const DEFAULT_MAP_TYPES: MapType[];

package/dist/core/services/toolbar/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 工具栏服务模块
+ *
+ * 提供基于分层架构的工具栏功能实现：
+ * - ToolbarService: 核心服务类，负责工具栏的创建和管理
+ * - BaseButtonHandler: 按钮处理器基类
+ * - SimpleButtonHandler: 简单按钮处理器（2D/3D、定位、缩放、全屏）
+ * - SearchButtonHandler: 搜索按钮处理器
+ * - MeasureButtonHandler: 测量按钮处理器
+ * - LayersButtonHandler: 图层按钮处理器
+ * - BaseMenu: 菜单基类
+ * - MeasureMenu: 测量菜单
+ */
+export { ToolbarService, createToolbarService } from './ToolbarService';
+export type { ToolbarServiceOptions } from './ToolbarService';
+export type { IButtonHandler, IMenu, ToolbarServiceConfig, ToolbarCallbacks, MeasurementCompleteEvent, MeasurementServiceLike, SearchResult, SearchServiceConfig, MeasurementServiceConfig, LayersServiceConfig, NoFlyZoneServiceConfig, MapControllerConfig, DefaultButtonConfig, MeasureMenuItem, } from './types';
+export { BaseButtonHandler } from './buttons/BaseButtonHandler';
+export { SimpleButtonHandler, createSimpleButtonHandler } from './buttons/SimpleButtonHandler';
+export type { SimpleButtonConfig, MapControllerLike } from './buttons/SimpleButtonHandler';
+export { SearchButtonHandler } from './buttons/SearchButtonHandler';
+export type { SearchButtonHandlerOptions } from './buttons/SearchButtonHandler';
+export { MeasureButtonHandler } from './buttons/MeasureButtonHandler';
+export type { MeasureButtonHandlerOptions } from './buttons/MeasureButtonHandler';
+export { LayersButtonHandler } from './buttons/LayersButtonHandler';
+export type { LayersButtonHandlerOptions, MapTypeConfig } from './buttons/LayersButtonHandler';
+export { BaseMenu } from './menus/BaseMenu';
+export type { MenuPositionConfig } from './menus/BaseMenu';
+export { MeasureMenu } from './menus/MeasureMenu';
+export type { MeasureMenuOptions } from './menus/MeasureMenu';
+export { DEFAULT_BUTTON_CONFIGS, DEFAULT_BUTTON_SORTS, DEFAULT_MEASURE_ITEMS, DEFAULT_TOOLBAR_STYLE, DEFAULT_MAP_TYPES, } from './config';

package/dist/core/services/toolbar/menus/BaseMenu.d.ts

@@ -0,0 +1,99 @@
+import { IMenu } from '../types';
+/**
+ * 菜单位置配置
+ */
+export interface MenuPositionConfig {
+    /** 相对于锚点的位置 */
+    position?: 'left' | 'right' | 'top' | 'bottom';
+    /** 偏移量（像素） */
+    offset?: number;
+    /** 顶部偏移（像素） */
+    topOffset?: number;
+}
+/**
+ * 菜单基类
+ */
+export declare abstract class BaseMenu implements IMenu {
+    /** 菜单元素 */
+    protected menuElement: HTMLElement | null;
+    /** 工具栏容器元素 */
+    protected toolbarElement: HTMLElement | null;
+    /** 当前锚点元素 */
+    protected anchorElement: HTMLElement | null;
+    /** 是否已销毁 */
+    protected isDestroyed: boolean;
+    /** 国际化实例 */
+    protected i18n?: any;
+    /** 是否使用国际化 */
+    protected useI18n: boolean;
+    /**
+     * 构造函数
+     * @param toolbarElement 工具栏容器元素
+     * @param i18n 国际化实例
+     * @param useI18n 是否使用国际化
+     */
+    constructor(toolbarElement: HTMLElement, i18n?: any, useI18n?: boolean);
+    /**
+     * 显示菜单（由子类实现具体渲染逻辑）
+     * @param anchor 锚点元素
+     */
+    abstract show(anchor: HTMLElement): void;
+    /**
+     * 隐藏菜单
+     */
+    hide(): void;
+    /**
+     * 切换菜单显示状态
+     * @param anchor 锚点元素
+     */
+    toggle(anchor: HTMLElement): void;
+    /**
+     * 销毁菜单
+     */
+    destroy(): void;
+    /**
+     * 创建菜单容器元素
+     * @param className 类名
+     * @param customStyles 自定义样式
+     */
+    protected createMenuContainer(className: string, customStyles?: Partial<CSSStyleDeclaration>): HTMLElement;
+    /**
+     * 定位菜单到锚点元素
+     * @param anchor 锚点元素
+     * @param config 位置配置
+     */
+    protected positionMenu(anchor: HTMLElement, config?: MenuPositionConfig): void;
+    /**
+     * 调整菜单位置以避免超出可视区域
+     */
+    protected adjustPosition(): void;
+    /**
+     * 翻译文本
+     * @param key 翻译键
+     * @param params 翻译参数
+     */
+    protected t(key: string, params?: Record<string, any>): string;
+    /**
+     * 绑定元素翻译
+     * @param element DOM 元素
+     * @param key 翻译键
+     * @param attribute 属性名
+     */
+    protected bindElement(element: HTMLElement, key: string, attribute?: string): void;
+    /**
+     * 创建菜单项
+     * @param id 菜单项 ID
+     * @param text 显示文本
+     * @param textKey 翻译键
+     * @param icon 图标
+     * @param onClick 点击回调
+     */
+    protected createMenuItem(id: string, text: string, textKey: string | undefined, icon: string, onClick: () => void): HTMLElement;
+    private createIconElement;
+    private isImagePath;
+    /**
+     * 设置菜单鼠标离开自动关闭
+     * @param delay 延迟时间（毫秒）
+     */
+    protected setupAutoClose(delay?: number): void;
+}

package/dist/core/services/toolbar/menus/MeasureMenu.d.ts

@@ -0,0 +1,44 @@
+import { BaseMenu } from './BaseMenu';
+import { MeasureMenuItem } from '../types';
+/**
+ * 测量菜单配置
+ */
+export interface MeasureMenuOptions {
+    /** 菜单项配置 */
+    items?: MeasureMenuItem[];
+    /** 测距开始回调 */
+    onDistanceStart?: () => void;
+    /** 测面积开始回调 */
+    onAreaStart?: () => void;
+    /** 清除测量回调 */
+    onClear?: () => void;
+}
+/**
+ * 测量菜单类
+ */
+export declare class MeasureMenu extends BaseMenu {
+    private options;
+    private items;
+    /**
+     * 构造函数
+     * @param toolbarElement 工具栏容器元素
+     * @param options 菜单配置
+     * @param i18n 国际化实例
+     * @param useI18n 是否使用国际化
+     */
+    constructor(toolbarElement: HTMLElement, options?: MeasureMenuOptions, i18n?: any, useI18n?: boolean);
+    /**
+     * 显示菜单
+     * @param anchor 锚点元素
+     */
+    show(anchor: HTMLElement): void;
+    /**
+     * 处理菜单项点击
+     * @param itemId 菜单项 ID
+     */
+    private handleItemClick;
+    /**
+     * 销毁菜单
+     */
+    destroy(): void;
+}

package/dist/core/services/toolbar/types.d.ts

@@ -0,0 +1,198 @@
+import { ToolbarButton } from '../../../components/ToolbarButton';
+import { I18nLike } from '../../../i18n';
+/**
+ * 按钮处理器接口
+ */
+export interface IButtonHandler {
+    /** 按钮 ID */
+    readonly id: string;
+    /** 初始化按钮 */
+    initialize(button: ToolbarButton): void;
+    /** 处理点击事件 */
+    handleClick(): void;
+    /** 处理鼠标进入事件（可选） */
+    handleMouseEnter?(): void;
+    /** 处理鼠标离开事件（可选） */
+    handleMouseLeave?(): void;
+    /** 销毁处理器 */
+    destroy(): void;
+}
+/**
+ * 菜单接口
+ */
+export interface IMenu {
+    /** 显示菜单 */
+    show(anchor: HTMLElement): void;
+    /** 隐藏菜单 */
+    hide(): void;
+    /** 切换菜单显示状态 */
+    toggle(anchor: HTMLElement): void;
+    /** 销毁菜单 */
+    destroy(): void;
+}
+/**
+ * 工具栏服务配置
+ */
+export interface ToolbarServiceConfig {
+    /** Cesium Viewer 实例 */
+    viewer: any;
+    /** 容器元素 */
+    container: HTMLElement;
+    /** 绘图助手实例 */
+    drawHelper?: any;
+    /** 搜索服务配置 */
+    search?: SearchServiceConfig;
+    /** 测量服务配置 */
+    measurement?: MeasurementServiceConfig;
+    /** 图层服务配置 */
+    layers?: LayersServiceConfig;
+    /** 禁飞区服务配置 */
+    noFlyZone?: NoFlyZoneServiceConfig;
+    /** 地图控制器配置 */
+    mapController?: MapControllerConfig;
+    /** 国际化配置 */
+    i18n?: I18nLike;
+    /** 是否使用国际化 */
+    useI18n?: boolean;
+    /** 回调函数 */
+    callbacks?: ToolbarCallbacks;
+}
+/**
+ * 工具栏回调函数
+ */
+export interface ToolbarCallbacks {
+    /** 搜索回调 */
+    onSearch?: (query: string) => Promise<SearchResult[]>;
+    /** 搜索选择回调 */
+    onSelect?: (result: SearchResult) => void;
+    /** 测量回调 */
+    onMeasurementStart?: () => void;
+    getDistanceDrawOptions?: () => any;
+    getAreaDrawOptions?: () => any;
+    onDistanceComplete?: (positions: any[], distance: number) => void;
+    onAreaComplete?: (positions: any[], area: number) => void;
+    onClear?: () => void;
+    /** 缩放回调 */
+    onZoomIn?: (beforeHeight: number, afterHeight: number) => void;
+    onZoomOut?: (beforeHeight: number, afterHeight: number) => void;
+    /** 全屏回调 */
+    onFullscreenChange?: (isFullscreen: boolean) => void;
+    /** 复位位置回调 */
+    onResetLocation?: () => void;
+}
+/**
+ * 搜索结果
+ */
+export interface SearchResult {
+    name: string;
+    address: string;
+    longitude: number;
+    latitude: number;
+    height?: number;
+}
+/**
+ * 搜索服务配置
+ */
+export interface SearchServiceConfig {
+    /** 搜索回调 */
+    onSearch?: (query: string) => Promise<SearchResult[]>;
+    /** 搜索选择回调 */
+    onSelect?: (result: SearchResult) => void;
+}
+export interface MeasurementCompleteEvent {
+    type: 'distance' | 'area';
+    positions: any[];
+    value: number;
+}
+export interface MeasurementServiceLike {
+    startDistanceMeasurement: (drawOptions?: any) => void;
+    startAreaMeasurement: (drawOptions?: any) => void;
+    clearMeasurements: () => void;
+    onMeasurementComplete?: (callback: (event: MeasurementCompleteEvent) => void) => void;
+    onClearComplete?: (callback: () => void) => void;
+}
+/**
+ * 测量服务配置
+ */
+export interface MeasurementServiceConfig {
+    /** 测量回调 */
+    onMeasurementStart?: () => void;
+    getDistanceDrawOptions?: () => any;
+    getAreaDrawOptions?: () => any;
+    onDistanceComplete?: (positions: any[], distance: number) => void;
+    onAreaComplete?: (positions: any[], area: number) => void;
+    onClear?: () => void;
+    service?: MeasurementServiceLike;
+}
+/**
+ * 图层服务配置
+ */
+export interface LayersServiceConfig {
+    /** 地图类型配置 */
+    mapTypes?: any[];
+    /** 当前地图类型 */
+    currentMapType?: string;
+    /** 当前是否显示路网/注记 */
+    isPlaceNameChecked?: boolean;
+    /** 天地图 token */
+    token?: string;
+    /** 地图类型改变回调 */
+    onMapTypeChange?: (mapTypeId: string) => void;
+    /** 路网显隐切换回调 */
+    onPlaceNameToggle?: (isChecked: boolean) => void;
+}
+/**
+ * 禁飞区服务配置
+ */
+export interface NoFlyZoneServiceConfig {
+    /** 挤出高度 */
+    extrudedHeight?: number;
+    /** 自动加载 */
+    autoLoad?: boolean;
+    /** 是否勾选 */
+    isChecked?: boolean;
+}
+/**
+ * 地图控制器配置
+ */
+export interface MapControllerConfig {
+    /** 初始中心点 */
+    initialCenter?: {
+        longitude: number;
+        latitude: number;
+        height: number;
+    };
+    /** 获取地图类型列表 */
+    getMapTypes?: () => any[];
+    /** 获取当前地图类型 */
+    getCurrentMapTypeId?: () => string;
+    /** 获取 token */
+    getToken?: () => string;
+    /** 缩放回调 */
+    zoomCallback?: any;
+    /** 场景模式改变回调 */
+    onSceneModeChanged?: () => void;
+    /** 全屏回调 */
+    fullscreenCallback?: (isFullscreen: boolean) => void;
+    /** 复位位置回调 */
+    resetLocationCallback?: () => void;
+}
+/**
+ * 默认按钮配置
+ */
+export interface DefaultButtonConfig {
+    id: string;
+    icon: string | HTMLElement;
+    title: string;
+    titleKey?: string;
+    sort: number;
+}
+/**
+ * 默认测量菜单项
+ */
+export interface MeasureMenuItem {
+    id: string;
+    text: string;
+    textKey?: string;
+    icon: string;
+}