Leaflet 1.0-rc1 發佈
Leaflet 1.0 的開發持續進行中 - 我們很榮幸能將 1.0 的第一個候選版本發布到公眾。
Leaflet 1.0-rc1 修正了 beta2 中存在的邊緣情況和 API 不一致的問題。完整的變更列表如常在 1.0.0-rc1 更新日誌中,包含約 50 個錯誤修正和十幾個改進及較小的 API 變更。
主要變更
-
小數縮放控制:在 beta2 中,開發人員只能透過程式碼設定小數縮放級別,例如執行
map.setZoom(8.5)
。現在地圖具有選項(zoomSnap
和zoomDelta
)讓使用者可以瀏覽小數縮放級別。 -
當圖層為非互動式且線條為虛線時,在使用
<canvas>
渲染器時,更好地處理向量圖層。 -
有史以來第一個 Microsoft Edge 的 hack(處理 Win10 觸控螢幕上不一致的
dblclick
行為) -
使用
prosthetic-hand
進行單元測試,讓我們確定觸控互動行為一致。這有它自己的部落格文章。
API 文件中的變更
API 文件現在是從文件字串產生的,這要歸功於一個名為 🍂doc (或 “leafdoc”) 的新工具。
先前,API 文件是手動編輯的。這涉及大量的複製貼上,而且隨著時間的推移,部分程式碼開始與文件不符。
大多數複雜的軟體專案都使用某種形式的 文件字串 和諸如 JavaDoc、NaturalDocs 或 JSdoc 之類的工具,將文件字串轉換為網頁。
但是 Leaflet 的文件需要一些特殊的部分 - 文件字串涵蓋了方法和屬性,但不涵蓋選項或事件,而且我們希望保持文件目前的樣貌。🍂doc 因此誕生,以克服這些限制。
Leaflet 廣泛使用類別繼承,而舊文件有時對此不夠清楚。有些使用者難以找到某些類別的可用方法,而繼承的選項有時會提到,有時則不會。🍂doc 通過包含所有繼承方法/選項/事件/屬性的文件來修正此問題,預設為摺疊。
建置系統現在會建置一個包含 API 文件和最小化 leaflet.js
檔案的 HTML 檔案。文件將在每次發布時根據該檔案進行更新,並且修復文件的 gh-pages
分支的拉取請求將會自動被拒絕。
取得候選版本
與先前的版本一樣,您可以使用我們的 CDN
<link rel="stylesheet" href="http://cdn.leafletjs.com/leaflet/v1.0.0-rc.1/leaflet.css" />
<script src="http://cdn.leafletjs.com/leaflet/v1.0.0-rc.1/leaflet.js"></script>
未最小化的 JavaScript 檔案版本也可作為
<script src="http://cdn.leafletjs.com/leaflet/v1.0.0-rc.1/leaflet-src.js"></script>
此版本也可透過 NPM (npm install leaflet@rc
)、GitHub 下載 和 CDN 下載取得。我們不建議使用 Bower。
團隊成員親自見面
當 Leaflet 團隊的大部分成員在馬德里會面,一起修復錯誤並討論架構決策,以及某些大型功能是否應該納入 1.0 或延後時,這個候選版本向前邁進了一大步。
![]() |
![]() |
我們很高興能親自見面並一起解決錯誤。事實證明,這是一件非常有成效的事情,因為那天關閉了大約 20 個問題。希望另一次親自會議能盡快發生,並帶來另一個版本!
我們希望您和我們編碼它時一樣喜歡 Leaflet 1.0-rc1!
祝好,Iván & Vladimir & Yohan & Per & Zsolt.