[内部福利]@@include缺省参数

前几日我们构建时所用的gulp-file-include被诟病：“if判断太弱了” “参数不能有缺省值，现在有10多个参数，一个也不能省，太费劲”……当然，可以炒掉厮，换新的。不过现实情况时，我们现在已经自己定制过了，加了{{MIMAGE}} {{MCSS}}等我们独用的标识。如果换新的插件，这些又得重现实现一遍。鉴于此，我就步其后尘，加上了对缺省参数的支持，算是“打个补丁接着穿”吧。因功力有限，没有给if加上else。

说明

此方法的思路是给某一个文件内所用参数设置缺省值。

gulp-file-include本来有全局的设置缺省参数的机制（在gulp任务中设context参数，见文档），这种机制就像全局变量一样，作用域太广，适用于全局或者多个文件共用变量的情况。

用法

设有一个文件 footer.md.html，其中有一个参数@@foo。我们预期缺省让它为"abc"，如需指定，再特别设定。那就可以这样：

// footer.md.html

// 设置缺省参数，推荐放在文件首部
@@default {
    "foo": "abc"
}
// 正文
<div>
   <!-- ... -->
   <p>@@foo</p>
   <!-- ... -->
</div>

@@include该文件时，若欲使用foo的缺省值，则：

@@include("path/to/footer.md.html");

若欲赋其它值，则：

@@include("path/to/footer.md.html", {"foo": "some value"});

就是这样了。

@@if

其实缺省参数在@@if时更有用。上面的情况，如果找不到变量，仅是不替换；但在@@if时，找不到变量gulp会报错。

用法跟上面完全一样，因我们平时用的不多，故这里顺带提一下@@if的用法。文档

// footer.md.html

// 设置缺省参数，推荐放在文件首部
@@default {
    "foo": "abc"
}

// 正文
<div>
   <!-- ... -->

   @@if (foo === "abc") {
       <p>This is for default.</p>
   }

   <!-- ... -->
</div>

@@if用于根据某一条件来决定是否插入指定某html块。@@参数则总是显示，只不过显示的值不同。就像编程时的if语句和变量一样，各有用武之地，请酌情选用。

文件.../m/common/Footer/main.md.html中有一个示例，可参考