Popup
Runnable MapLibre GL JS example: Popup. Open the live demo, read the complete source, and copy the file into your project. No build step or API key.
single HTML file · CDN dependencies onlyinterface may contain Chinese labels
Source
<!--
示例:弹窗
核心逻辑:点击地图在点击处打开 Popup,另有一个固定在北京的说明弹窗
依赖:MapLibre GL JS 4 · jsDelivr CDN · demotiles 免 Key 样式
-->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta name="robots" content="noindex,follow">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>弹窗</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/maplibre-gl@4/dist/maplibre-gl.css">
<style>
html,body{height:100%;margin:0}
body{display:flex;flex-direction:column;overflow:hidden;
font:13px/1.6 -apple-system,"Segoe UI","PingFang SC",sans-serif;color:#16181d}
.bar{flex:0 0 auto;display:flex;gap:10px;align-items:center;padding:8px 12px;
background:#f6f7f9;border-bottom:1px solid #e3e6ea;font-size:12px;color:#58606e;flex-wrap:wrap}
.bar button{font:inherit;font-size:12px;padding:4px 10px;border-radius:4px;cursor:pointer;
border:1px solid #ccd1d9;background:#fff;color:#16181d}
.bar button:hover{background:#eef0f3}
.bar b{color:#16181d;font-weight:600}
.pop{font-size:12px;line-height:1.7}
.pop b{display:block;margin-bottom:2px}
#map{flex:1 1 auto;min-height:0}
</style>
</head>
<body>
<div class="bar">
<button id="beijing">打开北京弹窗</button>
<button id="close">关闭弹窗</button>
<span>点击地图任意位置查看坐标</span>
</div>
<div id="map"></div>
<script src="https://cdn.jsdelivr.net/npm/maplibre-gl@4/dist/maplibre-gl.js"></script>
<script>
(function () {
'use strict';
if (typeof maplibregl === 'undefined') {
document.body.innerHTML =
'<div style="padding:24px;color:#b42318">MapLibre 加载失败,请检查能否访问 cdn.jsdelivr.net</div>';
return;
}
var map = new maplibregl.Map({
container: 'map',
style: 'https://demotiles.maplibre.org/style.json',
center: [110, 34],
zoom: 3,
attributionControl: {
compact: true,
customAttribution: 'MapLibre demo tiles'
}
});
var popup = new maplibregl.Popup({
closeButton: true,
closeOnClick: false,
offset: 14,
maxWidth: '260px',
className: 'pop'
});
map.on('click', function (e) {
var c = e.lngLat;
popup
.setLngLat(c)
.setHTML(
'<b>点击位置</b><br>' +
'经度 ' + c.lng.toFixed(5) + '<br>' +
'纬度 ' + c.lat.toFixed(5) + '<br>' +
'缩放 ' + map.getZoom().toFixed(2)
)
.addTo(map);
});
document.getElementById('beijing').addEventListener('click', function () {
popup
.setLngLat([116.391263, 39.907359])
.setHTML('<b>北京</b>MapLibre demo 样式只提供国界数据,<br>城市级别的细节需要完整底图。')
.addTo(map);
map.easeTo({ center: [116.391263, 39.907359], zoom: 4, duration: 800 });
});
document.getElementById('close').addEventListener('click', function () {
popup.remove();
});
map.addControl(new maplibregl.NavigationControl(), 'top-right');
})();
</script>
</body>
</html>
Language: the code and this page are in English; the full tutorial and API notes for this example are in Chinese. The demo itself is the authoritative version — it runs exactly as shown.