fis-postpackager-simple

    0.0.26 • Public • Published

    fis-postpackager-simple

    用于自动打包页面零散资源和应用打包资源的FIS插件

    功能

    • 自动将页面中声明的资源引用替换为pack中设置的资源
    • 自动将未打包的零散资源按照引用顺序打包,默认关闭

    用法

    $ npm install -g fis-postpackager-simple
    $ vi path/to/project/fis-conf.js #编辑项目配置文件
    
    //file : path/to/project/fis-conf.js
    //使用simple插件,自动应用pack的资源引用
    fis.config.set('modules.postpackager', 'simple');
    //开始autoCombine可以将零散资源进行自动打包
    fis.config.set('settings.postpackager.simple.autoCombine', true);
    //开启autoReflow使得在关闭autoCombine的情况下,依然会优化脚本与样式资源引用位置
    fis.config.set('settings.postpackager.simple.autoReflow', true);

    自动打包处理策略

    开启了autoCombine后,为了保证资源引用顺序的正确,插件会自动调整脚本的加载位置

    • <script src='path'></script> 引用的脚本默认会在打包后移动到body底部
    • <script data-position='head'></script> 引用或声明的脚本会移动到head底部 仅限pack打包,自动打包不适用
    • <script|link data-single='true'></script|link> 引用或声明的脚本和样式不会进行自动打包
    • <link rel='stylesheet' href='path'> 引用的样式表默认会在打包后移动到head底部
    • <script>console.log('hello world')</script> 编写的内嵌脚本将会移动到body底部
    • <script|link data-fixed='true'> 声明的标签不会被处理
    • <style></style> 不会进行任何处理

    配置项

    autoCombine

    设置是否自动将零散资源进行打包,默认为 false

    autoReflow

    设置是否自动优化脚本与样式资源引用位置,默认为 false

    fullPackHit

    设置是否资源需要全部命中pack设置才会将整个资源包引用

    fullPackHit.js

    默认为 false

    fullPackHit.css

    默认为 false

    forceOutput

    autoCombine或autoReflow时是否对不包含head和body的页面强制输出合并脚本

    headTag

    autoCombine或autoReflow时自定义 </head> 标记设置,如 <!--HEAD_END-->

    注意 替换完成后,headTag最终将不会被删除

    bodyTag

    autoCombine或autoReflow时自定义 </body> 标记设置,如 <!--BODY_END-->

    注意 替换完成后,bodyTag最终将不会被删除

    output

    合成文件输出路径,默认值 "pkg/auto_combine_${hash}" ${hash}为合成内容hash值 ${index}为合成文件序列

    适应范围

    用于简单的Web前端项目自动打包减少页面请求连接数,同时可以通过pack设置来对公共资源进行独立打包。

    DEMO

    https://github.com/hefangshi/fis-quickstart-demo

    Install

    npm i fis-postpackager-simple

    DownloadsWeekly Downloads

    49

    Version

    0.0.26

    License

    MIT

    Last publish

    Collaborators

    • hefangshi