SuperApp：對話方塊

WVUIDialog.alert

顯示一個警告框。

輸入參數

• [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

顯示一個確認框。

輸入參數

• [string] message：確認框要顯示的訊息。

• [string] okbutton：確認框的確認按鈕文本。

• [string] cancelbutton：確認框的取消按鈕文本。

• [int] _index：確認框的索引，用於唯一標識該確認框。

回調參數

無回調參數，如果成功顯示警告框，則進入success回調，否則進入failure 回調。

監聽事件

wv.dialog 使用者響應了確認框。

事件參數：

• [string]type：使用者點擊的按鈕文本，可能是輸入參數中的okbutton或cancelbutton。

• [int] _index：確認框的索引，輸入參數中的_index相同。

document.addEventListener('wv.dialog', function(e) {
alert(JSON.stringify(e.param));
}, false);

var params = {
// 確認框要顯示的訊息
message: 'Are you really really sure?',
// 確認框的確認按鈕文本
 okbutton: '確定',
// 確認框的取消按鈕文本
cancelbutton: '取消',
// 確認框的索引
_index: 10086
};
window.WindVane.call('WVUIDialog', 'confirm', params, function(e) {
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});

WVUIDialog.enableAlertBeforeUnload

開啟小程式頁面返回詢問對話方塊，開啟後當使用者使用返回鍵嘗試關閉小程式頁面時，會彈出"是否確認離開"的對話方塊。

輸入參數

• [string] message：可選，對話方塊中顯示的訊息內容，如果不傳入則預設內容是“離開此頁面？”。

回調參數

成功回調參數：

• 無參數。

失敗回調參數：

• [string] msg：錯誤訊息。

var params = {
    // 對話方塊內容
    message: '確認離開此頁面嗎',
};

window.WindVane.call('WVUIDialog', 'enableAlertBeforeUnload', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVUIDialog.disableAlertBeforeUnload

關閉小程式頁面返回詢問對話方塊。

輸入參數

• 無輸入參數。

回調參數

成功回調參數：

• 無參數。

失敗回調參數：

• [string] msg：錯誤訊息。

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

WVUIDialog.prompt

彈出一個對話方塊，讓使用者在對話方塊內輸入文本。

輸入參數

• [string] title：可選，prompt對話方塊標題。

• [string] message：prompt對話方塊提示文本。預設為"請輸入內容"。

• [string] hint：可選，輸入框內的提示文案。

• [string] okbutton：確認框的確認按鈕文本。可選，預設是"確定"。

• [string] cancelbutton：確認框的取消按鈕文本。可選，預設是"取消"。

回調參數

成功回調參數：

• [boolean] ok：點擊ok返回true, 點擊cancel返回false 。

• [string] inputValue： 當ok返回true時，返回使用者輸入的內容。

失敗回調參數：

• [string] msg：錯誤訊息。

var params = {
  	    title: '提示框'
        message: '請輸入xxx內容',
  		  hint: '請輸入xxx內容'
        okbutton: '確定',
  		  cancelbutton: '取消'
};
window.WindVane.call('WVUIDialog', 'prompt', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVUIDialog.showAuthGuide

通過許可權引導模組以圖文形式向使用者彈出對話，引導使用者開啟相應的許可權。

輸入參數

• [string] permission： 許可權文案，如"照相機"、"通訊錄"等。

• [string] okbutton：確認按鈕的文案。

• [string] jumpToSettings：點擊okbutton後是否跳轉至系統應用詳情頁面，"0"不跳轉，"1"跳轉，預設是"0"，可選。

回調參數

成功回調參數：

• 無參數。

失敗回調參數：

• [string] msg：錯誤訊息。

var params = {
  	    permission: '通訊錄'
  		  cancelbutton: '取消',
  		  okbutton:'確認'
};
window.WindVane.call('WVUIDialog', 'showAuthGuide', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVUIDatePicker.show

顯示一個日期選取器，可以設定預設選擇日期，未設定則預設當天。

輸入參數：

• [string] year：預設選擇的年份。

• [string] month：預設選擇的月份。

• [string] dayOfMonth：預設選擇的日期。

• [string] minYear：可選擇的最小年份。

• [string] minMonth：可選擇的最小月份。

• [string] minDayOfMonth：可選擇的最小日期。

• [string] maxYear：可選擇的最大年份。

• [string] maxMonth：可選擇的最大月份。

• [string] maxDayOfMonth：可選擇的最大日期。

回調參數：

回調參數將會在回調方法中傳遞，如果成功擷取，則進入success回調，否則進入failure回調。

• [string] year：選擇的年份。

• [string] month：選擇的月份。

• [string] dayOfMonth：選擇的日期。

var params = {
  	    year: 2022,
  		  month: 11,
  			dayOfMonth: 15
};
window.WindVane.call('WVUIDatePicker', 'show', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});