当需要替换原有的JavaScript文件时,在扩展包中建立与该JavaScript文件一致的目录结构,在该目录中建立同名的JavaScript文件。Smartbi会优先加载扩展包中的JavaScript文件。请参照"修改Smartbi JS文件"。
在需要修改原有JavaScript的部分功能时,在扩展包中建立与该JavaScript文件一致的目录结构,建立【原有JavaScript文件名】+【.patch】命名的文件,例如在在扩展包中建立文
件"src/web/vision/js/bof/baseajax/common/LoginView.js.patch",该文件的作用在于声明对原有JavaScript文件的修改。
一般修改的方式会有以下几种:
自定义Patch文件方式,利用同一个js文件中多个相同的同名方法,最后一个会生效的原理,smartbi在加载js脚本时,会遍历所有扩展包,然后将扩展包中同路径及同名的.js.patch文件内容附加到产品内置js的后面,最后返回的是合并后的js,意味着这种方式是部分修改产品js,风险相对会小,升级产品的话也只是修改的那个方法可能产生问题。 所以在一般情况下最好使用Patch文件修改方式,这样可以降低将来Smartbi升级造成的风险。 |
在Patch文件中重新声明该方法的实现。
LoginView.prototype.elemPassword_focus_handler = function(ev) { alert("Before Password Select"); this.elemPassword.select(); }; |
在Patch文件中先保留原有方法实现并重新声明该方法实现,在新的实现中可以调用保留的方法。
//保存原有方法实现到临时名称中 LoginView.prototype.__elemLogin_click_handler = LoginView.prototype.elemLogin_click_handler; LoginView.prototype.elemLogin_click_handler = function(ev) { alert('Before login'); // 调用保存的原有方法实现 this.__elemLogin_click_handler(ev); alert('After login'); } |
// 声明一个新的JavaScript类的构造函数 var LoginViewPatch = function(container) { alert('Before constructor'); // 调用原有的构造函数 LoginViewPatch.superclass.constructor.call(this, container); alert('After constructor'); } // 声明新的JavaScript类是对原来的类打补丁 lang.patch(LoginViewPatch, LoginView); |
1、示例工程代码 ModifyJSFile.rar
2、效果如下:
视频教学点击下载:修改smartbi js文件