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 许可证发布的。请阅读许可证文件了解详细信息。