nativeUI

nativeUI管理系统原生界面，可用于弹出系统原生提示对话框窗口、时间日期选择对话框、等待对话框等。

方法：

• actionSheet: 弹出系统选择按钮框
• alert: 弹出系统提示对话框
• confirm: 弹出系统确认对话框
• closeWaiting: 关闭系统等待对话框
• showWaiting: 显示系统等待对话框
• pickDate: 弹出系统日期选择对话框
• pickTime: 弹出系统时间选择对话框
• prompt: 弹出系统输入对话框
• toast: 显示自动消失的提示消息

对象：

• ActionButtonStyle: JSON对象，原生选择按钮框上按钮的样式参数
• ActionSheetStyle: JSON对象，原生选择按钮框的样式参数
• PickDateOption: JSON对象，日期选择对话框的参数
• PickTimeOption: JSON对象，时间选择对话框的参数
• Waiting: 系统等待对话框对象
• WaitingOption: JSON对象，原生等待对话框的参数
• ToastOption: JSON对象，系统提示消息框要设置的参数

回调方法：

• ActionSheetCallback: 系统选择按钮框的回调函数
• AlertCallback: 系统提示框确认的回调函数
• ConfirmCallback: 关闭确认对话框的回调函数
• PromptCallback: 系统输入对话框关闭后的回调函数
• PickDatetimeSuccessCallback: 选择日期或时间操作成功的回调函数
• PickDatetimeErrorCallback: 选择日期或时间操作取消或失败的回调函数

ActionButtonStyle

JSON对象，原生选择按钮框上按钮的样式参数

属性：

• title: (String 类型 )按钮上显示的文字内容
  
• style: (String 类型 )按钮的样式，可取值“destructive”、“default”
  

  “destructive”表示警示按钮样式、“default”表示默认按钮样式，默认为“default”。

ActionSheetStyle

JSON对象，原生选择按钮框的样式参数

属性：

• title: (String 类型 )选择按钮框的标题
  
• cancel: (String 类型 )取消按钮上显示的文字内容
  

  不设置此属性，则不显示取消按钮。

• buttons: (Array[ ActionButtonStyle ] 类型 )选择框上的按钮，ActionButtonStyle对象数组
  

PickDateOption

JSON对象，日期选择对话框的参数

属性：

• title: (String 类型 )日期选择对话框显示的标题
  

  如果未设置标题，则默认显示标题为当前选择的日期。

• date: (Date 类型 )日期选择对话框默认显示的日期
  

  如果未设置默认显示的日期，则显示当前的日期。

• minDate: (Date 类型 )日期选择对话框可选择的最小日期
  

  Date类型对象，如果未设置可选择的最小日期，则使用系统默认可选择的最小日期值。

• maxDate: (Date 类型 )日期选择对话框可选择的最大日期
  

  Date类型对象，如果未设置可选择的最大日期，则使用系统默认可选择的最大日期值。 其值必须大于minDate设置的值，否则使用系统默认可选择的最大日期值。

• popover: (JSON 类型 )时间选择对话框弹出指示区域
  

  JSON类型对象，格式如{top:10;left:10;width:200;height:200;}，所有值为像素值，其值为相对于容器Webview的位置。 如未设置此值，默认在屏幕居中显示。仅在iPad上有效，其它设备忽略此值。

PickTimeOption

JSON对象，时间选择对话框的参数

属性：

• time: (Date 类型 )时间选择对话框默认显示的时间
  

  如果未设置标题，则默认显示标题为当前选择的时间。

• title: (String 类型 )时间选择对话框显示的标题
  

  如果未设置标题，则默认显示标题为当前选择的时间。

• is24Hour: (Boolean 类型 )是否24小时制模式
  

  true表示使用24小时制模式显示，fale表示使用12小时制模式显示，默认值为true。

• popover: (JSON 类型 )日期选择对话框弹出指示区域
  

  JSON类型对象，格式如{top:10;left:10;width:200;height:200;}，所有值为像素值，其值相对于容器webview的位置。 如未设置此值，默认在屏幕居中显示。仅在iPad上有效，其它设备忽略此值。

Waiting

系统等待对话框对象

说明：

可通过plus.nativeUI.showWaiting方法创建，用于控制系统样式等待对话框的操作，如关闭、设置标题内容等。

方法：

• setTitle: 设置等待对话框上显示的文字内容
• close: 关闭显示的系统等待对话框

事件：

• onclose: 等待对话框关闭事件

WaitingOption

JSON对象，原生等待对话框的参数

属性：

• width: (String 类型 )等待框背景区域的宽度
  

  值支持像素值（"500px"）或百分比（"50%"），百分比相对于屏幕的宽计算，如果不设置则根据内容自动计算合适的宽度。

• height: (String 类型 )等待框背景区域的高度
  

  值支持像素绝对值（"500px"）或百分比（"50%"），如果不设置则根据内容自动计算合适的高度。

• color: (String 类型 )等待框中文字的颜色
  

  颜色值支持(参考CSS颜色规范)：颜色名称(参考CSS Color Names)/十六进制值/rgb值/rgba值，默认值为白色。

• textalign: (String 类型 )等待对话框中标题文字的水平对齐方式
  

  对齐方式可选值包括："left"：水平居左对齐显示，"center"：水平居中对齐显示，"right"：水平居右对齐显示。默认值为水平居中对齐显示，即"center"。

• padding: (String 类型 )等待对话框的内边距
  

  值支持像素值（"10px"）和百分比（"5%"），百分比相对于屏幕的宽计算，默认值为"3%"。

• background: (String 类型 )等待对话框显示区域的背景色
  

  背景色的值支持(参考CSS颜色规范)：颜色名称(参考CSS Color Names)/十六进制值/rgb值/rgba值，默认值为rgba(0,0,0,0.8)。

• style: (String 类型 )等待对话框样式
  

  可取值"black"、"white"，black表示等待框为黑色雪花样式，通常在背景主色为浅色时使用；white表示等待框为白色雪花样式，通常在背景主色为深色时使用。 仅在iOS平台有效，其它平台忽略此值，未设置时默认值为white。

• modal: (Boolen 类型 )等待框是否模态显示
  

  模态显示时用户不可操作直到等待对话框关闭，否则用户在等待对话框显示时也可操作下面的内容，未设置时默认为true。

• round: (Number 类型 )等待框显示区域的圆角
  

  值支持像素值（"10px"），未设置时使用默认值"10px"。

• padlock: (Boolen 类型 )点击等待显示区域是否自动关闭
  

  true表示点击等待对话框显示区域时自动关闭，false则不关闭，未设置时默认值为false。

ToastOption

JSON对象，系统提示消息框要设置的参数

属性：

• icon: (String 类型 )提示消息框上显示的图标
  
• duration: (String 类型 )提示消息框显示的时间
  

  可选值为"long"、"short"，值为"long"时显示时间约为3.5s，值为"short"时显示时间约为2s，未设置时默认值为"short"。

• align: (String 类型 )提示消息框在屏幕中的水平位置
  

  可选值为"left"、"center"、"right"，分别为水平居左、居中、居右，未设置时默认值为"center"。

• verticalAlign: (String 类型 )提示消息在屏幕中的垂直位置
  

  可选值为"top"、"center"、"bottom"，分别为垂直居顶、居中、居底，未设置时默认值为"bottom"。

ActionSheetCallback

系统选择按钮框的回调函数

void onActioned( Event event ){
	// actionsheet handled code.
}
				

参数：

• event: ( Event ) 必选 用户操作选择按钮框关闭后返回的数据
  可通过event的index属性（Number类型）获取用户关闭时点击按钮的索引值，索引值从0开始； 0表示用户点击取消按钮，大于0值表示用户点击ActionSheetStyle中buttons属性定义的按钮，索引值从1开始（即1表示点击buttons中定义的第一个按钮）。

返回值：

void : 无

AlertCallback

系统提示框确认的回调函数

void onAlerted(){
	// Alert handled code.
}
				

参数：

无

返回值：

void : 无

ConfirmCallback

关闭确认对话框的回调函数

void onConfirmed( Event event ) {
	// Confirm handled code.
	var index=event.index; // 用户关闭确认对话框点击按钮的索引值
}
				

参数：

• event: ( Event ) 必选 用户操作确认对话框关闭后返回的数据
  可通过event的index属性（Number类型）获取用户关闭确认对话框点击按钮的索引值，索引值从0开始；

返回值：

void : 无

PromptCallback

系统输入对话框关闭后的回调函数

function void onPrompted( Event event ) {
	// Prompt handled code.
	var index=event.index; // 用户关闭输入对话框点击按钮的索引值
	var value=event.value; // 用户输入的内容
}
				

参数：

• event: ( Event ) 必选 用户操作输入对话框关闭后返回的数据
  可通过event的index属性（Number类型）获取用户关闭输入对话框点击按钮的索引值，索引值从0开始； 通过event的value属性（String类型）获取用户输入的内容，如果没有输入则返回空字符串。

返回值：

void : 无

PickDatetimeSuccessCallback

选择日期或时间操作成功的回调函数

function void onPickSuccess( Event event ) {
	// Date picked code.
	var date = event.date;// 用户选择的日期或时间
}
				

参数：

• event: ( Event ) 必选 用户完成选择日期或时间后返回的数据
  可通过event的date属性获取选择的日期或时间值。 若调用的是日期选择操作则仅年、月、日信息有效，若调用的是时间选择操作则仅时、分信息有效。

返回值：

void : 无

PickDatetimeErrorCallback

选择日期或时间操作取消或失败的回调函数

function void onPickError( Exception error ) {
	// Date picked error.
	alert( error.message );
}
				

参数：

• error: ( Exception ) 必选 用户选择操作失败信息
  

返回值：

void : 无