TerryZ / Bdialog

bDialog

A multi-layer nested, highly customizable powerful dialog plugin,
dialog type including modal dialog, alert dialog, mask layer, toast dialog

Guide, Demos and Documents

Explorer on

• English site
• 中文官网

简体中文文档

The Vuejs version: v-dialogs

If you think this project is helpful, please star it.

Features

• jQuery plugin, on Bootstrap Modal plugin basis to extend
• multi-layer Nested modal dialog
• alert mode dialog provide info、warning、error、success、confirm types
• mask layer block all element when data loading
• toast dialog, provide info、warning、error、success types and 6 corner position
• flexible style setting
• when browser size changes, the dialog will automatically repositioned to the center of the browser
• dialog area outside the click, the window automatically positioning and other scenes have a corresponding reminder animation

The Alert Dialog Icon

the icons in alert dialog used are made by Elegant Themes and control icon, toast icon used are come from IconFont

Plugin Preview

Modal Mode

Alert Mode

Mask Mode

Toast Mode

Install

download bDialog plugin zip file by last release, or Click me to download bDialog

or use NPM

npm i bdialog

Usage

As you can see in the Demo page, you will need to include:

• jQuery library (1.6.0+), untest on jquery2.x & 3.x
• The JavaScript file b.dialog.js (or its minified version b.dialog.min.js)
• The css file b.dialog.bootstrap3.css for bootstrap3.x , b.dialog.css for bootstrap2.x

Including files

<!-- include for Bootstrap2.x -->
<link rel="stylesheet" href="b.dialog.css" type="text/css">
<!-- include for Bootstrap3.x -->
<link rel="stylesheet" href="b.dialog.bootstrap3.css" type="text/css">
<!-- Above the css file under your css framework choose one of them to include -->
 
 
<!-- jquery-ui draggable liabrary if you need dialog drag function -->
<script type="text/javascript" src="jquery-ui.min.js" >< /script>

<script type="text/javascript" src="b.dialog.js" >< /script>

Open a Modal dialog

bDialog.open({
    title : 'User Info Modify',
    width : 500,
    height : 450,
    url : 'http://aa.com/load',
    params : {
        'userName' : 'Bryant'
    },
    callback:function(data){
        if(data && data.results && data.results.length > 0 ){
            bDialog.alert('已完成弹出窗口操作！<br>接收到弹出窗口传回的 userName 参数，值为：<b>' + 
            data.results[0].userName + '</b>');
        }else{
            bDialog.alert('弹出窗口未回传参数',$.noop,{
              messageType : 'error'
            });
        }
    }
});

Quick Demo

//Modal :
bDialog.open({
  url : 'http://some url'
});
bDialog.open({
  dom : $('#some element').html()
});

//Alert :
bDialog.alert('your message');
bDialog.alert('your message',function(){
  //your callback
});

//Mask :
bDialog.mask();

//Toast :
bDialog.toast('your message');
bDialog.toast('your message',{
  //toast dialog type
  messageType : 'warning',
  //show dialog in topleft position
  position : 'topLeft',
  //don't show close button
  dialogCloseButton : false,
  //auto close dialog time(second),default 3s
  closeTime : 0
});

Options

• backdrop string | boolean
  default : 'static'
  the dialog backdrop layer set

  • 'static' : click the backdrop can not close the dialog
  • false : do not show backdrop
  • true : show backdrop, but click the backdrop will close dialog

• title string | boolean
  default : '对话框'
  set text to show in title bar,set false to close the title bar

• language string
  default : 'cn'
  dialog using language

• width number
  default : 700
  dialog width, only work on modal dialog mode

• height number
  default : 400
  dialog height, only work on modal dialog mode

• animation boolean
  default : true
  whether show animation when dialog open

• dialogCloseButton boolean
  default : true
  whether show the 'X' close button

• dialogMaxButton boolean
  default : true
  whether show maximize button

• closeButton boolean
  default : false
  whether to close dialog bottom bar, only work in Modal dialog mode

• scroll boolean
  default : true
  whether to display the scroll bar

• drag boolean
  default : true
  whether to allow the window to be dragged

  the drag function is depend on jquery-ui draggable liabrary,if not include it, drag function will auto close

• url string
  default : false
  the remote page url open in modal dialog

• params object
  default : undefined
  pass the parameters to the new open modal dialog, in the new modal dialog you can get parameters like this

  var params = bDialog.getDialogParams();
  

  example

  params : {
    name : 'Michael',
    num : 23
  }
  

• dom object
  default : undefined
  the html element or javascript object or jquery object to show in modal dialog

• fullWidth boolean
  default : false
  whether to show full width modal dialog

• customClass string
  default : undefined
   specify custom style class name

• show boolean
  default : false whether show dialog when dialog init finish

• onShow function
  default : undefined
  before dialog show callback

• onShowed function
  default : undefined
  when the dialog has been made visible to call this callback

• onHide function
  default : undefined
  before dialog close callback

• onHidden function
  default : undefined
  when dialog completely close callback

• callback function
  default : undefined
   when dialog close callback, this callback different from others callback its can be return data to caller.
  param
  data object return to caller data
  example

  {
    callback : function(data){
      if(data && data.results && data.results.length > 0 ){
        $('#input').val(data.results[0]);
      }
    }
  }
  //the param data is come from 
  bDialog.close('i am return data');
  

• messageType string
  default : 'info'
  setup alert dialog, toast dialog type, the full type is

  • info(default)
  • warning
  • error
  • success
  • confirm(only work on alert dialog)

  the different type will show different icon

• position string
  default : 'bottomRight'
  toast dialog display position, the full position is

  • topLeft
  • topCenter
  • topRight
  • bottomLeft
  • bottomCenter
  • bottomRight(default)

• closeTime number
  default : 3(second)
   auto close toast dialog time, set 0 to disabled auto close dialog

• cancel function
  default : undefined
  when alert dialog mode, and alert type is confirm, this callback is used to the cancel button callback
  example

  cancel : function(dialog){
    bDialog.alert('The deal was canceled');
  }
  

API

• open
  open a modal dialog
  param
  • params example

  bDialog.open({
    url : 'http://someurl'
  });
  //so simple to open a remote page in modal dialog
  

• close
  close opened dialog (modal, alert, mask)
  param
  • data object return to caller data
  • [dialog] object optional to set, if you have a opened dialog object,you can directly to it. if no setup this param, plugin will close the last open dialog example

  bDialog.close({name:'Michael',num:23});//close and return data(last open dialog)
  
  var dlg = bDialog.open({...});
  $('#theBtn').click(function(){
    bDialog.close({name:'Michael',num:23},dlg);
  });
  

• getDialog
  get last opened dialog (modal, alert, mask)

  var dlg = bDialog.getDialog();
  

• getDialogParams
  get params data from open dialog params

  bDialog.open({
    params : {
      name : 'Michael',
      num : 23
    }
  });
  

  in the opened modal dialog, you can get params like this

  var params = bDialog.getDialogParams();
  $('#name').val(params.name);
  

• alert
  open a message alert dialog, the alert dialog can be info, warning, error, success, confirm types param
  • message string the message show in alert dialog
  • callback function close alert dialog callback
  • params object setup alert dialog params

  bDialog.alert('a am info message');//just show message
  
  bDialog.alert('a am info message',function(){
    $('#name').val('');
  });//show message and do something when alert dialog close
  
  bDialog.alert('a am info message',function(){
    $('#name').val('');
  },{
    messageType : 'confirm',//open confirm alert dialog
    cancel : function(){
      $('#name').val('my default name');
    }
  });//show message, callback,and setup init params
  

• mask
  param
  • message
  • params

  bDialog.mask();//show a block every element layer and default prompt message
  
  bDialog.mark('please wait for a moment...');//show a mask and custom text
  

• toast
  param
  • message
  • params

  //show a corner toast dialog, default position on bottomRight
  bDialog.toast('your message');
  bDialog.toast('your message',{
    //toast dialog type
    messageType : 'warning',
    //show dialog in topleft position
    position : 'topLeft',
    //don't show close button
    dialogCloseButton : false,
    //auto close dialog time(second),default 3s
    closeTime : 0
  });