❤
npm
Sign UpSign In

efront

4.21.0 • Public • Published

English version

efront 是一个开发工具，提供前端开发所需的各种功能，可作为开发环境使用，也可当成命令行工具使用其中的部分功能。

efront 思想

  1. 每个文件只导出一份数据，这一份数据可以是 boolean,number,string,function,object,bigint,null,undefined 中的任意一种
  2. 文件名即变量名，在其他文件中引用当前文件导出的变量，只要使用当前文件的文件名（不含后缀）即可
  3. 无环形引用（相互调用：a引用b，b引用a；首尾引用：a引用b，b引用...c，c引用a）
  4. 减少异步io的时间，应用启动过程只加载有用代码，启动完成后等待用户操作的同时预加载下一步的代码
  5. 版本局部更新，异步加载的每一份代码拥有一个独立的版本号，在版本信息无变化时不重复加载

efront 功能列表

  1. 提供 0 秒启动的开发服务器，允许代码在浏览器中完成依赖项的异步加载
  2. 提供 “按文件名引用的代码” 的编译环境，允许开发者不写 import, require 等语句
  3. 提供具有环形检查的加载器
  4. 自动识别并附加预加载的逻辑
  5. 自动追加检查缓存的逻辑并生成代码版本号
  6. efront 服务器提供跨域中转功能
  7. efront 编译导出的组件对可能造成代码可读的字符串和属性进行提取和加密

基本命令（部分命令适用于windows，其他系统类似）

1. 下载安装

efront 运行在 nodejs 环境下，请在安装 nodejs 环境后使用。 从npm全局安装efront

npm install -g efront

2. 查看帮助系统

命令行帮助命令如下

efront help

也可以用如下命令启动文档服务器，用浏览器查看帮助信息

efront docs

3. 启动开发环境服务器

efront live
efront live HTTP端口
efront live HTTP端口 HTTPS端口

其中HTTP端口和HTTPS端口为数字，可以不输入，更多使用方案可以查看帮助系统。要禁用https服务端口开启时的警告信息，可以配置自己的ssl证书路径和证书密码。

4. 压缩编译项目

默认将编译输出的目标代码保存到public目录 可以把public目录的代码发布到任意服务器上

set app=PROJECT_NAME
set public_path=PUBLIC_PATH
efront public

其中PUBLIC_PATH为发布路径，PUBLIC_PATH的默认值是当前目录的public文件夹

  • 如果是要发布在服务器上，不建议使用以.html结尾的方式发布，将异步加载的代码写入独立的文件

  • 如果要导出无服务器本地可以访问的项目，可以设置一个以.html结尾的项目名，将异步加载的代码合并到首页文件

set app=PROJECT_NAME.html
  • 如果要导出组件，可以设置一个以.js结尾的项目名
set app=PROJECT_NAME.js

  • 目前版本的efront提供对 commonjs中的require语法和es6中的import语法 的不完全支持（不支持异步环形调用），对于符合要求的相关项目，可以进行编译发布。

  • 如果要发布含有require语法的组件，并希望将组件及所有依赖项合并输出，那么可以将上面的efront public替换为efront publish

  • 如果需要自动识别路径，类似public/dist/output/release的目录都可能被识别为目标路径，这些路径中的文件可能被覆盖，如果确认可行，可以使用efront build或efront release

5.Watch模式

监测文件变化，自动编译更新的部分并输出到指定目录

set app=PROJECT_NAME
set public_path=PUBLIC_PATH
efront watch

可配置项说明

efront 优先读取系统环境变量中的配置，也可以将配置信息写入配置文件。 efront 默认读取当前路径下的_envs/和用户目录的.efront/_envs/进行环境配置的初始化（如果要修改默认环境配置的路径，可以在系统环境变量中设置CONFIG_PATH，多个目录可以用英文逗号分开），其中的setup.bat为环境配置的入口，访问工作目录的某个子项目APP时，还将自动读取_envs/app=%APP%.bat中的配置。

当前版本的efront，支持命令行快捷配置环境变量，如

 efront watch --APP=kugou --PUBLIC_PATH=... --PAGE_PATH=...
配置项 说明
APP 应用名，影响最终生成应用的路径和默认的源文件路径
PAGE_PATH 页面文件所存放的根路径，默认为./apps
COMM_PATH 组件文件所存放的根路径，如果存在多个，可以用 , 分割，可以使用 : 指定为efront所提供的组件的路径，默认为./coms
PUBLIC_PATH 发布的目标根路径，最终生成的代码路径为PUBLIC_PATH\APP，如果此项被指定为PAGE_PATH，efront将禁用发布功能，在执行efront start后，可以通过浏览器访问压缩版本的代码
PUBLIC_EXTT 发布的逻辑代码的扩展名，默认.js或.txt
PAGE 页面文件存放的路径，默认为应用名APP
COMM 组件文件存放的路径，默认为应用名加efront默认组件库APP,zimoli
PREFIX 发布时指定组件className前缀，默认无前缀
NOPROXY 传统代理，默认在开发环境开启传统代理，在生产环境禁用传统代理
DIRECT 如果是用pathname作为单页应用的页面路径，可以配置此参数，以使空路都指向该参数所指定的路径。如果配置为数值，则自动截取用户路径的前几级，如果指定为字符串，则所有空路径都返回该字符串路径下的内容。
ENTRY_NAME efront默认依次查找文件中声明的main,Main,MAIN,<文件名>做为导出对象（入口），用户可配置此环境变量以进行修改
EXTRACT 如果项目有多个入口，efront默认将主程序写入独立的文件，如果项目是单入口，efront默认将主程序并入index.html，如果您的代码有特殊要求，可以配置引此参数指定efront的行为
UPLEVEL 如果您的代码发布时不需要降级，可添加此参数，以提高编译速度
MSIE 用efront live --msie启动服务器，可对ie系列浏览器进行代码适配，以便在ie上动态调试
AUTOEVAL 自动常量化的开关，在打包目标代码时默认开启，在开发环境默认关闭，可以指定参数--no-autoeval或--autoeval修改efront的默认行为

功能选项

  • efront 启动的服务器，默认提供跨域中转的功能，可以在index.html的头部脚本中设置window.cross_host='https://somehost/'指定一个具体的efront服务器实例供cross方法使用
  • efront 默认禁用了首页的缓存功能，如果要启用，可以在头部script中加入 window.preventCache=false;
  • efront 默认禁止在iframe中运行，如果要开启，可以在头部script中加入 window.PREVENT_FRAMEWORK_MODE=false;
  • efront应用的默认初始化脚本是zimoli('/main');，可以在body标签上加上main-path=...属性指定初始化脚本的路径
  • efront 默认将page_path指向的路径中的.ts,.js,.mjs,.cjs,.less,.html,.xht,.vue文件识别为页面文件，可以在index.html加上<script src='libpath/*' type=deleteoncompile></script>，其中libpath/*指向静态文件的路径，efront编译过程将识别并做出正确的处理
  • 如果仅做为跨域服务器使用，可以将开发环境的url改写为如下形式，以使返回结果加上跨域头：
  1. 转发http 用 * http://EFRONT_HOST/*BACKEND_HOST/PATHNAME
  2. 转发https 用 ** http://EFRONT_HOST/**BACKEND_HOST/PATHNAME


如： 在本机的88端口启动efront服务器，要访问https://im.qq.com/index ，可以请求http://localhost:88/**im.qq.com/index取得带跨域头的数据

注意事项

  • efront版本更新后，尽可能兼容老版本的项目，如果出现不兼容的情况，可以回退到之前的版本。efront发布的项目或组件中含有发布项目时所用的efront版本。如果是独立组件，版本信息一般在组件文件的头部，如果是项目，版本信息在项目的index.html中。安将指定的版本的命令如下 
      npm install -g efront@版本号

其中版本号替换为您要安装的版本。 您也可以在github上提issue，可以使用中文或中文，其他语言不禁止，但作者不一定能理解到位。

  • efront 为组件生成的较长的 className 选择器 (含中划线，如.comm-button)可能会发生变化，如果要为嵌入的组件设置样式，可以使用 efront 为其生成的较短的 className 选择器 (不含中划线-，如.button)
  • efront 将不在首字符位置的$识别为快捷分割符，以便以变量名的方式引入多级文件夹中的模块，文件命名时不要在文件名的中间位置使用$符号
  • with 语句中的变量无法准确识别，最好不要使用。如果非要在efront环境下使用，请在with语句外提前声明，with中出现的未声明的变量。
  • 如果要导出无服务器项目，不要使用异步方法加载本地文件的数据
  • 从 efront2.5 开始template将被识别为 efront 保留字，专门用来指代同名的 html 文件的内容
  • 从 efront3.29 开始.xht文件将被识别为组件文件，如果文件内未提供入口，入口函数将由 efront 自动生成并填充

相关链接

efront 在线文档

efront 兼容性说明   版本简介   与前端框架对比

efront服务器管理工具

白前看图   酷酷千百易云音乐

如果您要提供修改建议或报告问题，可加入QQ群 710029752 反馈。

项目作者正在找工作，有招工意向的可将招工信息发送至我的邮箱 yunxu1019@live.cn

Versions

Current Tags

VersionDownloads (Last 7 Days)Tag
4.21.07latest

Version History

VersionDownloads (Last 7 Days)Published
4.21.07
4.20.21
4.20.11
4.20.02
4.19.71
4.19.61
4.19.51
4.19.41
4.19.32
4.19.21
4.19.11
4.19.02
4.18.41
4.18.31
4.18.21
4.17.02
4.16.01
4.15.31
4.15.21
4.15.11
4.14.31
4.14.21
4.14.01
4.13.21
4.13.11
4.12.11
4.12.03
4.11.81
4.11.61
4.11.51
4.11.41
4.11.21
4.11.11
4.11.01
4.10.21
4.10.11
4.10.01
4.9.41
4.9.31
4.9.22
4.9.11
4.8.31
4.8.21
4.8.11
4.7.31
4.7.21
4.7.11
4.7.01
4.6.31
4.6.11
4.5.182
4.5.172
4.5.161
4.5.151
4.5.141
4.5.131
4.5.101
4.5.82
4.5.71
4.5.42
4.5.31
4.5.02
4.4.141
4.4.131
4.4.121
4.4.111
4.4.91
4.4.81
4.4.62
4.4.52
4.4.32
4.4.21
4.4.11
4.4.01
4.3.151
4.3.141
4.3.111
4.3.101
4.3.91
4.3.81
4.3.71
4.3.61
4.3.51
4.3.42
4.3.31
4.2.81
4.2.71
4.2.61
4.2.51
4.2.41
4.2.31
4.2.21
4.2.11
4.1.141
4.1.131
4.1.121
4.1.111
4.1.101
4.1.91
4.1.81
4.1.61
4.1.51
4.1.41
4.1.31
4.1.22
4.1.11
4.1.01
4.0.581
4.0.571
4.0.561
4.0.552
4.0.541
4.0.532
4.0.511
4.0.501
4.0.482
4.0.451
4.0.411
4.0.402
4.0.391
4.0.381
4.0.371
4.0.351
4.0.342
4.0.331
4.0.322
4.0.311
4.0.301
4.0.291
4.0.281
4.0.252
4.0.241
4.0.232
4.0.222
4.0.201
4.0.191
4.0.171
4.0.162
4.0.152
4.0.131
4.0.111
4.0.101
4.0.91
4.0.81
4.0.71
4.0.61
4.0.31
4.0.21
4.0.01
3.38.21
3.38.11
3.37.01
3.36.91
3.36.71
3.36.61
3.36.51
3.36.32
3.36.21
3.36.11
3.36.01
3.35.141
3.35.131
3.35.121
3.35.111
3.35.101
3.35.91
3.35.81
3.35.71
3.35.61
3.35.51
3.35.41
3.35.31
3.35.11
3.35.01
3.34.121
3.34.111
3.34.81
3.34.72
3.34.61
3.34.42
3.34.32
3.34.22
3.34.01
3.33.32
3.33.22
3.33.11
3.33.01
3.32.01
3.31.22
3.31.11
3.31.01
3.30.41
3.30.21
3.30.11
3.30.01
3.29.31
3.29.21
3.29.11
3.28.11
3.28.02
3.27.11
3.27.01
3.26.161
3.26.152
3.26.141
3.26.81
3.26.71
3.26.61
3.26.52
3.26.42
3.26.31
3.26.21
3.26.12
3.25.162
3.25.142
3.25.121
3.25.111
3.25.81
3.25.71
3.25.51
3.25.31
3.25.21
3.25.12
3.25.01
3.24.71
3.24.51
3.24.32
3.24.21
3.23.01
3.22.101
3.22.91
3.22.81
3.22.71
3.22.61
3.22.51
3.22.41
3.22.31
3.22.21
3.21.61
3.21.51
3.21.41
3.21.31
3.21.21
3.21.11
3.21.02
3.20.171
3.20.161
3.20.151
3.20.141
3.20.131
3.20.111
3.20.101
3.20.81
3.20.71
3.20.62
3.20.41
3.20.31
3.20.21
3.20.12
3.20.01
3.19.21
3.19.12
3.19.01
3.18.31
3.18.23
3.18.11
3.18.01
3.17.21
3.17.11
3.16.11
3.16.01
3.15.71
3.15.61
3.15.22
3.15.11
3.14.111
3.14.93
3.14.81
3.14.31
3.14.21
3.14.02
3.13.41
3.13.31
3.13.23
3.13.14
3.12.61
3.12.52
3.12.42
3.12.32
3.12.22
3.12.11
3.12.01
3.11.41
3.11.31
3.11.21
3.11.11
3.11.01
3.10.73
3.10.51
3.10.43
3.10.31
3.9.163
3.9.151
3.9.142
3.9.111
3.9.101
3.9.91
3.9.81
3.9.41
3.9.21
3.9.12
3.9.04
3.8.71
3.8.515
3.8.41
3.8.21
3.7.91
3.7.81
2.47.10
3.7.74
2.47.00
3.7.61
3.7.51
3.7.31
3.7.11
3.7.03
3.6.02
3.5.131
3.5.121
3.5.111
3.5.101
2.46.30
3.5.91
3.5.81
3.5.71
3.5.61
3.5.53
2.46.20
3.5.41
2.46.10
3.5.32
2.46.00
3.5.21
3.5.11
3.5.01
3.4.71
3.4.62
3.4.53
3.4.41
3.4.31
3.4.22
2.45.00
3.4.11
3.4.01
3.3.81
2.44.110
3.3.742
2.44.100
3.3.60
2.44.80
3.3.50
2.44.71
3.3.40
3.3.30
3.3.20
2.44.60
3.3.10
2.44.50
3.3.00
3.2.20
2.44.40
3.2.10
2.44.30
3.2.00
2.44.20
3.1.40
3.1.30
2.44.10
3.0.90
2.43.60
3.0.80
3.0.72
2.43.50
3.0.40
2.43.20
3.0.30
2.43.10
2.42.20
2.42.10
2.42.01
2.41.100
2.41.90
2.41.80
2.41.70
2.41.60
2.41.50
2.41.40
2.41.30
2.41.20
2.41.10
2.41.00
2.40.10
2.40.00
2.39.30
2.39.20
2.39.10
2.39.00
2.38.30
2.38.20
2.38.10
2.38.00
2.37.60
2.37.50
2.37.40
2.37.30
2.37.20
2.37.10
2.37.00
2.36.10
2.36.01
2.35.00
2.34.00
2.33.00
2.32.20
2.32.10
2.32.00
2.31.00
2.30.10
2.30.00
2.29.120
2.29.110
2.29.100
2.29.90
2.29.80
2.29.70
2.29.60
2.29.50
2.29.40
2.29.30
2.29.20
2.29.10
2.29.00
2.28.00
2.27.190
2.27.180
2.27.170
2.27.161
2.27.150
2.27.140
2.27.130
2.27.120
2.27.110
2.27.100
2.27.90
2.27.80
2.27.70
2.27.60
2.27.50
2.27.40
2.27.30
2.27.20
2.27.10
2.27.00
2.26.10
2.26.00
2.25.60
2.25.50
2.25.40
2.25.30
2.25.20
2.25.10
2.25.00
2.24.30
2.24.20
2.24.10
2.24.00
2.23.10
2.23.00
2.22.00
2.21.30
2.21.20
2.21.11
2.21.00
2.20.20
2.20.10
2.20.00
2.19.10
2.19.00
2.18.80
2.18.70
2.18.61
2.18.50
2.18.40
2.18.30
2.18.00
2.17.10
2.17.00
2.16.61
2.16.51
2.16.40
2.16.20
2.16.10
2.16.00
2.15.60
2.15.50
2.15.40
2.15.01
2.14.00
2.13.60
2.13.50
2.13.40
2.13.30
2.13.11
2.13.00
2.12.140
2.12.130
2.12.120
2.12.110
2.12.100
2.12.90
2.12.80
2.12.71
2.12.60
2.12.50
2.12.40
2.12.30
2.12.10
2.12.00
2.11.20
2.11.10
2.11.00
2.10.91
2.10.80
2.10.71
2.10.50
2.10.40
2.10.31
2.10.20
2.10.10
2.10.01
2.9.100
2.9.91
2.9.80
2.9.70
2.9.60
2.9.50
2.9.40
2.9.30
2.9.20
2.9.10
2.9.00
2.8.140
2.8.130
2.8.121
2.8.110
2.8.100
2.8.90
2.8.80
2.8.71
2.8.60
2.8.50
2.8.40
2.8.30
2.8.20
2.8.10
2.8.00
2.7.50
2.7.40
2.7.30
2.7.21
2.7.10
2.7.00
2.6.331
2.6.320
2.6.311
2.6.300
2.6.291
2.6.281
2.6.270
2.6.260
2.6.250
2.6.241
2.6.231
2.6.220
2.6.210
2.6.200
2.6.191
2.6.180
2.6.170
2.6.160
2.6.150
2.6.140
2.6.130
2.6.120
2.6.110
2.6.100
2.6.90
2.6.80
2.6.71
2.6.60
2.6.50
2.6.40
2.6.30
2.6.20
2.6.10
2.6.00
2.5.60
2.5.51
2.5.40
2.5.30
2.5.20
2.5.10
2.5.00
2.4.40
2.4.30
2.4.20
2.4.10
2.4.00
2.3.30
2.3.10
2.3.01
2.2.90
2.2.80
2.2.70
2.2.60
2.2.50
2.2.40
2.2.31
2.2.20
2.2.10
2.2.01
2.1.100
2.1.90
2.1.80
2.1.70
2.1.61
2.1.51
2.1.40
2.1.30
2.1.20
2.1.10
2.1.00
2.0.120
2.0.110
2.0.101
2.0.90
2.0.80
2.0.70
2.0.60
2.0.50
2.0.41
2.0.31
2.0.11
2.0.00
1.19.52
1.19.30
1.19.20
1.19.11
1.19.00
1.17.30
1.17.21
1.16.26
1.16.11
1.16.01
1.15.50
1.15.40
1.15.30
1.15.10
1.15.00
1.14.31
1.14.21
1.14.11
1.14.00
1.13.80
1.13.70
1.13.61
1.13.30
1.13.20
1.13.10
1.13.02
1.12.120
1.12.110
1.12.100
1.12.90
1.12.61
1.12.50
1.12.41
1.12.30
1.12.20
1.12.10
1.12.00
1.11.140
1.11.130
1.11.120
1.11.111
1.11.100
1.11.90
1.11.80
1.11.71
1.11.61
1.11.50
1.11.41
1.11.31
1.11.20
1.11.10
1.11.01
1.10.31
1.10.20
1.10.10
1.10.00
1.9.90
1.9.80
1.9.70
1.9.60
1.9.41
1.9.21
1.9.11
1.9.00
1.8.70
1.8.60
1.8.51
1.8.40
1.8.30
1.8.20
1.8.14
1.8.00
1.7.80
1.7.70
1.7.60
1.7.50
1.7.40
1.7.30
1.7.20
1.7.10
1.7.00
1.6.60
1.6.50
1.6.40
1.6.30
1.6.20
1.6.10
1.6.00
1.5.50
1.5.45
1.5.30
1.5.20
1.5.10
1.4.10
1.4.00
1.3.30
1.3.20
1.3.10
1.3.00
1.2.30
1.2.20
1.2.10
1.2.00
1.1.70
1.1.60
1.1.50
1.1.40
1.1.30
1.1.20
1.1.10
1.1.00
1.0.100
1.0.90
1.0.80
1.0.70
1.0.60
1.0.50
1.0.40
1.0.30
1.0.20
1.0.10

Package Sidebar

Install

npm i efront

Repository

github.com/yunxu1019/efront

Homepage

github.com/yunxu1019/efront#readme

Weekly Downloads

578

Version

4.21.0

License

MIT

Unpacked Size

6.52 MB

Total Files

1013

Last publish

Collaborators

  • yunxu1019
Try on RunKit
Report malware