Skip to content

使用说明

地图中创建弹窗dom,该dom位置会随着地图移动而移动。

[去看示例]

使用示例

html
<script>
  // 1. 显示一个纯文本弹窗
  const popup = new EhhGisGl.Popup({ closeOnClick: false }).setLngLat([116.39, 39.9]).setText('这是一个简单的文本弹窗').addTo(map)

  // 2. 显示 HTML 内容的弹窗
  const popupBydom = new EhhGisGl.Popup().setLngLat([116.4, 39.91]).setHTML('<h1>Hello</h1><p>这是一个 HTML 弹窗</p>').addTo(map)
</script>

参数

Options

new EhhGisGl.Popup(options)

用于初始化 Popup 的配置对象。

参数说明类型可选值默认值
closeButton是否在弹窗右上角显示关闭按钮(×)。Booleantrue, falsetrue
closeOnClick当用户点击地图底图时,是否自动关闭该弹窗。Booleantrue, falsetrue
closeOnMove当地图视图发生移动(平移、缩放等)时,是否自动关闭该弹窗。Booleantrue, falsefalse
focusAfterOpen弹窗打开时是否自动将焦点聚焦到弹窗元素上(用于无障碍访问)。Booleantrue, falsetrue
anchor弹窗的“锚点”方向。即弹窗的尖角指向坐标的哪个方向。如果未设置,地图将根据弹窗位置自动选择最佳方向以确保弹窗完整显示。String'center'
'top', 'bottom'
'left', 'right'
'top-left', 'top-right'
'bottom-left', 'bottom-right'
自动计算
offset弹窗相对于锚点的偏移量(像素)。
可以是单个数字(所有方向统一偏移)、数组 [x, y]、或者一个对象(为不同的 anchor 指定不同的偏移)。
Number | Array | Object-null
className添加到弹窗容器上的自定义 CSS 类名。可用于覆盖默认样式。String-null
maxWidth弹窗的最大宽度。内容超过此宽度时会自动换行。StringCSS 宽度字符串
(如 '300px', 'none')
'240px'