Modal对话框

优质

小牛编辑

133浏览

2023-12-01

Modal 是从App的主要内容区域上弹出的一小块内容块,是“临时视图”的一部分。

多个Modal类组件（包括toast）同时被呼起时，会按先后顺序被缓存在队列中，前一个modal关闭后，下一个modal才会打开，Modals 可以只用JavaScript打开。所以让我们来看看使用modals的相关APP方法

首先，让我们看看已经预定义的最常用的modal：

Alert

我们需要调用以下任一一种App方法来打开Alert modal ：$.alert(text, [title, callbackOk])
或者：$.alert(text, [callbackOk])

text - string. Alert文本
title - string. Optional. Alert modal 标题
callbackOk - function. Optional.在Alert modal下，当用户点击“Ok”按钮时，回调函数将被执行。

该方法返回动态创建的modal的HTML元素。

<header class="bar bar-nav">
<h1 class="title">Alert</h1>
</header>
...
<div class="content">
<div class="content-block">
  <p><a href="#" class="alert-text">Alert With Text</a></p>
  <p><a href="#" class="alert-text-title">Alert With Text and Title</a></p>
  <p><a href="#" class="alert-text-title-callback">Alert With Text and Title and Callback</a></p>
  <p><a href="#" class="alert-text-callback">Alert With Text and Callback</a></p>
</div>
</div>
...

$(function(){
 $(document).on('click','.alert-text',function () {
    $.alert('Here goes alert text');
 });

$(document).on('click','.alert-text-title', function () {
    $.alert('Here goes alert text', 'Custom Title!');
});

$(document).on('click', '.alert-text-title-callback',function () {
    $.alert('Here goes alert text', 'Custom Title!', function () {
        $.alert('Button clicked!')
    });
});

$(document).on('click', '.alert-text-callback',function () {
    $.alert('Here goes alert text', function () {
        $.alert('Button clicked!')
    });
});
})

Confirm

Confirm modal 经常在需要确认一些行为时被使用. 打开Alert modal同样也需要调用以下任一一种App方法：$.confirm(text, [title, callbackOk, callbackCancel]) 或者 $.confirm(text, [callbackOk, callbackCancel])

text - string. Confirm 文本
title - string. Optional. Confirm modal 标题
callbackOk - function. Optional. 在 Confirm modal下，当用户点击“Ok”按钮时，回调函数将被执行。(当用户确认操作）
callbackCancel - function. Optional. 在 Confirm modal下，当用户点击“Cancel”按钮时，回调函数将被执行。(当用户不想进行操作)

该方法返回动态创建的modal的HTML元素。

<header class="bar bar-nav">
<h1 class="title">Confirm</h1>
</header>
...
<div class="content">
<div class="content-block">
  <p><a href="#" class="confirm-ok">Confirm with text and Ok callback</a></p>
  <p><a href="#" class="confirm-ok-cancel">Confirm with text, Ok and Cancel callbacks</a></p>
  <p><a href="#" class="confirm-title-ok">Confirm with text, title and Ok callback</a></p>
  <p><a href="#" class="confirm-title-ok-cancel">Confirm with text, title, Ok and Cancel callback</a></p>
</div>
</div>
...

$(document).on('click','.confirm-ok', function () {
  $.confirm('Are you sure?', function () {
      $.alert('You clicked Ok button');
  });
});

$(document).on('click', '.confirm-ok-cancel',function () {
  $.confirm('Are you sure?',
    function () {
      $.alert('You clicked Ok button');
    },
    function () {
      $.alert('You clicked Cancel button');
    }
  );
});
$(document).on('click','.confirm-title-ok', function () {
  $.confirm('Are you sure?', 'Custom Title', function () {
      $.alert('You clicked Ok button');
  });
});
$(document).on('click','.confirm-title-ok-cancel', function () {
  $.confirm('Are you sure?', 'Custom Title',
    function () {
      $.alert('You clicked Ok button');
    },
    function () {
      $.alert('You clicked Cancel button');
    }
  );
});

Prompt

Prompt modal 经常在需要从用户那里得到一些数据/答案时使用。打开 Prompt modal同样也需要调用以下任一一种App方法：$.prompt(text, [title, callbackOk, callbackCancel]) 或者 $.prompt(text, [callbackOk, callbackCancel])

text - string. Prompt 文本/问题
title - string. Optional. Prompt modal 标题
callbackOk - function. Optional. 在 Prompt modal下，当用户点击“Ok”按钮时，回调函数将被执行。回调函数的参数是输入框的值
callbackCancel - function. Optional. 在 Prompt modal下，当用户点击“Cancel”按钮时，回调函数将被执行。回调函数的参数是输入框的值

该方法返回动态创建的modal的HTML元素。

<header class="bar bar-nav">
<h1 class="title">Prompt</h1>
</header>
...
<div class="content">
<div class="content-block">
  <p><a href="#" class="prompt-ok">Prompt with text and Ok callback</a></p>
  <p><a href="#" class="prompt-ok-cancel">Prompt with text, Ok and Cancel callbacks</a></p>
  <p><a href="#" class="prompt-title-ok">Prompt with text, title and Ok callback</a></p>
  <p><a href="#" class="prompt-title-ok-cancel">Prompt with text, title, Ok and Cancel callback</a></p>
</div>
</div>
...

$(document).on('click','.prompt-ok', function () {
  $.prompt('What is your name?', function (value) {
      $.alert('Your name is "' + value + '". You clicked Ok button');
  });
});

$(document).on('click','.prompt-ok-cancel', function () {
  $.prompt('What is your name?',
    function (value) {
      $.alert('Your name is "' + value + '". You clicked Ok button');
    },
    function (value) {
      $.alert('Your name is "' + value + '". You clicked Cancel button');
    }
  );
});
$(document).on('click', '.prompt-title-ok',function () {
  $.prompt('What is your name?', 'Custom Title', function (value) {
      $.alert('Your name is "' + value + '". You clicked Ok button');
  });
});
$(document).on('click', '.prompt-title-ok-cancel',function () {
  $.prompt('What is your name?', 'Custom Title',
    function (value) {
      $.alert('Your name is "' + value + '". You clicked Ok button');
    },
    function (value) {
      $.alert('Your name is "' + value + '". You clicked Cancel button');
    }
  );
});

自定义Modals

Ok, 所有的预定义modals都只是一些适用于特定的场景的方法. 让我们看看如何创建自定义的 modals，$.modal(parameters) - 显示 custom modal，parameters - object. Modal 的 parameters/options对象

该方法返回动态创建的modal的HTML元素。这里有 Modal 的参数列表:

参数	类型	默认值	描述
title	字符串		可选. Modal 标题 (可以是html字符串)
text	字符串		可选. Modal 文本 (可以是html字符串)
afterText	字符串		可选. 将被放在"text"后的文本 (可以是html字符串)
buttons	数组		可选. 按钮数组. 每个按钮应该被表示为带按钮参数的对象 (看下面)
extraClass	字符串		可选. 给modal的根节点`.modal`附加1或多个自定义class(如'bg-red','bg-blue share-type')，方便按需定制不同的modal样式。
verticalButtons	boolean	false	Optional. Set to `true` to enable vertical buttons layout
onClick	函数		可选. 回调函数将在用户点击任何Modal按钮后被触发执行. 它接收 modal (Modal的 HTML元素) 和 index作为参数 (被点击按钮的索引号)

让我们一起来看看按钮参数:

参数	类型	默认值	描述
text	字符串		按钮文本 (可以是 HTML 字符串)
bold	布尔值	false	可选. 设置为true会加粗按钮文本
close	布尔值	true	可选. 如果是“true”，点击这个按钮后modal会被关闭
onClick	函数		可选. 用户点击这个按钮后，回调函数会被执行

这样的配置选项允许我们创建灵活的modals。让我们来看一些例子

<header class="bar bar-nav">
  <h1 class="title">自定义Modals</h1>
</header>
...
<div class="content">
<div class="content-block">
  <p><a href="#" class="open-3-modal">Modal With 3 Buttons</a></p>
  <p><a href="#" class="open-slider-modal">Modal With Slider</a></p>
  <p><a href="#" class="open-tabs-modal">Modal With Tabs</a></p>
  <p><a href="#" class="open-vertical-modal">Modal With Vertical Buttons</a></p>
</div>
</div>
...

$(document).on('click','.open-3-modal', function () {
$.modal({
  title:  'Modal with 3 buttons',
  text: 'Vivamus feugiat diam velit. Maecenas aliquet egestas lacus, eget pretium massa mattis non. Donec volutpat euismod nisl in posuere. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae',
  buttons: [
    {
      text: 'B1',
      onClick: function() {
        $.alert('You clicked first button!')
      }
    },
    {
      text: 'B2',
      onClick: function() {
        $.alert('You clicked second button!')
      }
    },
    {
      text: 'B3',
      bold: true,
      onClick: function() {
        $.alert('You clicked third button!')
      }
    },
  ]
})
});
$(document).on('click','.open-slider-modal', function () {
var modal = $.modal({
  title: 'Awesome Photos?',
  text: 'What do you think about my photos?',
  afterText:  '<div class="swiper-container" style="width: auto; margin:5px -15px -15px">'+
                '<div class="swiper-pagination"></div>'+
                '<div class="swiper-wrapper">'+
                  '<div class="swiper-slide"><img src="..." height="150" style="display:block"></div>' +
                  '<div class="swiper-slide"><img src="..." height="150" style="display:block"></div>'+
                '</div>'+
              '</div>',
  buttons: [
    {
      text: 'Bad :('
    },
    {
      text: 'Awesome!',
      bold: true,
      onClick: function () {
        $.alert('Thanks! I know you like it!')
      }
    },
  ]
})
$.swiper($(modal).find('.swiper-container'), {pagination: '.swiper-pagination'});
});

$(document).on('click','.open-tabs-modal', function () {
$.modal({
  title:  '<div class="buttons-row">'+
            '<a href="#tab1" class="button active tab-link">Tab 1</a>'+
            '<a href="#tab2" class="button tab-link">Tab 2</a>'+
          '</div>',
  text: '<div class="tabs">'+
          '<div class="tab active" id="tab1">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam convallis nunc non dolor euismod feugiat. Sed at sapien nisl. Ut et tincidunt metus. Suspendisse nec risus vel sapien placerat tincidunt. Nunc pulvinar urna tortor.</div>'+
          '<div class="tab" id="tab2">Vivamus feugiat diam velit. Maecenas aliquet egestas lacus, eget pretium massa mattis non. Donec volutpat euismod nisl in posuere. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae</div>'+
        '</div>',
  buttons: [
    {
      text: 'Ok, got it',
      bold: true
    },
  ]
})
});

$(document).on('click','.open-vertical-modal', function () {
$.modal({
  title:  'Vertical Buttons Layout',
  text: 'Vivamus feugiat diam velit. Maecenas aliquet egestas lacus, eget pretium massa mattis non. Donec volutpat euismod nisl in posuere. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae',
  verticalButtons: true,
  buttons: [
    {
      text: 'Button 1',
      onClick: function() {
        $.alert('You clicked first button!')
      }
    },
    {
      text: 'Button 2',
      onClick: function() {
        $.alert('You clicked second button!')
      }
    },
    {
      text: 'Button 3',
      onClick: function() {
        $.alert('You clicked third button!')
      }
    },
  ]
})
});

用 JavaScript 关闭 Modals

任何 Modal 可以用 JavaScript 来关闭，不仅仅是通过点击按钮。因此我们需要看看相关App方法，$.closeModal(modal) - 关闭任意 modal，modal - HTMLElement or string ( CSS 选择器). 可选. 除了指定的，任何被打开modal都将被关闭。