• modal
  • API
    • toast
      • toast(options)
  • alert
    • alert(options, callback)
  • confirm
    • confirm(options, callback)
  • prompt
    • prompt(options, callback)

    modal

    modal 模块提供了以下展示消息框的 API:toastalertconfirmprompt

    API

    toast

    toast() 会在一个小浮层里展示关于某个操作的简单反馈。例如,在邮件发送前离开邮件编辑界面,可以触发一个“草稿已保存”的 toast,告知用户以后可以继续编辑。toast 会在显示一段时间之后自动消失。

    toast(options)

    • @options
      • message, string, 展示的内容.
      • duration, number, 持续时间(以秒为单位)
    • Android: 如果时间长度大于3s,将使用一个被称为LONG的系统变量,否则使用SHORT这个系统变量
    • iOS: 持续的时间与duration相同
    1. var modal = weex.requireModule('modal')
    2. modal.toast({
    3. message: 'This is a toast',
    4. duration: 0.3
    5. })

    alert

    警告框经常用于确保用户可以得到某些信息。当警告框出现后,用户需要点击确定按钮才能继续进行操作。

    alert(options, callback)

    • @options
      • message, string,警告框内显示的文字信息
      • okTitle, string,确认按钮上显示的文字信息
    • @callback, function,用户操作完成后的回调
    1. var modal = weex.requireModule('modal')
    2. modal.alert({
    3. message: 'This is a alert',
    4. okTitle: '确认'
    5. }, function () {
    6. console.log('alert callback')
    7. })

    confirm

    确认框用于使用户可以验证或者接受某些信息。当确认框出现后,用户需要点击确定或者取消按钮才能继续进行操作。

    confirm(options, callback)

    • @options
      • message, string,警告框内显示的文字信息
      • okTitle, string,确认按钮上显示的文字信息
      • cancelTitle, string,取消按钮上显示的文字信息
    • @callback, function,用户操作完成后的回调,参数是按下按钮上的文字信息
      • result, string, 用户按下的按钮文字信息
    1. var modal = weex.requireModule('modal')
    2. modal.confirm({
    3. message: 'Do you confirm ?',
    4. duration: 0.3
    5. }, function (value) {
    6. console.log('confirm callback', value)
    7. })

    prompt

    提示框经常用于提示用户在进入页面前输入某个值。当提示框出现后,用户需要输入某个值,然后点击确认或取消按钮才能继续操作。

    prompt(options, callback)

    • @options
      • message, string,警告框内显示的文字信息
      • okTitle, string,确认按钮上显示的文字信息
      • cancelTitle, string,取消按钮上显示的文字信息
    • @callback, function,用户操作完成后的回调
      • res.result:用户按下的按钮上的文字信息
      • res.data:用户输入的文字信息
    1. var modal = weex.requireModule('modal')
    2. modal.prompt({
    3. message: 'This is a prompt',
    4. duration: 0.3
    5. }, function (value) {
    6. console.log('prompt callback', value)
    7. })

    示例