このトピックでは、WVUIActionSheet の JavaScript API について説明します。 HTML5 アプリまたはミニアプリを作成する際に、このトピックを参照できます。 WVUIActionSheet の JavaScript API を使用して、操作シートを表示できます。
WVUIActionSheet.show
操作シート(シートの下部に表示されるボタンのリスト)を表示します。
iOS デバイスでの効果 | Android デバイスでの効果 |
|
|
入力パラメーター
[
string]title:操作シートのタイトル。[
int]index:操作シートのインデックス。インデックスは、操作シートを一意に識別するために使用されます。[
array]buttons:操作シートに表示されるボタンの配列。配列の各項目は文字列で、ボタンのタイトルを示します。操作シートは常に追加のボタン(キャンセル ボタン)で終了します。
コールバック パラメーター
コールバック パラメーターはありません。操作シートが表示された場合は、success コールバックが呼び出されます。それ以外の場合は、failure コールバックが呼び出されます。
イベント リスニング
wv.actionsheet イベントは、操作シートに応答することを示します。
イベント パラメーター:
[
string]type:タップしたボタンのテキスト。[
int]_index:操作シートのインデックス。
iOS デバイスで [キャンセル] ボタンをタップするか、操作シート UI の外側をタップすると、type が cancel のイベントがトリガーされます。
Android デバイスで [キャンセル] ボタンをタップすると、
typeプロパティを含まないイベントがトリガーされます。 Android デバイスで操作シート UI の外側をタップしても、イベントはトリガーされません。
document.addEventListener('wv.actionsheet', function(e) {
alert(JSON.stringify(e.param));
}, false);
var params = {
// 操作シートのタイトル
title: 'ボタンを選択してください!',
// 操作シートのインデックス
_index: 32768,
// 操作シートに表示されるボタン
buttons: ['ボタン 1', 'ボタン 2', 'ボタン 3', 'ボタン 4', 'ボタン 5']
};
window.WindVane.call('WVUIActionSheet', 'show', params, function(e) {
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});

