xt-element-ui 1.2.8 → 1.3.1

package/src/components/xt-map/adapters/base.js

@@ -0,0 +1,267 @@
+/**
+ * 地图适配器基类
+ * 定义统一的 API 接口，各地图引擎（高德/天地图/百度）通过继承/实现该接口完成适配
+ *
+ * 统一坐标系统：WGS84 (lng, lat) 作为输入输出标准，各适配器内部处理转换
+ * 统一地图类型：standard | satellite | hybrid | traffic
+ * 统一主题：light | dark
+ */
+
+import { loadScript, hasGlobal } from '../loaders/script-loader'
+
+// 地图类型 -> 内部常量（各适配器可覆盖转换）
+const DEFAULT_MAP_TYPE_MAP = {
+  standard: 'standard',
+  satellite: 'satellite',
+  hybrid: 'hybrid',
+  traffic: 'traffic'
+}
+
+export class MapAdapterBase {
+  constructor(container, options = {}) {
+    this.container = container
+    this.options = options
+    this.mapInstance = null
+    this.mapType = options.mapType || 'standard'
+    this.theme = options.theme || 'light'
+    this.center = options.center || [116.397428, 39.90923]
+    this.zoom = options.zoom || 11
+    this.apiKey = options.apiKey || ''
+    this.apiUrl = options.apiUrl || null
+    this.plugins = options.plugins || []
+    this.eventHandlers = new Map()
+    this.ready = false
+    this._mapTypeMap = { ...DEFAULT_MAP_TYPE_MAP }
+  }
+
+  /**
+   * 获取 SDK 脚本 URL（各适配器必须实现）
+   * @returns {string}
+   */
+  getScriptUrl() {
+    throw new Error('[XtMap] 子类必须实现 getScriptUrl()')
+  }
+
+  /**
+   * 检查 SDK 是否已加载
+   */
+  isSdkLoaded() {
+    throw new Error('[XtMap] 子类必须实现 isSdkLoaded()')
+  }
+
+  /**
+   * 在脚本加载前执行（可选覆盖）
+   * 用于设置 securityJsCode、注册全局 callback 等前置准备
+   */
+  beforeLoadScript() {
+    // 可选实现 - 各适配器可覆盖
+  }
+
+  /**
+   * 创建地图实例（各适配器必须实现）
+   */
+  async createMap() {
+    throw new Error('[XtMap] 子类必须实现 createMap()')
+  }
+
+  /**
+   * 加载 SDK 并初始化地图
+   */
+  async init() {
+    if (!this.container) {
+      throw new Error('[XtMap] 缺少容器元素')
+    }
+
+    if (!this.isSdkLoaded()) {
+      // 1. 脚本加载前执行钩子（设置安全密钥等）
+      this.beforeLoadScript()
+
+      // 2. 获取脚本 URL
+      const url = this.getScriptUrl()
+      if (!url) {
+        throw new Error('[XtMap] 缺少 API URL，请配置 apiKey 或 apiUrl')
+      }
+
+      // 3. 动态加载脚本
+      await loadScript(url)
+
+      // 4. 等待 SDK 初始化全局对象（部分 SDK 需要等待 callback 或脚本内部初始化完成）
+      await this._waitForSdkReady()
+    }
+
+    // 5. 创建地图实例
+    await this.createMap()
+    this.ready = true
+    return this.mapInstance
+  }
+
+  /**
+   * 等待 SDK 准备好（部分地图 SDK 需要等待 callback 执行）
+   */
+  async _waitForSdkReady() {
+    return new Promise((resolve) => {
+      let attempts = 0
+      const maxAttempts = 100
+      const check = () => {
+        if (this.isSdkLoaded() || attempts >= maxAttempts) {
+          resolve()
+        } else {
+          attempts++
+          setTimeout(check, 100)
+        }
+      }
+      check()
+    })
+  }
+
+  /**
+   * 统一地图类型转换：xt-map 枚举 -> 引擎内部值
+   */
+  getNativeMapType(xtType) {
+    return this._mapTypeMap[xtType] || this._mapTypeMap.standard
+  }
+
+  /**
+   * 设置地图类型
+   */
+  setMapType(type) {
+    this.mapType = type
+    if (this.ready && this.mapInstance) {
+      this._applyMapType(type)
+    }
+  }
+
+  /**
+   * 应用地图类型到引擎（各适配器实现）
+   */
+  _applyMapType(type) {
+    // 可选实现
+  }
+
+  /**
+   * 设置主题
+   */
+  setTheme(theme) {
+    this.theme = theme
+    if (this.ready && this.mapInstance) {
+      this._applyTheme(theme)
+    }
+  }
+
+  /**
+   * 应用主题到引擎（各适配器实现）
+   */
+  _applyTheme(theme) {
+    // 可选实现
+  }
+
+  /**
+   * 设置中心坐标 [lng, lat]
+   */
+  setCenter(center) {
+    this.center = center
+    if (this.ready && this.mapInstance) {
+      this._applyCenter(center)
+    }
+  }
+
+  _applyCenter(center) {
+    // 各适配器实现
+  }
+
+  /**
+   * 设置缩放级别
+   */
+  setZoom(zoom) {
+    this.zoom = zoom
+    if (this.ready && this.mapInstance) {
+      this._applyZoom(zoom)
+    }
+  }
+
+  _applyZoom(zoom) {
+    // 各适配器实现
+  }
+
+  /**
+   * 获取当前中心坐标
+   */
+  getCenter() {
+    return this.center
+  }
+
+  /**
+   * 获取当前缩放级别
+   */
+  getZoom() {
+    return this.zoom
+  }
+
+  /**
+   * 获取原始地图实例（用于高级自定义操作）
+   */
+  getNativeMap() {
+    return this.mapInstance
+  }
+
+  /**
+   * 绑定事件（统一事件名：click, moveend, zoomend, ready 等）
+   */
+  on(eventName, handler) {
+    if (typeof handler !== 'function') return
+    this.eventHandlers.set(eventName, handler)
+    if (this.ready && this.mapInstance) {
+      this._bindEvent(eventName, handler)
+    }
+  }
+
+  _bindEvent(eventName, handler) {
+    // 各适配器实现具体事件绑定
+  }
+
+  /**
+   * 解绑事件
+   */
+  off(eventName) {
+    const handler = this.eventHandlers.get(eventName)
+    if (handler && this.ready && this.mapInstance) {
+      this._unbindEvent(eventName, handler)
+    }
+    this.eventHandlers.delete(eventName)
+  }
+
+  _unbindEvent(eventName, handler) {
+    // 各适配器实现
+  }
+
+  /**
+   * 调整地图大小（容器尺寸变化后调用）
+   */
+  resize() {
+    if (this.ready && this.mapInstance) {
+      this._applyResize()
+    }
+  }
+
+  _applyResize() {
+    // 各适配器实现
+  }
+
+  /**
+   * 销毁地图
+   */
+  destroy() {
+    this.eventHandlers.clear()
+    if (this.mapInstance && typeof this.mapInstance.destroy === 'function') {
+      try {
+        this.mapInstance.destroy()
+      } catch (e) {
+        // 忽略销毁错误
+      }
+    }
+    this.mapInstance = null
+    this.ready = false
+  }
+}
+
+export default MapAdapterBase

package/src/components/xt-map/adapters/index.js

@@ -0,0 +1,29 @@
+/**
+ * 地图适配器索引
+ * 根据 provider 字符串返回对应的适配器构造函数
+ */
+
+import { AMapAdapter } from './amap'
+import { TiandituAdapter } from './tianditu'
+import { BaiduAdapter } from './baidu'
+
+export const adapters = {
+  amap: AMapAdapter,
+  tianditu: TiandituAdapter,
+  baidu: BaiduAdapter
+}
+
+export const getAdapterClass = (provider) => {
+  return adapters[provider] || AMapAdapter
+}
+
+export { AMapAdapter, TiandituAdapter, BaiduAdapter }
+export { MapAdapterBase } from './base'
+
+export default {
+  adapters,
+  getAdapterClass,
+  AMapAdapter,
+  TiandituAdapter,
+  BaiduAdapter
+}

package/src/components/xt-map/adapters/tianditu.js

@@ -0,0 +1,242 @@
+/**
+ * 天地图适配器 (Tianditu)
+ * 天地图使用 WMTS 切片服务，不支持原生主题切换，
+ * dark/light 通过图层样式参数模拟（部分图层可调整色调）
+ */
+
+import { MapAdapterBase } from './base'
+import { hasGlobal } from '../loaders/script-loader'
+
+// 天地图地图类型映射
+const TIANDITU_MAP_TYPES = {
+  standard: 'vec',           // 矢量地图
+  satellite: 'img',          // 影像地图
+  hybrid: 'img',             // 混合（影像 + 注记）
+  traffic: 'vec'             // 天地图不支持原生路况，降级为矢量
+}
+
+// 天地图主题色模拟：通过调整图层透明度/色调CSS滤镜
+const TIANDITU_THEME_FILTER = {
+  light: 'none',
+  dark: 'invert(1) hue-rotate(180deg) saturate(1.2) brightness(0.95)'
+}
+
+export class TiandituAdapter extends MapAdapterBase {
+  constructor(container, options = {}) {
+    super(container, options)
+    this._mapTypeMap = { ...TIANDITU_MAP_TYPES }
+    this._layerType = options.tiandituLayerType || 'vec'
+    this._currentLayer = null
+    this._annotationLayer = null
+  }
+
+  getScriptUrl() {
+    if (this.apiUrl) return this.apiUrl
+    if (!this.apiKey) {
+      console.warn('[XtMap] 天地图需要配置 apiKey (tk)')
+      return ''
+    }
+    return `https://api.tianditu.gov.cn/api?v=4.0&tk=${encodeURIComponent(this.apiKey)}`
+  }
+
+  isSdkLoaded() {
+    return hasGlobal('T') && typeof window.T === 'object' && window.T.Map
+  }
+
+  async createMap() {
+    const T = window.T
+    if (!T || !T.Map) throw new Error('[XtMap] 天地图 SDK 未加载')
+
+    const mapOptions = {
+      center: new T.LngLat(this.center[0], this.center[1]),
+      zoom: this.zoom
+    }
+
+    this.mapInstance = new T.Map(this.container, mapOptions)
+
+    // 应用地图类型
+    this._applyMapType(this.mapType)
+
+    // 应用主题
+    this._applyTheme(this.theme)
+
+    // 等待地图就绪
+    await new Promise((resolve) => {
+      setTimeout(resolve, 500)
+    })
+
+    // 绑定事件
+    for (const [eventName, handler] of this.eventHandlers.entries()) {
+      this._bindEvent(eventName, handler)
+    }
+  }
+
+  _applyMapType(type) {
+    if (!this.mapInstance) return
+    const T = window.T
+    if (!T) return
+
+    try {
+      // 天地图通过 switchTo 方法切换图层
+      const layerType = this._mapTypeMap[type] || 'vec'
+
+      if (type === 'standard') {
+        // 矢量地图
+        this.mapInstance.setMapType(window.TMAP_NORMAL_MAP || 1)
+      } else if (type === 'satellite') {
+        // 影像地图
+        this.mapInstance.setMapType(window.TMAP_SATELLITE_MAP || 2)
+      } else if (type === 'hybrid') {
+        // 混合（影像+注记）
+        this.mapInstance.setMapType(window.TMAP_HYBRID_MAP || 3)
+      } else {
+        // 路况等特殊类型，天地图无原生支持
+        this.mapInstance.setMapType(window.TMAP_NORMAL_MAP || 1)
+      }
+    } catch (e) {
+      console.warn('[XtMap] 天地图切换地图类型失败:', e)
+    }
+  }
+
+  _applyTheme(theme) {
+    if (!this.container) return
+    // 天地图不支持原生 dark 主题，通过 CSS 滤镜模拟
+    const filter = TIANDITU_THEME_FILTER[theme] || 'none'
+    const imgElements = this.container.querySelectorAll('img')
+    imgElements.forEach((img) => {
+      img.style.filter = filter
+      img.style.webkitFilter = filter
+    })
+    // 同时设置容器级 CSS 变量，方便样式覆盖
+    this.container.setAttribute('data-map-theme', theme)
+    // 监听后续新增的 tile 图片（通过 MutationObserver）
+    this._setupThemeObserver(theme)
+  }
+
+  _setupThemeObserver(theme) {
+    if (this._themeObserver) {
+      this._themeObserver.disconnect()
+    }
+    if (theme !== 'dark') return
+    const filter = TIANDITU_THEME_FILTER[theme]
+    this._themeObserver = new MutationObserver((mutations) => {
+      mutations.forEach((mutation) => {
+        mutation.addedNodes.forEach((node) => {
+          if (node.nodeType === 1) {
+            if (node.tagName === 'IMG') {
+              node.style.filter = filter
+              node.style.webkitFilter = filter
+            } else if (node.querySelectorAll) {
+              const imgs = node.querySelectorAll('img')
+              imgs.forEach((img) => {
+                img.style.filter = filter
+                img.style.webkitFilter = filter
+              })
+            }
+          }
+        })
+      })
+    })
+    try {
+      this._themeObserver.observe(this.container, {
+        childList: true,
+        subtree: true
+      })
+    } catch (e) {
+      // 忽略
+    }
+  }
+
+  _applyCenter(center) {
+    if (!this.mapInstance || !window.T) return
+    try {
+      this.mapInstance.centerAndZoom(new window.T.LngLat(center[0], center[1]), this.zoom)
+    } catch (e) {
+      // 忽略
+    }
+  }
+
+  _applyZoom(zoom) {
+    if (!this.mapInstance) return
+    try {
+      this.mapInstance.setZoom(zoom)
+    } catch (e) {
+      // 忽略
+    }
+  }
+
+  getCenter() {
+    if (this.mapInstance && this.mapInstance.getCenter) {
+      const c = this.mapInstance.getCenter()
+      if (c && c.getLng !== undefined) {
+        return [c.getLng(), c.getLat()]
+      }
+    }
+    return this.center
+  }
+
+  getZoom() {
+    if (this.mapInstance && this.mapInstance.getZoom) {
+      return this.mapInstance.getZoom()
+    }
+    return this.zoom
+  }
+
+  _bindEvent(eventName, handler) {
+    if (!this.mapInstance) return
+    try {
+      const eventMap = {
+        click: 'click',
+        moveend: 'moveend',
+        zoomend: 'zoomend',
+        zoomchange: 'zoomend'
+      }
+      const nativeEvent = eventMap[eventName] || eventName
+      this.mapInstance.addEventListener(nativeEvent, (e) => {
+        const normalized = {
+          originalEvent: e,
+          lnglat: e && e.lnglat ? [e.lnglat.getLng(), e.lnglat.getLat()] : null
+        }
+        handler(normalized)
+      })
+    } catch (err) {
+      console.warn('[XtMap] 天地图事件绑定失败:', eventName, err)
+    }
+  }
+
+  _unbindEvent(eventName, handler) {
+    if (!this.mapInstance) return
+    try {
+      this.mapInstance.removeEventListener(eventName, handler)
+    } catch (e) {
+      // 忽略
+    }
+  }
+
+  _applyResize() {
+    if (this.mapInstance && this.mapInstance.checkResize) {
+      try {
+        this.mapInstance.checkResize()
+      } catch (e) {
+        // 忽略
+      }
+    }
+  }
+
+  destroy() {
+    if (this._themeObserver) {
+      this._themeObserver.disconnect()
+      this._themeObserver = null
+    }
+    if (this.mapInstance && typeof this.mapInstance.clearOverLays === 'function') {
+      try {
+        this.mapInstance.clearOverLays()
+      } catch (e) {
+        // 忽略
+      }
+    }
+    super.destroy()
+  }
+}
+
+export default TiandituAdapter