fis3打包中的一些注意事项
1.在html文件中,如果在标签的style属性内添加路径,fis不会识别改路径并打包,如
2.fis主要针对静态文件进行打包。对其他文件打包会出现一些问题。
比如jsp页面。下面的例子script.jsp(这个jsp会在其他页面使用<%@include file="/WEB-INF/include/script.jsp"%>引用,里面有两个变量MOD_NOT_INCLUDED和JQUERY_NOT_INCLUDED,初始值都是true)
2.1 jsp中引用mod.js
<%if(MOD_NOT_INCLUDED){%> <script type="text/javascript" src="/common/dep/mod.js"></script> <%MOD_NOT_INCLUDED=false;}%> <%if(JQUERY_NOT_INCLUDED){%> <script type="text/javascript" src="/common/dep/jquery.js"></script> <%JQUERY_NOT_INCLUDED=false;}%> <script src="/js/wording.js" type='text/javascript'></script>
注意:fis会检查引用的名称为mod.js的引用(mod.js是fis默认模块加载脚本,改成别的名称fis就不会识别了),将mod.js的引用放在<body></body>的最后面;如果本页面没有body标签则导致mod.js无地方放置,最终编译后的结果是
<%if(MOD_NOT_INCLUDED){%> <%MOD_NOT_INCLUDED=false;}%> <%if(JQUERY_NOT_INCLUDED){%> <script type="text/javascript" src="/static/pc-dev/common/dep/jquery.js"></script> <%JQUERY_NOT_INCLUDED=false;}%>
<script type="text/javascript" src="/common/dep/mod.js"></script>没有了。
注意续:如果mod.js放置成功(本文件有body标签),然后收集这个文件中的所有外部引用js引用,然后将js的引用放在mod.js引用的后面,css引用然后将css引用放在<head></head>的最后面,。我们将上面的例子更改为
<link rel="stylesheet" type="text/css" href="/common/css/common.scss" /> <%if(MOD_NOT_INCLUDED){%> <body> <script type="text/javascript" src="/common/dep/mod.js"></script> </body> <%MOD_NOT_INCLUDED=false;}%> <%if(JQUERY_NOT_INCLUDED){%> <script type="text/javascript" src="/common/dep/jquery.js"></script> <%JQUERY_NOT_INCLUDED=false;}%>
编译结果是
<link rel="stylesheet" type="text/css" href="/static/pc-dev/common/css/common.css" /> <%if(MOD_NOT_INCLUDED){%> <body> <script type="text/javascript" src="/static/pc-dev/common/dep/mod.js"></script> <script type="text/javascript" src="/static/pc-dev/common/dep/jquery.js"></script> </body> <%MOD_NOT_INCLUDED=false;}%> <%if(JQUERY_NOT_INCLUDED){%> <%JQUERY_NOT_INCLUDED=false;}%>
但是无论如何只要jsp中引用mod.js都可能导致脚本引入位置发生改变,从而导致逻辑混乱(如上面的MOD_NOT_INCLUDED判断根本没有起到任何作用)。
2.2 jsp的引入脚本中使用data-loader属性
如下实例
<%if(JQUERY_NOT_INCLUDED){%> <script type="text/javascript" src="/common/dep/jquery.js" data-loader></script> <%JQUERY_NOT_INCLUDED=false;}%>
fis编译结果
<%if(JQUERY_NOT_INCLUDED){%> <%JQUERY_NOT_INCLUDED=false;}%>
结果是脚本没有了。说明:使用data-loader属性,脚本会被收集,并且放在<body></body>的最后面,如果没有body标签则导致脚本无处放置。
我们加上body标签
<%if(JQUERY_NOT_INCLUDED){%> <body> <script type="text/javascript" src="/common/dep/jquery.js"></script> </body> <%JQUERY_NOT_INCLUDED=false;}%> <script src="/js/wording.js" type='text/javascript'></script>
编译结果
<%if(JQUERY_NOT_INCLUDED){%> <body> <script type="text/javascript" src="/static/pc-dev/common/dep/jquery.js"></script> <script type='text/javascript' src="/static/pc-dev/js/wording.js"></script> </body> <%JQUERY_NOT_INCLUDED=false;}%>
说明:fis检测到页面中有body也会去收集js引用,然后放置在body标签中。
将data-loader去掉
<%if(JQUERY_NOT_INCLUDED){%> <script type="text/javascript" src="/common/dep/jquery.js"></script> <%JQUERY_NOT_INCLUDED=false;}%> <script src="/js/wording.js" type='text/javascript'></script>
编译结果
<%if(JQUERY_NOT_INCLUDED){%> <script type="text/javascript" src="/static/pc-dev/common/dep/jquery.js"></script> <%JQUERY_NOT_INCLUDED=false;}%> <script src="/static/pc-dev/js/wording.js" type='text/javascript'></script>
2.3 jsp脚本中有body标签
刚才在2.2中有body标签的例子说明
2.4 jsp中使用其他需要加载外部文件的情况
项目中用到imweb-tplv2模板插件。里面的文件一般有.tpl/.js/.css三种.js是入口文件,引用.tpl和.css文件。在jsp中使用的时候fis编译会收集这些js和css,将css文件引用放在head标签纸,js引用放到body中。如果这两个标签没有则会导致这些引用全部没有。
===================================
2019.11.29 后记
本来不准备把这篇文章发布出来的,因为这是早些时候的文章了,当时想着后面会完善,但是后面没有时间和精力,而且当前使用fis3打包的不多了。但是毕竟写了,留个纪念,纪念我曾经用过fis3,后面这篇文章也不会维护了。