KlugDialog

Visão geral

O alerta embutido do AIR no Mac parece vindo de outra década. O KlugDialog mostra o original: sheets de alerta nativas do macOS ligadas à janela do seu app, com o ícone do app, a fonte do sistema e os estilos de botão conhecidos.

Além dos alertas simples, ele cobre o que os apps de desktop precisam todo dia: diálogos com campos de texto (por exemplo nome de usuário e senha, também como campos seguros), vários botões com estilos próprios e uma sheet de progresso ("Conectando…") que o seu código atualiza e fecha quando o trabalho termina.

Tudo é assíncrono: show() retorna imediatamente, e o seu callback recebe o botão escolhido. O KlugDialog roda na versão para Mac de nossos apps, nossa prova de conceito.

Novo no Android: os mesmos diálogos como diálogos nativos do Android. Os campos de texto ficam acima do teclado em todas as telas, também em paisagem nos tablets, onde os botões antes sumiam atrás dele; senhas, nomes de usuário e endereços de e-mail nunca são capitalizados automaticamente, e os campos de e-mail recebem o teclado de e-mail. A versão Android também empilha listas longas de botões, oferece um spinner simples e roda na versão Android de nossos apps.

Também no iOS: desde a versão 1.2, a mesma API mostra alertas nativos do iOS, diálogos com campos de texto e um diálogo de progresso, de modo que um único caminho de código atende Android, iOS e macOS.

Recursos

• Autossuficiente: uma ANE, sem biblioteca principal nem ANEs de dependência para adicionar
• Sheets de alerta nativas do macOS com até três botões
• Estilos informativo, de aviso e crítico
• Diálogos com qualquer número de botões e campos de texto, incluindo campos seguros
• Sheet de progresso que pode ser atualizada e fechada pelo código
• Os diálogos podem ser fechados pelo código
• Callbacks com o botão escolhido e os valores digitados
• Android: campos acima do teclado, senhas sem capitalização automática, teclados de e-mail / numérico, tema claro e escuro

Plataformas compatíveis

Em outras plataformas, isSupported retorna false, para que o seu app possa recorrer aos diálogos habituais.

Primeiros passos

Adicione a extensão ao descritor do seu aplicativo:

<extensions>
    <extensionID>com.klug.dialog.Dialog</extensionID>
</extensions>

Exemplos de código

Cinco fluxos completos. Cada chamada retorna imediatamente; o resultado chega depois no seu callback, então o app nunca trava enquanto um diálogo está aberto. Documentação completa →

import com.klug.dialog.Dialog;

var dialog:Dialog = Dialog.getInstance();

if ( dialog.isSupported )
{
    dialog.show( "Saved", "The recording is in your library." );   // one "OK" button
}
else
{
    showAppAlert( "Saved" );   // your app's own fallback dialog, e.g. on Windows
}

dialog.show( "Delete recording?", "This cannot be undone.",
    [ "Delete", "Keep" ],
    function( index:int ):void
    {
        // index = position in the buttons array;
        // -1 = closed without a button, e.g. the Android back key
        if ( index == 0 ) deleteRecording();   // your app
    },
    Dialog.STYLE_WARNING );   // alert style of the macOS sheet

var buttons:Array = [
    { label:"Cancel",  style:4, tag:0 },   // style 4 = cancel, 3 = destructive
    { label:"Sign in", style:0, tag:1 }
];
var fields:Array = [
    { placeholder:"E-mail", text:lastEmail, keyboardType:7 },   // 7 = e-mail keyboard
    { placeholder:"Password", secure:true }                 // never auto-capitalised
];

dialog.present( "Sign in", "Please enter your account.", true, buttons, fields,
    function( tag:int, values:Array, cancelled:Boolean = false ):void
    {
        if ( cancelled ) return;   // closed without a button (tag -1)
        if ( tag == 1 ) signIn( values[0], values[1] );   // values in field order
    },
    null, "dark" );   // theme on Android and iOS; macOS follows the system

// your own id: the same dialog is updated and closed with it
dialog.progressShow( "connect", "Connecting", "Contacting the server…", false,
    function():void { trace( "progress dialog closed" ); } );   // fires once

dialog.progressUpdate( "connect", "Signing in…" );

// when the work is done, or has failed
dialog.progressDismiss( "connect" );

// pass your own id as the 7th parameter to close the dialog later
dialog.present( "Waiting for the camera", "Tap Cancel to stop waiting.", false,
    [ { label:"Cancel", style:4, tag:0 } ], null,
    function( tag:int, values:Array ):void { stopWaiting(); },   // your app
    "waitCamera" );

// the camera has answered: close the dialog, no callback fires
dialog.presentDismiss( "waitCamera" );

Visão geral da API

Compre o KlugDialog

Uma licença anual para um app AIR, com todas as atualizações por 12 meses. Após o pagamento, você recebe a extensão, a biblioteca ActionScript e a documentação por e-mail, normalmente em até um dia útil. Licença e termos

Requisitos