消息提示API

提示消息

$.IShowTip("提示消息");

警告消息

$.IShowWarn("警告消息");

错误消息

$.IShowError("错误消息");

确认

$.IConfirm( "提示", "是否确认？", function( data ) {
  // data 为点击按钮返回值，确认为 true，取消为 false
  if( data ) {
    // 点击确认执行事件
  }

  if( !data ) {
    // 点击取消执行事件
  }
});

IConfirm 方法执行时采用异步方式，实现同步场景建议使用如下代码。

表单场景

let needConfirm = true;
OnValidate: function(actionControl) {
  let specifiedAction = 'XXX';
  if (actionControl.Action == specifiedAction && needConfirm) {
    $.IConfirm('标题', '提示', (confirm) => {
      needConfirm = false;
      if (confirm) {
        actionControl.DoAction();
        needConfirm = true;
      } else {
        needConfirm = true;
      }
    })
    return false;
  }
  return true;
}

列表场景

// 需要拦截的操作编码，比如 Submit 提交
$.ListView.ActionPreDo = function(actionCode){
  let specifiedAction = 'XXX';
  if (actionCode == specifiedAction) {
    $.IConfirm('标题', '提示', (confirm) => {
      if (confirm) {
        // 手动发起请求，Post 方法更多参数可参考帮助中心
        $.ListView.Post(specifiedAction);
      }
    })
    return false;
  }
};

打开表单详情窗口

适用于查看或新增另外一个表单的数据。

$.IShowForm( 
  "D000183sm4573d2cb67b447b6acab1e41ed8273fe", // schemaCode 表单编码
  "f452b472-3b31-4914-acb9-de412243fed1", // 业务数据 Id，为空时显示新增数据
  false // checkIsChange：关闭窗口时是否感知数据变化
);

打开弹窗

适用于输入参数等场景。

var schemaCode = "D000183sm4573d2cb67b447b6acab1e41ed8273fe"; // SchemaCode 表单编码参数
var objectId = ""; // BizObjectID 不传时打开新增表单
var params = { "SeasonObjectiveID": "" }; // 传递到表单的参数（JSON 对象格式）
var checkIsChange = false; // 是否检查修改
var showlist = false; // 兼容移动端是否显示列表
var showInModal = true; // 是否在弹窗中显示（若为 false，则 title/height/width/OnShowCallback/OnHiddenCallback 等属性无效）
$.IShowForm( schemaCode, objectId, params, checkIsChange, showlist, {
  showInModal: true, 
  title: "标题", 
  height: 500, 
  width: 800,   
  OnShowCallback: function( data ) { }, 
  onHiddenCallback: function( data ) { 
    //data 只有在弹出窗口点击 提交 按钮 才会把弹出表单窗口的数据传递过来
    // 在点击 x 关闭表单的情况下 data 是没有数据的
    // data 示例
    /*
    {
        "Command": "Submit",
        "DestActivityCode": "",
        "InstanceName": "",
        "Data": {
            "ObjectId": "28f591ba-c225-43b8-a700-c5917be48f32",
            "F0000001": "e29d96c6-60c1-4fb9-b648-1b9ad82c42ad",
            "F0000002": "2026-09-24",
            "F0000006": "01a0751d-8eed-7024-a119-0bcfd69ddf9a",
            "F0000010": "",
            "F0000011": "",
            "F0000033": "1010.0000",
            "F0000034": "212f737a-458f-43f7-b172-dc69e240cfa2",
            "F0000035": "2026-09-21",
            "D29825182b33cd7b1184f92ab27a6833599d412": [],
            "F0000019": "0",
            "F0000017": "0",
            "F0000018": ""
        },
        "Comment": {
            "CommentId": "028680ff-c766-46b0-8be3-c77ce6b53ce6",
            "Text": "确定",
            "IsNewComment": true
        }
    }
    */
  }
}); // OnShowCallback：窗口显示时事件；onHiddenCallback：窗口隐藏时事件

💡 提示
SeasonObjectiveID 参数可在消息提醒的表单中使用 $.IGetParams("key"); 获取数据。
例如：在弹窗表单中编写以下代码可获取参数 SeasonObjectiveID 的值：

// 加载事件
OnLoad: function(){
  // 获取 IShowForm 传递的参数
  const pv = $.IGetParams("SeasonObjectiveID");
  $.IShowTip(pv);
}

Loading提示框

适用于后台执行时间比较长，且需要在前端展示处理状态的的场景，Loading提示框是模态窗口，展示时页面不能再执行操作。

// 提交前事件
BeforeSubmit:function(action, postValue){
    if(action == "btn_t_loading"){
        // 打开Loading框
        $.IShowPreLoader("正在处理中...");
    }
},

// 提交后事件
AfterSubmit:function(action, responseValue){
    if(action == "btn_t_loading"){
        // 隐藏loading框，处理完成或异常一定要调用隐藏
        $.IHidePreLoader();
    }
}