Leaflet

一個開源的 JavaScript 函式庫
用於行動裝置友善的互動式地圖

← 返回部落格文章列表

Leaflet 1.0-rc1 發佈

Leaflet 1.0 的開發持續進行中 - 我們很榮幸能將 1.0 的第一個候選版本發布到公眾。

Leaflet 1.0-rc1 修正了 beta2 中存在的邊緣情況和 API 不一致的問題。完整的變更列表如常在 1.0.0-rc1 更新日誌中,包含約 50 個錯誤修正和十幾個改進及較小的 API 變更。

主要變更

API 文件中的變更

API 文件現在是從文件字串產生的,這要歸功於一個名為 🍂doc (或 “leafdoc”) 的新工具。

先前,API 文件是手動編輯的。這涉及大量的複製貼上,而且隨著時間的推移,部分程式碼開始與文件不符。

大多數複雜的軟體專案都使用某種形式的 文件字串 和諸如 JavaDocNaturalDocsJSdoc 之類的工具,將文件字串轉換為網頁。

但是 Leaflet 的文件需要一些特殊的部分 - 文件字串涵蓋了方法和屬性,但不涵蓋選項或事件,而且我們希望保持文件目前的樣貌。🍂doc 因此誕生,以克服這些限制。

Leaflet 廣泛使用類別繼承,而舊文件有時對此不夠清楚。有些使用者難以找到某些類別的可用方法,而繼承的選項有時會提到,有時則不會。🍂doc 通過包含所有繼承方法/選項/事件/屬性的文件來修正此問題,預設為摺疊。

Collapsed inheritances for L.Polygon

建置系統現在會建置一個包含 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 或延後時,這個候選版本向前邁進了一大步。

這張照片可能經過數位修改,納入一位無法參加那個週末在馬德里會議的人。
The Leaflet team in Madrid
Iván 和 Yohan 特別感謝那捲衛生紙。
The Leaflet team in Madrid

我們很高興能親自見面並一起解決錯誤。事實證明,這是一件非常有成效的事情,因為那天關閉了大約 20 個問題。希望另一次親自會議能盡快發生,並帶來另一個版本!

我們希望您和我們編碼它時一樣喜歡 Leaflet 1.0-rc1!

祝好,Iván & Vladimir & Yohan & Per & Zsolt.