窗口小部件 Widget

WVUIActionSheet.show

显示一个 ActionSheet（显示在屏幕下方的动作列表）。

iOS	Android 效果

输入参数

• [string] title - ActionSheet 的标题。
• [int] _index - ActionSheet 的索引，用于唯一标识该 ActionSheet。
• [array] buttons - ActionSheet 中显示的按钮，每一项都是一个字符串，表示按钮的标题。ActionSheet 最后总是有一个额外的按钮：取消。

回调参数

无回调参数，如果成功显示 ActionSheet，则进入 success 回调，否则进入 failure 回调。

监听事件

wv.actionsheet 用户响应了 ActionSheet。

事件参数：

• [string] type - 用户点击的按钮文本。
• [int] _index - ActionSheet 的索引。

注意：在 iOS 平台下，用户点击取消按钮，或者在 ActionSheet 外点击，都会引发 type: '取消' 的事件；而在 Android 平台下，用户点击取消按钮会引发不含 type 属性的事件，在 ActionSheet 外点击则不会引发任何事件。

document.addEventListener('wv.actionsheet', function(e) {
    alert(JSON.stringify(e.param));
}, false);
var params = {
    // ActionSheet 的标题
    title: 'Choose a button!',
    // ActionSheet 的索引
    _index: 32768,
    // ActionSheet 中显示的按钮
    buttons: ['按钮 1', '按钮 2', '按钮 3', '按钮 4', '按钮 5']
};
window.WindVane.call('WVUIActionSheet', 'show', params, function(e) {
}, function(e) {
    alert('failure: ' + JSON.stringify(e));
});

WVUIDialog.alert

显示一个警告框。

iOS 效果	Android 效果

输入参数

• [string] message - 警告框要显示的消息。
• [string] okbutton - 警告框的确认按钮文本。
• [string] identifier - 警告框的标识符。

监听事件

WV.Event.Alert 用户响应了警告框。

事件参数：

• [string] identifier - 警告框的标识符。

回调参数

无回调参数，如果成功显示警告框，则进入 success 回调，否则进入 failure 回调。

var params = {
    // 警告框要显示的消息
    message: 'Hello World!',
    // 警告框的确认按钮文本
    okbutton: '确 定'
};
window.WindVane.call('WVUIDialog', 'alert', params, function(e) {
}, function(e) {
    alert('failure: ' + JSON.stringify(e));
});

WVUIDialog.confirm

显示一个确认框。

iOS 效果	Android 效果

输入参数

• [string] message - 确认框要显示的消息。
• [string] okbutton - 确认框的确认按钮文本。
• [string] canclebutton - 确认框的取消按钮文本。
• [int] _index - 确认框的索引，用于唯一标识该确认框。

回调参数

无回调参数，如果成功显示警告框，则进入 success 回调，否则进入 failure 回调。

监听事件

wv.dialog 用户响应了确认框。

事件参数：

• [string] type - 用户点击的按钮文本，可能是输入参数中的 okbutton 或 canclebutton。
• [int] _index - 确认框的索引，与输入参数中的 _index 相同。

document.addEventListener('wv.dialog', function(e) {
alert(JSON.stringify(e.param));
}, false);
var params = {
// 确认框要显示的消息
message: 'Are you really really sure?',
// 确认框的确认按钮文本
 okbutton: '确定',
// 确认框的取消按钮文本
canclebutton: '取消',
// 确认框的索引
_index: 10086
};
window.WindVane.call('WVUIDialog', 'confirm', params, function(e) {
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});

WVUI.showLoadingBox

显示一个加载提示框。

iOS 效果	Android 效果

输入参数

无输入参数。

回调参数

无回调参数，如果成功显示加载提示框，则进入 success 回调，否则进入 failure 回调。

window.WindVane.call('WVUI', 'showLoadingBox', {}, function(e) {
}, function(e) {
    alert('failure: ' + JSON.stringify(e));
});

WVUI.hideLoadingBox

隐藏加载提示框。

输入参数

无输入参数。

回调参数

无回调参数，如果成功隐藏警告框，则进入 success 回调，否则进入 failure 回调。

window.WindVane.call('WVUI', 'hideLoadingBox', {}, function(e) {
}, function(e) {
    alert('failure: ' + JSON.stringify(e));
});

WVUIToast.toast

显示一个 Toast（显示在屏幕中央的简单提示）。

iOS 效果	Android 效果

输入参数

• [string] message - Toast 要显示的消息。
• [number] duration - [可选]Toast 的持续时间（秒），默认为 0.8。

回调参数

无回调参数，如果成功显示 Toast，则在 Toast 显示完毕后进入 success 回调；否则进入 failure 回调。

var params = {
    // Toast 要显示的消息
    message: 'Toast information',
    // Toast 的持续时间
    duration: 5
};
window.WindVane.call('WVUIToast', 'toast', params, function(e) {
}, function(e) {
    alert('failure: ' + JSON.stringify(e));
});