弹窗组件

1.McrbHttpClient.popup.msg()提示弹窗

描述:常用于主动操作后的反馈提示(如:「成功、失败、提示」等),居中显示,2 秒后自动消失。

基础用法:McrbHttpClient.popup.msg(content, {icon:1});

参数说明:

参数说明类型可选值
content消息文字string文字内容
icon图标Number默认null;(1:成功提示,2:错误或警告提示,3:蓝色提示,4:橙色提示,5:绿色提示)

应用代码实例:

//使用方法:可在当前页面的js中使用下面的方法

 

McrbHttpClient.popup.msg('操作中断!')

 

McrbHttpClient.popup.msg('操作成功!',{icon:1})

 

McrbHttpClient.popup.msg('操作失败!',{icon:2})

 

McrbHttpClient.popup.msg('操作成功!',{icon:3})

 

McrbHttpClient.popup.msg('操作失败!',{icon:4})

 

McrbHttpClient.popup.msg('操作成功!',{icon:5})

效果展示(如下图):

2.McrbHttpClient.popup.confirm()询问弹窗

描述:提示用户确认其已经触发的动作,并询问是否进行此操作时会用到此对话框,居中显示,提示询问是否进行操作“确定”或者“取消”。

基础用法:McrbHttpClient.popup.confirm(options1, options2, ,cb1,cb2)

参数说明:

参数说明类型可选值
options1.title标题string——
options1.content消息文字string——
options1.icon图标Number1:成功提示,2:错误或警告提示,3:蓝色提示,4:橙色提示,5:绿色提示
options1.hideBtnClose是否隐藏关闭按钮Booleantrue隐藏,false显示
options2.btn按钮文字array设置两个按钮的文字提示
cb1回调函数Function点击第一个按钮后回调函数
cb2回调函数Function点击第二个按钮后回调函数

极简版(纯文本),实例如下:

McrbHttpClient.popup.confirm('确定要删除吗?');

基础版(文本+图标),实例如下:

McrbHttpClient.popup.confirm({ title: '提示语', content: '确定要删除吗?', icon:2 })

 

// 参数说明:
icon图标(int):1:成功提示,2:错误或警告提示,3:蓝色提示,4:橙色提示,5:绿色提示;
title标题(String)
content文本内容(String)

进阶版(文本+图标+自定义回调函数),实例如下:

McrbHttpClient.popup.confirm({ title: '提示', content: '请问确定要删除吗?', icon:2 }, { btn: ['删除' ,'取消'] }, function(){ alert('ok') },function(){ alert('no') });

 

// 参数说明:
icon图标(int):1:成功提示,2:错误或警告提示,3:蓝色提示,4:橙色提示,5:绿色提示;
title标题(String)
content文本内容(String)
支持自定义两个默认按钮的文字显示(如:btn: ['删除' ,'取消'])
支持自定义点击两个按钮后的后续响应,即最后两个参数function

3.McrbHttpClient.popup.prompt()输入框弹窗

描述:当用户进行操作时会被触发,中断用户操作,提示用户进行输入的对话框,居中显示,提示用户进行输入操作然后提交。

基础用法:McrbHttpClient.popup.prompt(text,keyname,cb1,cb2)

参数说明:

参数说明类型可选值
text输入内容文字提示string必填
keyname输入框input的name值string必填
cb1点击“提交”后回调函数Function非必填
cb2点击“取消”后回调函数Function非必填

极简版,实例如下:

McrbHttpClient.popup.prompt("请输入你的名字","Keafmd")

 

// 参数说明:
参数1输入内容的文字提示
参数2设置输入框input的name值

基础版(配置“提交”触发回调函数),实例如下:

McrbHttpClient.popup.prompt("请输入你的名字","Keafmd",function(e){ console.log(e); McrbHttpClient.popup.msg('您提交的数据:'+e) })

 

// 参数说明:
参数1输入内容的文字提示
参数2设置输入框input的name值
如需设置输入操作后点击‘提交’后的后续响应事件,设置第三个参数回调函数

进阶版(提交+取消及其点击后的回调函数),实例如下:

McrbHttpClient.popup.prompt("请输入你的名字","Keafmd",function(e){ console.log(e); McrbHttpClient.popup.msg('您提交的数据:'+e); },function(e){ console.log(e); McrbHttpClient.popup.msg('您未完成提交'); });

 

// 参数说明:
参数1输入内容的文字提示
参数2设置输入框input的name值
参数3配置点击“提交”后的回调函数
参数4配置“取消”按钮及其点击后的回调函数

4.McrbHttpClient.popup.alert()确认语弹窗

描述:当用户进行操作时会被触发,该对话框中断用户操作,居中显示,直到用户确认知晓后才可关闭。

基础用法:McrbHttpClient.popup.alert(options)

参数说明(options内部字段):

参数说明类型可选值
title标题string——
content消息文字string——
icon图标Number1:成功提示,2:错误或警告提示,3:蓝色提示,4:橙色提示,5:绿色提示
hideBtnClose是否隐藏关闭按钮Booleantrue隐藏,false显示
callback回调函数function——

极简版(纯文本),实例如下:

McrbHttpClient.popup.alert('操作成功')

基础版(标题+图标+自定义回调函数),实例如下:

McrbHttpClient.popup.alert({ title: '敬请期待!', icon:3 })

 

McrbHttpClient.popup.alert({ title: '敬请期待!', icon:3, callback:function(){ console.log('pppp'); } })

 

// 参数说明:
title: (string)标题内容
icon: (int)图标类型(1:成功提示,2:错误或警告提示,3:蓝色提示,4:橙色提示,5:绿色提示)
callback: (function)点击按钮后的回调函数

进阶版(标题+描述+图标+自定义回调函数),实例如下:

McrbHttpClient.popup.alert({title: '审核通过!', content: '您申请的信息已通过审核!', icon:1 })

 

McrbHttpClient.popup.alert({title: '审核未通过!', content: '您申请的信息未通过审核!', icon:2, callback:function(){ console.log('pppp'); } })

 

// 参数说明:
title: (string)标题内容
content: (string)描述内容
icon: (int)图标类型(1:成功提示,2:错误或警告提示,3:蓝色提示,4:橙色提示,5:绿色提示)
callback: (function)点击按钮后的回调函数

5.McrbHttpClient.popup.open()打开自定义html窗体

描述:当用户进行操作时会被触发,中断用户操作,默认居中显示,弹出自定义html内容直到用户触发相应事件触发关闭。

基础用法:McrbHttpClient.popup.open(content,title,id,options)

参数说明:

参数说明类型可选值
content自定义html内容——自定义内容的dom元素
title标题string必填
id弹窗idstring必填
options.position弹出初始位置String选填(默认center)center居中,left-top左上角,left-bottom左下角,right-top右上角,right-bottom右下角
options.isdrag是否可拖拽String选填(默认0)0:不可拖动,1:可拖动

基础版,实例如下:

// 自定义html窗体内容
<table id="opendiv">
    <tr>
        <td>参数</td>
        <td>说明</td>
        <td>类型</td>
        <td>可选值</td>
    </tr>
    <tr>
        <td>title</td>
        <td>标题</td>
        <td>string</td>
        <td>非必填</td>
    </tr>
    <tr>
        <td>content</td>
        <td>自定义html内容</td>
        <td>——</td>
        <td>自定义内容的dom元素</td>
    </tr>
</table>

// 创建自定义窗体
var title = "标题";
var content = document.getElementById('opendiv');
var options = {
    position:'right-bottom',
   isdrag:1,
}
McrbHttpClient.popup.open(content,title,'msid',options);

进阶版,实例如下:

// 自定义html窗体内容
<table id="opendiv">
    <tr>
        <td>参数</td>
        <td>说明</td>
        <td>类型</td>
        <td>可选值</td>
    </tr>
    <tr>
        <td>title</td>
        <td>标题</td>
        <td>string</td>
        <td>非必填</td>
    </tr>
    <tr>
        <td>content</td>
        <td>自定义html内容</td>
        <td>——</td>
        <td>自定义内容的dom元素</td>
    </tr>
</table>

// 打开自定义html窗体
var title = "标题";
var content = document.getElementById('opendiv');
McrbHttpClient.popup.open(content,title,'ccid');
$('#opendiv').click(function(){
    var content2 = document.createElement('div');
    content2.innerText = '222222';
    content2.onclick = function(e){
        var content3 = document.createElement('div');
        content3.innerText = '333333';
        content3.onclick = function(e){
             McrbHttpClient.popup.alert('tttttt');
        }
        McrbHttpClient.popup.open(content3,    'ee','ccid3');
    }
    McrbHttpClient.popup.open(content2,'','ccid2');
});

 

6.McrbHttpClient.popup.ifream()打开ifream 嵌套页面窗体

基础用法:McrbHttpClient.popup.ifream(url, t, w, h)

参数说明:

url:(string)嵌套路径;
t:(string)设置窗体标题;
w:(string)设置窗体宽度;
h:(string)设置窗体高度

基础版,实例如下:

var url = 'http://manager.ixiera.com/issue/main?sys_filter=assignee_mine';

 

McrbHttpClient.popup.ifream(url, 'ifream标题', '500px', '500px')

 

7.McrbHttpClient.popup.notice()打开通知提醒窗体

基础用法:McrbHttpClient.popup.notice(type, icon, t, d)

参数说明:

type:(int)类型(1:成功消息,2:错误消息,3:提示消息,4:警告消息);
icon:(Boolean)图标是否显示(true显示,false不显示);
t:(string)标题;
d:(string)描述;

McrbHttpClient.popup.notice(1, true, '通知提醒', '描述描内容')

 

McrbHttpClient.popup.notice(2, true, '通知提醒')

 

McrbHttpClient.popup.notice(3, false, '通知提醒', '描述描内容')

 

McrbHttpClient.popup.notice(4, false, '通知提醒')

 

8.McrbHttpClient.popup.close()关闭弹窗

共用弹窗关闭方法:McrbHttpClient.popup.close(id)

参数说明:
参数id选填,不传参数时关闭所有弹窗,传入id时关闭指定id的弹窗

9.McrbHttpClient.popup.formWin()表单弹窗

基础用法:McrbHttpClient.popup.formWin(opts)

参数说明(opts):

参数说明类型可选值
winId弹窗idstring默认值:'popup_form_' + Date.now();
title弹窗标题文本string默认值:表单窗体
titleColor弹窗标题颜色string默认值:#333333
titlebgColor弹窗标题背景色string默认值:#ffffff
width弹窗尺寸宽度String默认值:400px
bgColor弹窗背景色String默认值:#ffffff
isDrag弹窗是否可拖拽String( 1 可 / 0 不可),默认值:1
formItems表单项配置数组Array默认[](配置参考:与3.8表单组件form.render 入参完全一致)
initData表单回显键值对象object默认{}(配置参考:与3.8表单组件form.setValues入参完全一致)
behavior.showSubBtn是否显示提交按钮boolean默认:false
behavior.onSubmit提交回调(showSubBtn:true才生效)Function默认null
behavior.showDelBtn是否显示删除按钮boolean默认:false
behavior.onDelete删除回调 (showDelBtn:true才生效)Function默认null
behavior.customBtnList自定义按钮数组Array默认[](格式如:[{text:"导出", callback:(e)=>{}}])

自定义按钮返回值e{object}说明:

属性说明类型
winId窗体元素idstring
instance表单对象实例(McrbHttpClient.form() 返回的对象)object
close快捷关闭 functionFunction
initData表单初始赋值object
formData表单当前值object

formWin 返回值(控制器对象)方便外部持有 winId 时随时读写表单:

const formCtrl = McrbHttpClient.popup.formWin({ winId: 'form-Firereport', ... });

// 控制器方法一览
formCtrl.winId;                     // 当前弹窗 id
formCtrl.getFormInstance();         // 取表单实例
formCtrl.getValue('lng');           // 取单个字段值
formCtrl.getValues();               // 取全部字段值(对象)
formCtrl.setValue('lng', 116.4);    // 设置单个字段值
formCtrl.setValues({lng:116.4, lat:39.9}); // 批量赋值
formCtrl.close();                   // 关闭当前弹窗

外部读写表单(popup 全局 API)

方法说明返回
McrbHttpClient.popup.getFormInstance(winId)获取表单实例formIns | null
McrbHttpClient.popup.getFormInstance(winId)获取全部字段值object | null
McrbHttpClient.popup.getFormValue(winId, name)获取单个字段值any
McrbHttpClient.popup.getFormValue(name)同上(自动取最近打开的 formWin)any
McrbHttpClient.popup.setFormValue(winId, name, value)设置单个字段值boolean
McrbHttpClient.popup.setFormValue(name, value)同上(自动取最近打开的 formWinboolean
McrbHttpClient.popup.setFormValues(winId, dataObj)批量赋值boolean
McrbHttpClient.popup.setFormValues(dataObj)同上(自动取最近打开的 formWin)boolean

不传 winId 的简写形式,只会作用于最近一次打开的 formWin。同页面同时打开多个 formWin 时请显式传 winId。

实例如下:

McrbHttpClient.popup.setFormValue('form-pop', 'skill1','2');
McrbHttpClient.popup.getFormValues('form-pop');

基础版,实例如下:

// 基础表单 - 红色标题

McrbHttpClient.popup.formWin({
  title: '用户表单',
  titleColor: '#fff',
  titlebgColor: 'red',
  initData: {uname: '张三',phone: '13800001111',skill: 1},
  formItems: [
    { type: 'input', name: 'uname', label: '用户名', required: true, placeholder: '请输入' },
    { type: 'input', name: 'phone', label: '手机号', required: true, verify: 'phone', placeholder: '请输入' },
    { type: "checkbox", name: "skill", label: "技能", checkboxList: [
      {id: "1", value: 1, text: "射击", checked: true},
      {id: "2", value: 2, text: "游泳"},
      {id: "3", value: 3, text: "骑马"},
    ]},
  ],
  behavior: {
    showSubBtn: true,
    onSubmit: function(e) {
      console.log('======================触发提交事件,关闭窗体', e);
    }
  }
});

 

// 说明:
1.点击提交,有默认的确认弹窗是否提交;
2.提交回调函数中返回值e:当前表单中的数据值
3.自动关闭窗体
// 重要参数说明:
formItems表单项配置数组,默认[](配置参考:与3.8表单组件form.render 入参完全一致)
initData表单回显键值对象,默认{}(配置参考:与3.8表单组件form.setValues入参完全一致)

 

进阶版(自定义按钮),实例如下:

// 基础表单 - 蓝色标题 + 自定义按钮

McrbHttpClient.popup.formWin({   
  winId: 'form-pop',
  titleColor: '#fff',
  titlebgColor: 'blue',
  initData: {uname: '张三',phone: '13800001111',skill1: 1},
  formItems: [
    { type: 'input', name: 'uname', label: '用户名', required: true, placeholder: '请输入',help: '<button type="button" style="padding:0 10px" onclick="getVal()">点击查看帮助</button>' },
    { type: 'input', name: 'phone', label: '手机号', required: true, verify: 'phone', placeholder: '请输入' },
    { type: "checkbox", name: "skill", label: "技能", checkboxList: [
      {id: "1", value: 1, text: "射击", checked: true},
      {id: "2", value: 2, text: "游泳"},
      {id: "3", value: 3, text: "骑马"},
    ]},
  ],
  behavior: {
    customBtnList: [
      {
        text: '导出数据',
        className: 'auto-style',
        callback: function (e) {
          console.log('========执行导出数据', e);
          e.close();
        }
      },
      {
        text: '过滤数据',
        className: 'auto-style',
        callback: function (e) {
          console.log('========执行过滤数据', e);
        }
      }
    ]
  }
});

function getVal(){
    console.log('==========获取表单数据', McrbHttpClient.popup.getFormValues('form-pop'));
    McrbHttpClient.popup.setFormValues({uname: '李四',phone: '13822222222',skill1: 2,profession:2, skill2: '1,2'})
 }

/// 重要参数说明:
formItems表单项配置数组,默认[](配置参考:与3.8表单组件form.render 入参完全一致)
initData表单回显键值对象,默认{}(配置参考:与3.8表单组件form.setValues入参完全一致)
customBtnList自定义按钮数组,默认[](格式如:[{text:"导出", callback:(e)=>{}}])
自定义按钮返回值e{object}说明:
  winId窗体元素id
  instance配置项设置
  close快捷关闭function
  initData 表单初始赋值
  formData表单当前值

 

线上demo地址:

https://mhc.ixiera.com/html/componentDemo/demo_zj_popup.html

10.McrbHttpClient.popup.detailWin()详情弹窗

基础用法:McrbHttpClient.popup.detailWin(opts)

参数说明(opts):

参数说明类型可选值
winId弹窗idstring默认值:'popup_detail_' + Date.now();
title弹窗标题文本string默认值:表单窗体
titleColor弹窗标题颜色string默认值:#333333
titlebgColor弹窗标题背景色string默认值:#ffffff
width弹窗尺寸宽度String默认值:400px
bgColor弹窗背景色String默认值:#ffffff
isDrag弹窗是否可拖拽String( 1 可 / 0 不可),默认值:1
Layout详情内容基础排版配置object(选填)默认值{
labelWidth: '100px',// 文字描述宽度
labelAlign: 'right',// 文字描述对齐方式
itemPadding: '10px 12px',// 内间距
fontSize: '14px',// 字体大小
borderColor: '#f0f0f0',// 边框线颜色,当showBorder: true时起作用
showBorder: true // 是否显示底边框
},
dataItems详情内容配置object默认[],标准键值对数据项(name=字段名,value=值,label=文字描述)
behavior.customBtnList自定义按钮数组Array默认[](格式如:[{text:"导出", callback:(e)=>{}}])

自定义按钮返回值e{object}说明:

winId:窗体元素id
close:快捷关闭function
dataItems:详情数据内容

基础版,实例如下:

// 基础 - 蓝色标题

McrbHttpClient.popup.detailWin({
  title: '订单综合详情',
  titleColor: '#ffffff',
  titlebgColor: '#1890ff',
  dataItems: [
    {name: 'ddcode', value: 'DD20260608001', label: '订单编号'},
    {name: 'shuser', value: '李四', label: '收货人'},
    {name: 'zfstatus', value: '已付款', label: '支付状态'},
    {name: 'tkyuanyin', value: '商品存在轻微划痕,希望换货...', label: '退款原因说明'},
    {name: 'cutstatus', value: 'active', label: '当前状态',
      render: function(val) {
        return `● 正常营业`;
      },
    },
  ],
});

 

// 重要参数说明:
dataItems详情内容配置,默认[],标准键值对数据项(name=字段名,value=值,label=文字描述)

 

进阶版,实例如下:

// 基础 - 红色标题

McrbHttpClient.popup.detailWin({
  title: '订单综合详情',
  width: '550px',
  titleColor: '#ffffff',
  titlebgColor: '#e60404',
  // 标准键值对数据项(name=字段名,value=值,label=文字描述)
  dataItems: [
    {name: 'ddcode', value: 'DD20260608001', label: '订单编号'},
    {name: 'shuser', value: '李四', label: '收货人'},
    // 支持灵活配置:针对某一行实现“强调/高亮背景色”或“去除底边框”
    {name: 'zfstatus', value: '已付款', label: '支付状态', style: 'background-color: #f6ffed; border-radius: 4px;', showBorder: false},
    // 支持灵活配置:针对某一行配置className
    {name: 'tkyuanyin', value: '用户填写的详细退款理由:商品存在轻微划痕,希望换货处理...', label: '退款原因说明', className: 'kkk123',},
    // 支持灵活配置:自定义渲染函数返回 HTML 或 DOM
    {name: 'cutstatus', value: 'active', label: '当前状态',
      render: function(val) {
        return `● 正常营业`;
      },
    },
  ],
  // 自定义按钮行为配置
  behavior: {
    customBtnList: [
      {
        text: '导出详细档案',
        className: 'export-btn',
        callback: function (e) {
          console.log('========执行导出当前详情档案逻辑', e);
          // 快捷关闭窗体
          e.close();
        }
      },
    ]
  }
});

 

// 重要参数说明:
dataItems详情内容配置,默认[],标准键值对数据项(name=字段名,value=值,label=文字描述)
customBtnList: [] 自定义按钮数组 [{text:"关闭", className:"", callback:(e)=>{}}]
自定义按钮返回值e{object}说明:
  winId窗体元素id
  close快捷关闭function
  dataItems详情数据内容

 

线上demo地址:

https://mhc.ixiera.com/html/componentDemo/demo_zj_popup.html

11.McrbHttpClient.popup.listWin()列表弹窗

基础用法:McrbHttpClient.popup.listWin(opts)

参数说明(opts):

参数说明类型可选值
winId弹窗idstring默认值:'popup_list_' + Date.now();
title弹窗标题文本string默认值:表单窗体
titleColor弹窗标题颜色string默认值:#333333
titlebgColor弹窗标题背景色string默认值:#ffffff
width弹窗尺寸宽度String默认值:400px
bgColor弹窗背景色String默认值:#ffffff
isDrag弹窗是否可拖拽String( 1 可 / 0 不可),默认值:1
tableOptions列表列配置数组Array默认[](参考3.9表格table组件中columns配置)
enablePagination是否启用分页booleantrue启用|false关闭分页展示全部,默认true
pageOptions分页配置对象Object(参考3.10分页组件配置)
initData初始化表格数据数组Array默认[](参考3.9表格组件中dataSource)
onPageChange分页切换回调函数functionfunction(curPage, start, end) {}
behavior.showCloseBtn是否显示关闭按钮boolean默认false(仅当customBtnList=[]时此配置才起作用)
behavior.customBtnList自定义按钮数组Array默认[](格式如:[{text:"导出", callback:(e)=>{}}])

带分页的列表,实例如下:

// 基础列表 - 绿色标题 - 分页

McrbHttpClient.popup.listWin({
  width: '700px',
  titleColor: '#ffffff',
  titlebgColor: '#52c41a',
  listMaxHeight: '500px',
  tableOptions: tableColumns,
  initData: initialTableData,
  pageOptions: {
    totalCount: tableData.length,
  },
  onPageChange: function(curPage, start, end, listIns) {
    console.log(`正在请求第 ${curPage} 页数据,区间:${start} - ${end}`);
    // 模拟异步请求成功后,调用 listIns.tableupdata(newData) 动态更新表格
    setTimeout(() => {
      const mockNewData = tableData.slice(start, end)
      listIns.tableupdata(mockNewData);
    }, 300);
  },
});

 

// 重要参数说明:
tableOptions列表列配置数组,默认[](参考3.9表格table组件中columns配置)
enablePagination是否启用分页,true启用|false关闭分页展示全部,默认true
pageOptions分页配置对象(参考3.10分页组件配置)
initData初始化表格数据数组,默认[](参考3.9表格组件中dataSource)
onPageChange分页切换回调函数 function(curPage, start, end) {}

 

没分页列表 + 自定义按钮,实例如下:

// 基础列表 - 橘色标题 - 没分页 + 自定义按钮

McrbHttpClient.popup.listWin({
  width: '700px',
  titleColor: '#ffffff',
  titlebgColor: '#FF9800',
  listMaxHeight: '500px',
  tableOptions: tableColumns,
  initData: tableData,
  enablePagination: false,
  behavior: {
    showCloseBtn:true,
    customBtnList: [
      {
        text: '返回',
        className: 'cancel-btn',
        callback: function(e) {
          console.log('===========================',e)
          McrbHttpClient.popup.close(e.winId);
        }
      }
    ]
  }
});

 

// 重要参数说明:
tableOptions列表列配置数组,默认[](参考3.9表格table组件中columns配置)
initData初始化表格数据数组,默认[](参考3.9表格组件中dataSource)
customBtnList: []自定义按钮数组 [{text:"关闭", className:"", callback:(e)=>{}}]
自定义按钮返回值e{object}说明:
winId窗体元素id
Instance列表对象

 

线上demo地址:

https://mhc.ixiera.com/html/componentDemo/demo_zj_popup.html

 

 

本文档来自—microbee-http 丨 软件开发框架平台