antv-l7/docs/api/component/popup.en.md

---
title: popup
order: 0
---

# popup

地图标注信息窗口，用于展示地图要素的属性信息

## 构造函数

Popup

```javascript
const popup = new L7.Popup(option);
```

#### option

- closeButton
- closeOnClick
- maxWidth
- anchor

## 方法

#### setLnglat

设置 popup 的经纬度位置

**参数**：lnglat

支持数组

```javascript
[112, 32];
```

经纬度对象

```javascript
const lnglat = {
  lng: 112.323,
  lat: 30.456,
};
```

```javascript
popup.setLnglat([112, 32]);
```

#### addTo

**参数**：scene 地图 scene 实例

将 popup 添加到地图 scene 显示

```javascript
popup.addTo(scene);
```

#### setHTML

**参数**：html 字符串

设置 popup html 内容

```javascript
var html = `<p>省份
  ${feature.s} </p><p>地区
  ${feature.m}</p><p>数值
  ${feature.t}</p>`;
popup.setHTML(html);
```

#### setDOMContent

- 参数 htmlNode dom 对象
  区别于 setHtml 对象只能传字符串

**tips**

如果需要将 react 组件渲染到 popup 可以用此方法。

#### setText

设置 popup 显示文本内容

```javascript
popup.setText('hello world');
```

#### open

显示 popup

```javascript
popup.open();
```

#### close

显示 popup

```javascript
popup.close();
```

#### open

显示 popup

```javascript
popup.open();
```

#### close

显示 popup

```javascript
popup.close();
```

#### remove

移除 popup

```javascript
popup.remove();
```

## 事件

### open

```javascript
popup.on('open', () => {});
```

#### close

```javascript
popup.on('close', () => {});
```

## 示例代码

#### 添加 popup

```
  var html = '<p>'+feature.m+'</p>';
  const popup= new L7.Popup().setLnglat([112, 32]).setHTML(html);
  scene.addPopup(popup);
```

## demo 地址

[demo1](../../../examples/point/column)
[demo2](../../../examples/line/path)