普通报表/决策报表中 FR.Msg 系列弹窗功能汇总

在 FineReport 中,FR.Msg 系列方法可用于实现多种弹窗效果,既能提示信息,又能与用户交互。以下整理了常用的四类弹窗及示例代码。


一、FR.Msg.alert(确定弹窗)

效果:单按钮确认框

示例代码

// 基础提示
FR.Msg.alert("警告", "值错误");

// 带回调操作(清空指定控件值)
var textCtrl = _g().getParameterContainer().getWidgetByName("textEditor0");
FR.Msg.alert("提示", "请输入有效值", function() { 
    textCtrl.reset();
});

说明:支持点击后触发联动操作。


二、FR.Msg.confirm(双选弹窗)

效果:确认/取消选择框

示例代码

FR.Msg.confirm("警告", "确定要删除吗?", function(value) {  
    if (value) alert("即将删除!");
    else alert("取消删除!");
});

说明value 值标记用户选择状态(true 表示确认,false 表示取消)。


三、FR.Msg.prompt(输入弹窗)

效果:文本输入对话框

示例代码

// 带默认值的输入框(同步更新控件值)
var textCtrl = _g().getParameterContainer().getWidgetByName("textEditor0");
FR.Msg.prompt("输入", "爱好", "运动", 
    function(value) { textCtrl.setValue(value); }
);

说明:支持回传用户输入的内容,可用于动态更新控件值。


效果:浮动式信息提示

四、FR.Msg.toast(状态提示)

示例代码

// 带图标状态提示
FR.Msg.toast({
    message: "导出成功",
    type: "success"  // 可选 success/info/warn/error
});

说明:在 11.0.10+ 版本中支持状态图标(成功、信息、警告、错误)。

功能对比表

方法 弹窗类型 主要功能 回调支持 常见场景
FR.Msg.alert 单按钮提示框 提示信息并确认 支持 输入校验、错误提示
FR.Msg.confirm 确认/取消对话框 获取用户二选一的选择 支持 删除确认、重要操作确认
FR.Msg.prompt 输入对话框 获取用户文本输入 支持 填写备注、动态参数输入
FR.Msg.toast 浮动提示 显示状态信息 不支持 操作结果提示(成功/失败)