Skip to content

控件 Controls ​

为地图添加缩放、指北针、定位与全屏等交互控件。

MapControls 组件提供一组可放置在地图任意角落的交互控件。

tsx
import { Map, MapControls } from "@/registry/map";

export function MapControlsExample() {
  return (
    <div className="h-[420px] w-full">
      <Map center={[2.3522, 48.8566]} zoom={10}>
        <MapControls
          position="top-right"
          showZoom
          showCompass
          showLocate
          showFullscreen
        />
      </Map>
    </div>
  );
}

属性 ​

属性类型默认值说明
position"top-left" | "top-right" | "bottom-left" | "bottom-right""bottom-right"控件在地图上的位置。
showZoombooleantrue是否显示放大/缩小按钮。
showCompassbooleanfalse是否显示用于复位方位角的指北针按钮。
showLocatebooleanfalse是否显示定位按钮以寻找用户位置。
showFullscreenbooleanfalse是否显示全屏切换按钮。
classNamestring—控件容器的附加 CSS 类。
onLocate(coords: { longitude: number; latitude: number }) => void—定位成功时的回调,返回用户坐标。

基于 mapcn 官方文档整理 · AI 辅助编撰