fis-parser-velocity

A parser for fis to compile velocity template（基于fis的velocity模板解释器）

使用方法

fis.match('*.vm', {
  parser: fis.plugin('velocity', {
    /**
     * 模块化加载框架 [requirejs|modjs|seajs]
     * 为null时，每个js文件用script标签引入
     *   e.g.
     *   <script src="/widget/a/a.js"></script>
     *   <script src="/widget/b/b.js"></script>
     * 为requirejs|modjs|seajs时
     *   e.g.
     *   require(["/widget/a/a.js", "/widget/b/b.js"]);
     *   或者
     *   seajs.use(["/widget/a/a.js", "/widget/b/b.js"]);
     */
    loader: null,
    /**
     * 是否进行同步加载，默认为false，loader设置不为null时生效
     * 因为allInOne打包时会被忽略异步依赖，所以使用allInOne时需要开启同步依赖
     */
    loadSync: false,
    // 全局macro文件，相对于root
    macro: '/page/macro.vm',
    // 是否编译内容，默认为true，为false时不编译velocity语法，只引用资源依赖
    parse: true,
    // 全局的mock文件，相对于root，默认为null
    commonMock: null,
    // velocity的root配置，默认为项目根目录
    root: [fis.project.getProjectPath()]
  }),
  // 将扩展名发布为html
  rExt: '.html',
  // 以html文件类型作为fis3-postpackager-loader语言分析
  loaderLang: 'html'
});

组件化实现方法

widget
 └ header
   ├ header.vm
   ├ header.js
   ├ header.mock
   └ header.css

使用#parse('widget/header/header.vm')指令引入header组件，插件会自动将header.js和header.css插入html文档中，并将header.mock文件的内容作为解析header组件的数据源。

默认组件的css和js文件会分别插入</head>和</body>标签之前，也可以自定义插入位置，css插入占位符为<!--WIDGET_CSS_HOLDER-->，js插入占位符为<!--WIDGET_JS_HOLDER-->。

.vm或.mock文件修改后，页面会自动重新编译，如果开启了livereload，可以自动刷新预览最新修改。

新增组件化指令

新增了三条用于组件化的指令：#style, #framework, #script。

#style('xxx')

用于对css文件的引入。 #style('xxx.css') 会解析成 <link rel='stylesheet' href='xxx.css'/>。也可以使用以下方式内嵌css代码：

  #style()
    body { background: #fff; }
  #endstyle

会解析成：

<style>
  body { background: #fff; }
</style>

#framework('xxx')

用于引入模块化框架文件，如：requirejs, modjs, seajs等，比如：#framework('lib/require.js') 会解析成 <script data-loader src='lib/require.js'></script>。

#script('xxx')

用于引入纯js组件，如果有同名的css文件，会一同被加入依赖列表，例如：

#script('widget/a/a.js')

会解析成以下代码：

<script src='widget/a/a.js'></script>
<link rel='stylesheet' href='widget/a/a.css'/>

同样，也可以使用如下方式内嵌js代码：

#script()
  ... some javascript code ...
#endscript

会解析成：

<script>
  ... some javascript code ...
</script>

需要注意的地方

按条件引入组件时，无论条件是否成立都引入，纯前端项目不能做到按需要加载，没办法。如：

#if($isLogin)
  #parse('widget/userinfo/userinfo.vm')
#else
  #parse('widget/userlogin/userlogin.vm')
#end

会认为需要同时引入userinfo和userlogin的静态资源。

使用模块化框架时，请参考fis3-postpackager-loader的使用规范，如果页面中没有明确使用require.js|mod.js|sea.js是，对引用模块化框架的script标签加data-loader属性，即<script data-loader src='/path/to/xxx.js'></script>，这样才能正确插入sourcemap。

changeLog

v0.3.6

• 自定义 root 问题修复
• 完善样例代码

v0.3.5

• 修复多层 #parse 解析不完整问题

v0.3.4

• 更新fis3到v3.4.31
• 修改一些语法

v0.3.3

• 增加.scss文件依赖支持

v0.3.2

• 使用部分es6语法，所以需要nodejs4.0+
• 更新fis3到v3.4.16

v0.3.1

• 更新fis3到v3.3.0

v0.2.1

• 从0.2.0版本开始，模拟数据文件扩展名从.json变成了.mock，主要考虑velocity tools的需求，.mock文件内容其实是一个nodejs模块，可以满足velocity tools调用方法，如$util.add(1,1)输出 2。