allWebPlugin中间件自定义alert、confirm及prompt使用
allWebPlugin简介
allWebPlugin中间件是一款为用户提供安全、可靠、便捷的浏览器插件服务的中间件产品,致力于将浏览器插件重新应用到所有浏览器。它将现有ActiveX控件直接嵌入浏览器,实现插件加载、界面显示、接口调用、事件回调等。支持Chrome、Firefox、Edge、360等浏览器,接口调用友好、集成方便。为用户提供“信息化系统 + allWebPlugin + 插件 + 浏览器”的解决方案。
在Web开发时,经常需要使用alert、confirm及prompt对话框与用户交互。提示或获取用户输入。allWebPlugin中间件为了满足上述需要,设计了一套自定义的对话框,供用户使用。
下载地址
链接:百度网盘 请输入提取码
提取码:z3q0
如下图所示,下载allWebPlugin_x86_v2.0.0.20_stable_20240921.zip安装包。
使用步骤
第一步:在使用createContainer创建插件容器时,设置是否使用浏览器插件。在使用本接口之前,必须先给大家介绍一下createContainer接口。具体如下:
createContainer方法
功能说明:创建插件容器。
参数说明:
canvas: 网页canvas画布元素
progID: 字符串 插件容器标识
license: 字符串 授权信息
bFixSize: 布尔 是否固定大小。注意:百分比自适应时,为false,不显示插件截图。本参数自v2.0.0.16起支持
blUsePluginUI: 布尔 是否使用插件容器对话框。注意:false时,使用浏览器自带提示框,提示框显示时会隐藏插件容器;true时,使用插件容器对话框,不会隐藏插件容器窗口。自v2.0.0.20起支持
返回值:
类型:PluginHostCnt对象
当返回值不为null时表示成功,其它表示失败。
通过接口介绍可以知道,blUsePluginUI为false时,使用浏览器自带提示框,提示框显示时会隐藏插件容器;blUsePluginUI为true时,使用插件容器自定义对话框,不会隐藏插件容器窗口。为了能使用插件自定义对话框,我们这里将blUsePluginUI设置为true(默认值为true)。具体代码如下:
if(hostCnt.createContainer(canvas,"PluginContainer",license,false,true) == true)
{
//hostCnt.UI.ForceShowUI(false);//创建时隐藏插件,需要调用这句,隐藏插件
}
第二步:使用alert、confirm及prompt接口调用浏览器插件自定义对话框。下面将使用示例分别介绍。
alert示例
如下图,响应插件创建事件,并提示。
function OnCreated(){
alert("OnCreated 事件");
}
效果如图所示:
confirm示例
如下图,关闭时提示是否关闭文档。
function Close()
{
if(confirm("是否关闭文档?")){
allWebOfficeAx.Close_Asyn(0).then(function(data){
ShowError(data);
});
}
}
效果下图所示
prompt示例
如下图获取用户输入的内容替换选定区域内容。
function WebSetWordContent(){
var mText=window.prompt("请输入内容:","测试内容");
if (mText==null){
return (false);
}else{
WebOffice.WebObject.ActiveDocument().Application().Selection().Range().Text = mText+"\n";
}
}
作用及意义
保留了原滋原味的alert、confirm及prompt接口调用习惯,同时有避免了浏览器自带对话框可能存在图层遮挡的问题。
注意,若要使用浏览器自带的对话框,请在创建插件容器时,将blUsePluginUI设置成false。这样的话,就会使用浏览器自带的对话框,插件容器窗口将在对话框显示时,自动隐藏,关闭对话框时,自动显示。