開始使用
有很多種方式可以開始使用 Lit,從我們的遊樂場和互動式教學到安裝到現有專案中。
Lit 遊樂場
“Lit 遊樂場” 的永久連結立即使用互動式遊樂場和範例開始。從「Hello World」開始,然後自訂它或繼續瀏覽更多範例。
互動式教學
“互動式教學” 的永久連結參加我們的逐步教學,學習如何在幾分鐘內建置一個 Lit 元件。
Lit 入門套件
“Lit 入門套件” 的永久連結我們提供 TypeScript 和 JavaScript 元件入門套件,用於建立獨立可重複使用的元件。請參閱入門套件。
從 npm 本機安裝
“從 npm 本機安裝” 的永久連結Lit 可透過 npm 作為 lit
套件提供。
npm i lit
然後匯入到 JavaScript 或 TypeScript 檔案中
import {LitElement, html} from 'lit';
import {customElement, property} from 'lit/decorators.js';
import {LitElement, html} from 'lit';
使用捆綁包
“使用捆綁包” 的永久連結Lit 也可作為預先建置的單一檔案捆綁包提供。提供這些是為了讓開發工作流程更具彈性:例如,如果您偏好下載單一檔案而不是使用 npm 和建置工具。捆綁包是沒有依賴關係的標準 JavaScript 模組 - 任何現代瀏覽器都應該能夠從 <script type="module">
內匯入和執行捆綁包,如下所示
import {LitElement, html} from 'https://cdn.jsdelivr.net/gh/lit/dist@3/core/lit-core.min.js';
如果您使用 npm 進行客戶端依賴,您應該使用lit
套件,而不是這些捆綁包。 這些捆綁包刻意將 Lit 的大部分或全部內容組合到單一檔案中,這可能會導致您的頁面下載超過所需的程式碼。
若要瀏覽捆綁包,請前往 https://cdn.jsdelivr.net/gh/lit/dist/,並使用下拉式選單前往特定版本的頁面。在該頁面上,將會有一個目錄,其中包含該版本可用的每種類型的捆綁包。有兩種類型的捆綁包
- 核心
- https://cdn.jsdelivr.net/gh/lit/dist@3/core/lit-core.min.js
core
匯出與lit
套件的主要模組相同的項目。 - 全部
- https://cdn.jsdelivr.net/gh/lit/dist@3/all/lit-all.min.js
all
匯出core
中的所有內容,外加lit
中的大多數其他模組。
請注意,lit/static-html.js
中的html
和svg
匯出會分別別名為staticHtml
和staticSvg
,以避免衝突。
將 Lit 加入現有專案
“將 Lit 加入現有專案” 的永久連結請參閱將 Lit 加入現有專案,以取得將 Lit 加入現有專案或應用程式的指示。
開啟 WC 專案產生器
“開啟 WC 專案產生器” 的永久連結Open WC 專案有一個專案產生器,可以腳手架出使用 Lit 的應用程式專案。