GeoVerse

Appearance

Documentation / @geoverse/react / GvMap

Variable: GvMap ​

ts
const GvMap: ForwardRefExoticComponent<GvMapProps & RefAttributes<GMap>>;

Defined in: react/src/components/GvMap.tsx:59

地图容器组件，包装 core 的 GMap。

  • 仅在 useEffect（浏览器侧）实例化，cleanup 调 destroy()——对称收敛 React 18+ StrictMode 的「挂载→卸载→再挂载」双调用，杜绝两张地图叠加；
  • 地图就绪后才经 ready state 渲染子组件并下发 MapContext，保证子组件 （图层/要素/交互）的 effect 跑在地图为非空时；
  • center / zoom / base 受控：独立 effect 依赖原始值，仅当与当前值不同 才下发 setter，避免与 onCenterChange/onZoomChange 回环导致视野漂移；
  • 实例经 ref（forwardRef + useImperativeHandle）暴露，另有 onReady 回调。