zephjs

澤夫JS

ZephJS 是一個簡單、易於理解且超輕量的框架，用於定義和使用 Web 元件。它非常適合編寫元件庫的人員、建立只需要一些自訂元件的應用程式或網站的團隊，或建立不需要現代 JavaScript 瀏覽器框架的全部重量的整個應用程式的專案。 ZephJS 簡化了將自訂 Web 元件定義為聲明性、高度可讀的結構的過程，該結構使用標準 JavaScript、標準 HTML 標記和標準 CSS 樣式。

ZephJS 旨在將 Web 元件所承諾的易用性帶回社群。為此，它遵循以下原則：

• 以可讀的、聲明性的方式簡單地定義新元件。
• 使元件或元件庫更容易被其他人使用。
• 使用使網路變得偉大的標準和技術。
• 永遠不要試圖智勝瀏覽器。
• 保持其小而輕。

ZephJS 通常簡稱為“Zeph”，發音為“Zef”。

特徵

ZephJS 具有以下特點...

• 輕鬆定義Web元件；
• 極其可讀的聲明性語法；
• 使用 100% 標準瀏覽器 API；
• 使用 100% 標準 JavaScript/ES2018；
• 使用 100% 標準 HTML，內嵌或分離；
• 使用 100% 標準 CSS，內聯或分離；
• 封裝樣式和內容不外洩；
• 組件可以擴展其他組件；
• 透過屬性/屬性/內容綁定進行值傳播；
• 支援建構一次性組件；
• 或支援建置組件庫；
• 或 支援建立整個應用程式；
• 包含 CLI，可輕鬆搭建新組件；
• 包含 Bundler（使用 Rollup）打包成單一可分發檔案；
• ZephJS 壓縮後不到 20k！

開始使用

ZephJS 有四種不同的用例，一開始就可以解決：

• 使用建構在 ZephJS 之上的 Web 元件庫；
• 在 ZephJS 之上建立 Web 元件庫；
• 使用 ZephjS建立具有自訂元件的網站；
• 使用 ZephJS建立 Web 應用程式。

選擇最適合您的入門方式並立即開始使用 ZephJS！

附加資訊

文獻網

ZephJS 提供了大量文件來幫助您使用它...

入門

• ZephJS 簡介
• 組件快速入門指南
• 常見問題解答

成分

• 組件快速入門指南
• 組件概念
• 建立新組件
• 導入 ZephJS
• 定義組件
• 遺產
• 超文本標記語言
• CSS
• 資源
• 屬性
• 特性
• 生命週期處理程序
• 綁定
• 事件處理程序

服務

• 服務

蜜蜂

• API文件

捆綁

• 捆綁分發

命令列工具

• 命令列工具

命令列參考

ZephJS 附帶了一個小型命令列工具 (CLI)，可以幫助滿足您與 ZephJS 相關的需求。當您透過 npm 安裝 ZephJS 時，它會在本機安裝，並且可以使用 shell 命令zeph進行存取。它具有以下語法：

zeph < command >

您可以執行許多命令。很快：

• hello ：產生範例 hello world 應用程式。
• create ：建立一個新元件，包括 .js、.html 和 .css 存根檔案。
• serve ：在 http://localhost:4000 上執行一個小型 Web 伺服器，為目前目錄提供服務。
• bundle ：將多個 ZephJS 元件捆綁到一個檔案中。

有關更多信息，請參閱有關 Zeph 命令列介面的文件。

範例

ZephJS 附帶了一組範例供您參考。

• QuickStartExample：快速入門指南中的範例。

• BasicComponent：基本元件的範例。

• HelloBadge：使用第二個元件的稍大的元件範例。

• ExampleCollection：將多個元件組合到一個檔案（稱為集合）中的範例。

• ExampleService：使用 ZephService 類別建立可重複使用服務的範例。

• 評級之星：使用資源和捆綁的範例。

瀏覽器相容性

ZephJS 基於現代瀏覽器標準構建，因此需要現代瀏覽器才能運作。特別是它需要以下 Web 標準：Shadow DOM v1、Custom Elements v1、Mutation Observer 和 Fetch。

以下瀏覽器相容性圖表指示哪些瀏覽器受支援，哪些不支援。 （所有瀏覽器統計數據均來自 caniuse.com，並在其許可的條件下使用。）

瀏覽器	所需的最低版本	筆記
火狐瀏覽器	63
鉻合金	54
狩獵之旅	10.1	:host 和 ::slotted 偽選擇器有問題。
歌劇	41
微軟邊緣	15（附 Polyfill）	需要使用聚合物填充材料。請參閱 ZephJS Polyfill 文件。
微軟瀏覽器	不支援
iOS 瀏覽器	10.3	:host 和 ::slotted 偽選擇器有問題。
安卓瀏覽器	67
黑莓瀏覽器	不支援	不支援 ov v10。
歌劇移動	46
安卓版 Chrome	71
安卓版火狐瀏覽器	64
手機瀏覽器	不支援	從 v11 開始不支持
安卓版 UC 瀏覽器	11.8
三星網路	6.2
QQ瀏覽器	不支援	從 v1.2 開始不支持
百度瀏覽器	不支援	從 v7.12 開始不支持
（圖表最後更新於 2019 年 2 月 25 日）

很棒的工程公司

ZephJS 由 The Awesome Engineering Company 編寫和維護。 Awesome Engineering Company 致力於為工程師、建築師和客戶建立簡潔、可配置、富有創意的軟體。

要了解有關 Awesome Engineering Company 和我們的產品套件的更多信息，請訪問我們的網站：https://awesomeeng.com。

支持與幫助

本產品由 Awesome Engineering Company 維護和支援。如需支持，請提出問題或透過我們的網站 https://awesomeeng.com 與我們聯絡。我們將盡力及時回覆您。

執照

ZephJS 是根據 MIT 許可證發布的。請閱讀許可證文件以了解詳細資訊。