提示
脚手架生成模板中不会有入口Html页面,对于入口页,子系统的研发同学无需关心,一般由负责该系统的前端同学维护,如前端同学有不清楚的地方可以联系CabinX团队。
入口页面作为基础,包含的功能实现一般有:
引入基础框架资源
- env.js必须引入。
<script>
(function () {
...
document.write('<script src="' + window.kayak.root + 'entry_html/dist/js/env.js?_=' + (new Date()).getTime() + '" type="application/javascript"><\/script>');
...
});
</script>
2.使用version,以免资源缓存。
Cabinx框架的静态资源是浏览器强缓存的,更新时需要修改version,否则浏览器会使用缓存的资源,导致更新不及时。
version的组成为:年月日时分
,如:202203151028
,月日时分不满两位的需要补零。
window.kayak.getLastedVersion
会页面在访问时比较自定义version和框架的version,选用大者,保障业务和框架更新都能避免缓存。
<script>
...
window.onload = function () {
setTimeout(function () {
var version = window.kayak.getLastedVersion(202203151028);
window.kayak.Loader.loadCss(version);
window.kayak.Loader.loadJs(function () {
...
seajs.config({
EVT: window.kayak.EVT,
kayak: {
version: version,
...
}
});
...
}, version);
...
}, 1);
...
}
主题、尺寸配置
详情请查看主题化。
国际化配置
CabinX虽然提供了设置语言的API,但真实系统中嵌入的项目涵盖多个历史版本框架,如:cabin1.0,cabin2.0,为覆盖历史版本,入口页使用kayak提供的API设置更安全。
使用CabinX技术的子系统仍然可以使用CabinX提供的其他API。
设置的语言标识可选值请查看国际化。
提示
子系统无需自己设置国际化,系统的入口页负责该工作,子系统只需实现界面的翻译工作即可。
var locale=localStorage.getItem('xxx')||'zh_CN';
window.kayak.setLocale({ locale: locale }, false, false);//参数:(data:object, reload:boolean, isSecure:boolean)
权限,格式化等等其他配置
详情请查看全局配置。