SuperApp:WVBase

APIs JavaScript da classe WVBase. Use estas APIs para copiar texto para a área de transferência, defina a cor de fundo da WebView, verifique se aplicativos estão instalados e confirme o suporte a APIs na versão atual do SDK.

WVBase.copyToClipboard

Copia texto para a área de transferência.

Parâmetros de entrada

• [string] text: O texto a copiar.

Parâmetros de callback

Não há retorno de parâmetros de callback. O callback success é invocado quando o texto é copiado com êxito; caso contrário, o callback failure é acionado.

var params = {
        text: "text to copy"
};
window.WindVane.call('WVBase', 'copyToClipboard', params, function(e) {
        alert('success' + JSON.stringify(e));
}, function(e) {
        alert('failure' + JSON.stringify(e));
});

WVBase.isInstall

Verifica se um aplicativo específico está instalado.

Parâmetros de entrada

• [string] ios: O identificador do aplicativo para iOS — a URL scheme. Por exemplo, 'taobao://'.

• [string] android: O identificador do aplicativo para Android — o package name. Por exemplo, 'com.taobao.taobao'.

Parâmetros de callback

Não há retorno de parâmetros de callback. O callback success é invocado se o aplicativo estiver instalado; caso contrário, o callback failure é acionado.

var params = {
        // The app identifier for iOS.
        ios: 'taobao://',
        // The app identifier for Android.
        android: 'com.taobao.taobao'
};
window.WindVane.call('WVBase', 'isInstall', params, function(e) {
        alert('success');
}, function(e) {
        alert('failure');
});

WVBase.isAppsInstalled

Verifica se vários aplicativos estão instalados.

Parâmetros de entrada

• [object] Um objeto que mapeia nomes exclusivos de aplicativos (como taobao) para objetos com as seguintes propriedades:

  • [string] ios: O identificador do aplicativo para iOS — a URL scheme. Por exemplo, 'taobao://'.

  • [string] android: O identificador do aplicativo para Android — o package name. Por exemplo, 'com.taobao.taobao'.

Parâmetros de callback

O callback success recebe um objeto com os resultados. O callback failure é invocado em caso de erro.

• [object] Um objeto que mapeia cada nome de aplicativo de entrada para um valor booleano: true se o aplicativo estiver instalado, false caso contrário.

var params = {
        taobao: {
                ios: 'taobao://',
                android: 'com.taobao.taobao'
        },
        tmall: {
                ios: 'tmall://',
                android: 'com.tmall.tmall'
        }
};
window.WindVane.call('WVBase', 'isAppsInstalled', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVBase.notify

Dispara um event personalizado no objeto document com os parâmetros especificados.

Parâmetros de entrada

• [string] event: O nome do evento a disparar.

• [object] param: O objeto a passar com o evento.

Parâmetros de callback

Este método não invoca os callbacks success ou failure e não retorna parâmetros de callback.

Escuta de eventos

O nome do evento é especificado por event, e os dados do evento correspondem ao objeto definido por param.

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

var params = {
        // The name of the event to trigger.
        event: 'MyNotifyName',
        // The parameters for the event.
        param: { MyEventParam: 'paramValue' }
};
window.WindVane.call('WVBase', 'notify', params);

WVBase.openBrowser

Abre uma url em uma nova janela do Safari.

Parâmetros de entrada

• [string] url: A url a abrir no Safari.

Parâmetros de callback

Não há retorno de parâmetros de callback. O callback success é invocado quando a url é aberta com êxito; caso contrário, o callback failure é acionado.

var params = {
        // The URL to display in the browser.
        url: 'http://www.baidu.com'
};
window.WindVane.call('WVBase', 'openBrowser', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVBase.setBackgroundColor

Defina a cor de fundo da WebView.

Parâmetros de entrada

• [string] color: O hexadecimal color code para a background color da WebView. Aceita o prefixo 0x ou #.

• [number] alpha: Opcional. A opacity do fundo da WebView. Aceita valores de 0 a 1.

Parâmetros de callback

Não há retorno de parâmetros de callback. O callback success é invocado em caso de êxito; caso contrário, o callback failure é acionado.

var params = {
        color: 'FF0000',
        alpha: 0.3
};
window.WindVane.call('WVBase', 'setBackgroundColor', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVBase.canIUse

Verifique se uma api ou método específico é compatível com a versão atual do SDK.

Parâmetros de entrada

• [string] api: O nome da classe da api, como WVBase ou WVMotion.

• [string] method: Opcional. O nome do método dentro da classe da api, como isWindVaneSDK ou copyToClipboard. Se omitido, apenas a disponibilidade da classe da api é verificada.

Parâmetros de callback

• [boolean] canUse: true se a api ou método especificado for compatível; false caso contrário.

var params = {
        api: 'WVMotion',
        method: 'vibrate'
};
window.WindVane.call('WVBase', 'canIUse', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVMiniApp.close

Fecha o miniaplicativo.

Parâmetros de entrada

Nenhum.

Parâmetros de callback

Nenhum.

window.WindVane.call('WVMiniApp', 'close', {}, function(e) {
  			alert('success');
}, function(e) {
  			alert('failure');
});