Leaflet 是一個現代化、開源的 JavaScript 地圖庫,專為構建交互性好、適配移動設備的在線地圖而設計。核心 JS 僅約 33KB,卻涵蓋了大多數地圖應用所需的能力。
它的設計哲學是簡潔、高性能、易用:在主流桌面與移動平台都能高效運行,現代瀏覽器上會充分利用 HTML5 與 CSS3 的優勢,同時兼顧舊瀏覽器。它支持插件擴展,擁有友好易用的 API 文檔與可讀性極高的源碼。目前社區插件已超過 140 個,覆蓋地圖服務、數據提供、數據格式、地理編碼、路徑規劃與檢索、控件與交互等各個方向。
2016 年 9 月 27 日,Leaflet 1.0 正式發布,更快、更穩定,也更嚴謹。

第一步,在 head 中引入 CSS:
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.0.1/dist/leaflet.css" />
第二步,引入 JS:
<script src="https://unpkg.com/leaflet@1.0.1/dist/leaflet.js"></script>
第三步,放一個帶 id 的容器作為地圖掛載點:
<div id="mapid"></div>
第四步,必須給容器指定高度,否則地圖不可見:
#mapid { height: 180px; }
Leaflet 不會替你設置高度(div 默認高度為 0),這是新手最常踩的坑。

var mymap = L.map('mapid').setView([39.9788, 116.30226], 14);
這行代碼把地圖中心定位到北京某處,縮放級別設為 14(傳入的 mapid 必須與容器 id 一致)。默認情況下,鼠標與觸摸交互全部開啟,並自帶放大縮小控件與歸屬信息控件。
注意 setView 返回的是地圖對象本身——Leaflet 大多數方法都支持這種鏈式調用,風格類似 jQuery。
接著加一層瓦片。以 Mapbox 街道圖為例:
L.tileLayer('https://api.tiles.mapbox.com/v4/{id}/{z}/{x}/{y}.png?access_token={accessToken}', {
attribution: 'Map data © <a href="https://openstreetmap.org">OpenStreetMap</a> contributors, <a href="https://creativecommons.org/licenses/by-sa/2.0/">CC-BY-SA</a>, Imagery © <a href="https://mapbox.com">Mapbox</a>',
maxZoom: 18,
id: 'your.mapbox.project.id',
accessToken: 'your.mapbox.public.access.token'
}).addTo(mymap);
創建瓦片層的三要素:瓦片 URL 模板({z}/{x}/{y} 會被自動替換)、歸屬文本、最大縮放級別。至此,一張可用的地圖就完成了。

// 標記 + 彈窗
L.marker([39.9788, 116.30226]).addTo(mymap)
.bindPopup("北京大廈<br>").openPopup();
// 圓:第二個參數是半徑(米),最後一個參數控制外觀
L.circle([39.9908, 116.26625], 500, {
color: 'red', fillColor: '#f03', fillOpacity: 0.5
}).addTo(mymap).bindPopup("頤和園歡迎你");
// 多邊形
L.polygon([
[39.92096, 116.38591],
[39.91079, 116.38676],
[39.91118, 116.3962],
[39.92014, 116.39482]
]).addTo(mymap).bindPopup("故宮");
彈窗的兩種用法:bindPopup 綁定後默認點擊才彈出,openPopup 則立即顯示。
marker.bindPopup("北京大廈").openPopup();
circle.bindPopup("頤和園");
polygon.bindPopup("故宮");
如果需要更靈活的控制,可以單獨創建彈窗層:
var popup = L.popup()
.setLatLng([51.5, -0.09])
.setContent("I am a standalone popup.")
.openOn(mymap);
這裡用 openOn 而非 addTo,因為它會自動關閉之前打開的彈窗,避免同時彈出多個。
地圖上每次交互——點擊標記、縮放變化——對應對象都會派發事件,訂閱即可:
function onMapClick(e) {
alert("You clicked the map at " + e.latlng);
}
mymap.on('click', onMapClick);
監聽函數的第一個參數是事件對象,裡面攜帶着有用信息。比如地圖點擊事件的 e.latlng 就是點擊位置的經緯度。改成彈窗展示會更友好:
var popup = L.popup();
function onMapClick(e) {
popup
.setLatLng(e.latlng)
.setContent("You clicked the map at " + e.latlng.toString())
.openOn(mymap);
}
mymap.on('click', onMapClick);
接下來可以嘗試的事情還有很多:用 L.control.layers 加圖層切換、用 L.divIcon 自定義標記樣式、用 L.geoJSON 加載行政邊界數據,或者引入 Leaflet.markercluster 做海量點聚合。中文場景下還需注意瓦片源選擇與 GCJ-02 坐標偏移問題——高德、騰訊的瓦片使用國測局坐標,直接疊加 GPS 原始坐標會有幾百米偏移,需要引入 coordtransform 之類的庫做轉換。
以上就是這次 Leaflet 入門教程的分享,希望對大家有所幫助。有疑問歡迎留言,我會及時回復。