# # 气泡

> mapgis-3d-popup

## # 属性

名称 | 类型 | 默认值 | 描述 | 是否监听
--- | --- | --- | --- | ---
vueKey | String | default | mapgis-web-scene 组件的 ID，当使用多个 mapgis-web-scene 组件时，需要指定该值，来唯一标识 mapgis-web-scene 组件， 同时 mapgis-web-scene 插槽中的组件也需要传入相同的 vueKey，让组件知道应该作用于哪一个 mapgis-web-scene。 | 否
vueIndex | Number | (Math.random() * 1000000).toFixed(0) | 当 mapgis-web-scene 插槽中使用了多个相同组件时，例如多个 mapgis-3d-igs-doc-layer 组件，用来区分组件的标识符。 | 否
position 必传 | Object | { entity: Cesium.Entity, cartesian: Cesium.Cartesian3, longitude: 110, latitude: 30, height: 0 } | 显示位置，3 种不同的传参使用方式: 1. Cesium.Entity 绑定到 Cesium.Entity 上鼠标点击/移入弹出，鼠标移出消失 2.Cesium.Cartesian3 绑定到 Cesium.Cartesian3 笛卡尔坐标上 3.Cesium.long lat height 绑定到经纬度和高度上 | 是
options | Object | { postRender: true, // 实时渲染 popupId: 'xxx-xx', // 本次 popup 对应的唯一 id,不传随机生成 popupContentId: 'xxx-xx', // 本次 popup 对应的唯一内容 id showClose: true, // 是否显示关闭按钮 } | 额外参数 | 否
container | String | `<div>空</div>` | 外部传入的 div 的字符串描述方式，一般是文字或者 echarts 的 div; | 否
visible | Boolean | true | 是否显示 | 是
destroyOnClose | Boolean | false | 关闭 popup 的时候销毁 Dom 元素 | 否
forceRender | Boolean | false | 强制渲染 poup 显示的 Dom 元素。该参数的使用场景是外部动态改变 slot 的前提下需要 Popup 更新内部的 UI，一旦该参数设置为 true，任何触发 vue-updated 生命周期的函数都会强制刷新该参数 | 否
popupWapperStyle | Object |  | popup 的 wapper 层样式，添加的样式主要体现在 popup 主体框，全局 CSS 处设置了默认样式，传入的样式优先级更高 | 是
popupHeaderStyle | Object |  | popup 的标题栏样式，添加后样式体现在标题处，全局 CSS 处设置了字体等基基础样式，传入样式优先级更高 | 是
popupCloseBtnStyle | Object |  | popup 头部关闭按钮样式，添加的样式主要体现在关闭按钮处，全局 CSS 处设置了样式，传入样式优先级更高 | 是

## # 槽

### # `default`

- 描述 Popup 的自定义槽的实现，可以自定义各类视图

## # 事件

### # `@load`

- 描述 在 Popup 加载完毕后发送该事件
- Payload `{ popup }`
- `popup` Popup 对象