ELF,意为小精灵,来自 War3 中暗夜精灵族的农民。

通常当我们开始一个新的 HTML5 场景营销活动项目时,需要创建项目目录,初始化基本的项目文件,然后再添加构建(grunt/gulp/webpack)相关的文件(一次两次三次…,像小精灵采木一样~),目前有不少工具可以帮我们解决一部分这种重复性的工作,但不能完全的解决,于是,就有了小精灵 – ELF

快速上手

1. 安装

通过 npm 全局安装(依赖的包比较多,推荐使用淘宝的 npm 镜像进行安装)

安装好后,可以运行 elf --help 查看支持的命令和帮助说明。

2. 初始化项目

假如我们现在要做一个向下整页滑屏的 HTML5 项目

这样一个向下整页滑屏的 HTML5 项目就已运行在开发模式上,样式预处理自动编译、样式热加载等功能早已具备,在此基础上,你就可以开始按照你的需求愉快的开发了。

3. 部署

当项目开发完成之后,需要将代码合并压缩用于部署,运行

会生成一个 dist 文件夹用于部署。

整个流程下来,基本解决了 HTML5 项目开发过程中项目初始化和构建部分的重复工作,已在团队内广泛使用,包括 Q4 京东品牌运营的10多个 H5 项目,如

qr_hjsp qr_jdjx
皇家视频 京东精选

功能介绍

ELF 主要包括三部分功能:项目构建、示例模板和通用组件。

项目构建

现在在做 web 开发时,基本都会引入构建工具,常用的有 gruntgulp 以及目前最流行的 webpack,再配合各种插件,好处就不多说了,相信每个使用者都有自己的体会和心得。

ELF 基于 webpack 同时整合了

  • webpack-dev-server
  • sass-loader、less-loader、style-loader
  • html-webpack-plugin
  • postcss-loader、autoprefixer、postcss-plugin-px2rem、postcss-sprites、postcss-assets
  • image-webpack-loader
  • *-loader …

提供了

  • 开发时样式热加载
  • 支持 Sass、Less 和 Stylus 样式预处理自动编译
  • Autoprefixer 前缀补全
  • px -> rem 自动转换
  • 雪碧图合成
  • 自动获取图片 width 和 height
  • 部署构建时图片压缩
  • 部署构建时代码合并压缩
  • 等等

有了这些功能,可以让我们在开发时更多的专注于需求实现上。

示例模板

为便于快速初始化项目,提供了一些模板项目

  • 基础模板(base)该示例展示了最基本的项目结构,没有提供额外的功能,可以通过该示例了解整个项目的构建
  • 划屏模板(swiper)滑屏示例,基于 swiper, 可基于该项目初始化实现滑动翻屏的项目。
  • 场景切换模板(switcher)场景切换示例,基于 swiperanime.js,可基于该项目初始化实现滑动场景切换的项目。
  • 3D全景模板(panorama)全景示例,基于 three.jsorientation.js,可基于该项目初始化实现重力感应配合全景的项目。
  • 视频播放模板(video)在手机上使用 video 标签播放视频的基础示例。
  • 多页面模板(multiple-page) 生成多页面示例。
  • React 模板(react)构建 React 项目示例。

通过这些示例,可以快速初始化项目,你也可以根据自己的需求,定制自己的初始项目。

通用组件

在项目开发中,有些常用功能已被封装成通用组件,例如:swiper
Github 上有大量优秀的开源组件,基本上能满足你所有需求,本着轮子不嫌多的精神,也造了两个

欢迎试用并提供问题或优化反馈~~

写在最后

项目最初的形态是由几个整理的典型示例组成,经过两次迭代重构后变成了现在的样子,在开发过程中的灵感主要来自 create-react-app

欢迎各位同学试用,特别是做 HTML5 场景营销活动的同学,如果在使用过程中遇到什么问题,欢迎提交 issuesPR,或者 FORK 构建自己的版本。

Github 地址

 

喜欢(9) 评论(0) 分享

Leave a Reply

© 2017 JDC. All Rights Reserved.