ActionSheet

ActionSheet é a folha de ações estilo iOS: um cartão arredondado ancorado na base da tela com uma lista de botões de opção e um botão Cancelar separado abaixo. Quando há opções demais para caber, elas se distribuem em múltiplas colunas (até maxColumns). Atrás da folha há um “scrim” cinza (fullscreenColor = 0xD0DDDDDD) que dá o efeito modal.

🟢 · Pacote: dev.crossfly.ui · Estende: Window · Estilo: ComponentStyle/WindowStyle

Quando usar

Menu de ações contextuais sobre um item (compartilhar, renomear, excluir…).
Quando quiser destacar visualmente uma ação destrutiva (vermelho), como no padrão iOS.

Quando NÃO usar

Escolha sim/não simples ou confirmação com mensagem → use Alert.
Feedback passivo/efêmero → use Hint.

Aparência

Cartão inferior de largura ~92% da tela com as opções empilhadas, separadas por linhas finas, e o botão Cancelar totalmente arredondado logo abaixo. O fundo da tela fica coberto por um scrim cinza.

Exemplo completo (copiar, colar e rodar)

package com.exemplo;

import dev.crossfly.ui.*;
import dev.crossfly.ui.layout.*;

/** Tela principal executável. Aponte o launcher (classname) e rode: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      Button abrir = new Button("Abrir folha de ações");
      abrir.onAction(c ->
      {
         ActionSheet sheet = new ActionSheet("Cancelar", "Compartilhar", "Renomear", "Excluir");
         sheet.buttonAction(0, origin -> { sheet.hide(); Hint.show("Compartilhar", 2000); });
         sheet.buttonAction(1, origin -> { sheet.hide(); Hint.show("Renomear", 2000); });
         sheet.buttonAction(2, origin -> { sheet.hide(); Hint.show("Excluído", 2000); });
         // Ação destrutiva em vermelho
         sheet.buttonStyle(2, ActionSheet.createDefaultButtonStyle().textColor(0xFFFF0000));
         sheet.show();
      });
      add(LAY_AUTO, abrir);
   }
}

Os trechos abaixo mostram só o miolo (o que vai dentro de onShow()). Para rodar, coloque-os no esqueleto MainWindow acima.

Uso básico

ActionSheet sheet = new ActionSheet("Cancelar", "Compartilhar", "Renomear", "Excluir");
sheet.buttonAction(0, origin -> { compartilhar(); sheet.hide(); });
sheet.buttonAction(1, origin -> { renomear();     sheet.hide(); });
sheet.buttonAction(2, origin -> { excluir();      sheet.hide(); });
sheet.show();

Construtores

Construtor	Descrição
`ActionSheet(String cancelText, String... buttonTexts)`	`cancelText` (default `"Cancel"`) e os textos das opções (vazio/`null` → `{"OK"}`).

Propriedades e personalização

Propriedade / método	Tipo	Padrão	O que faz
`buttonStyle(ComponentStyle)`	fluente	skin	Estilo default de todas as opções.
`buttonStyle(int index, ComponentStyle)`	fluente	—	Override de estilo de uma opção específica.
`buttonStyle(int index)`	`ComponentStyle`	—	Estilo resolvido da opção.
`cancelStyle(ComponentStyle)`	fluente	skin	Estilo do botão Cancelar.
`containerStyle(ComponentStyle)`	fluente	skin	Estilo do cartão (raio das bordas).
`maxColumns(int)`	fluente	`1`	Máximo de colunas em overflow (>=1).
`getButton(int)` / `getCancelButton()`	`Button`	—	Botões após `show()`/`onAdd`.
`createDefaultButtonStyle()` / `createDefaultCancelStyle()` / `createDefaultContainerStyle()`	`ComponentStyle` (static)	—	Fábricas dos estilos default.

Callbacks e eventos

Callback	Quando dispara
`buttonAction(int index, Component.Action action)`	ao tocar a opção `index` (0-based).
`cancelAction(Component.Action action)`	ao tocar o botão Cancelar.

Como ActionSheet estende Window (não Picker), a resposta vem por esses callbacks, não por show(onAnswer). Não há getAnswer(). O lambda de Component.Action é void run(Component origin) — não retorne valor.

Estados

Opção sem callback → recebe a ação default hide() (fecha a folha).
Opção com callback → executa o callback; se ele não chamar hide(), a folha permanece aberta.
Tap no scrim (fora da folha) ou back → fecha quando canHide está ativo (default).

Destacar a ação destrutiva e permitir 2 colunas

ActionSheet sheet = new ActionSheet("Cancelar", "Compartilhar", "Renomear", "Excluir");

sheet.buttonAction(0, origin -> { compartilhar(); sheet.hide(); });
sheet.buttonAction(1, origin -> { renomear();     sheet.hide(); });
sheet.buttonAction(2, origin -> { excluir();      sheet.hide(); });

// Opção destrutiva em vermelho
sheet.buttonStyle(2, ActionSheet.createDefaultButtonStyle().textColor(0xFFFF0000));

// Permitir até 2 colunas se houver muitas opções
sheet.maxColumns(2);

sheet.show();

Boas práticas

Use para um conjunto de ações contextuais; para sim/não simples, prefira Alert.
Destaque ações destrutivas com buttonStyle(index, ...) em vermelho.
Em listas longas, configure maxColumns para a folha não ultrapassar a tela.

Erros comuns

Callback sem hide() — a folha fica aberta; o hide() automático só ocorre quando não há callback registrado.
Fazer o lambda retornar valor — Component.Action.run(...) é void.
Acessar getButton(i) antes de show() — os botões são criados em onAdd.

Veja também

Guia da área: ui/ · Receitas: cookbook/
Componentes relacionados: Alert · Hint