Pop-ups e diálogos

Escolha o popup certo

Um popup interrompe. Antes de escolher um, responda a uma única pergunta: o jogador precisa responder antes de o jogo continuar? Se sim, bloqueie. Se não, nunca bloqueie — um cartão que para o jogo por uma notícia que o jogador não pediu é o jeito mais rápido de fazê-lo fechar o seu jogo.

1. Uma pergunta com resposta — comprar, apagar, sair, sobrescrever → GoDialogs.confirm(). Algo que o jogador só precisa ver e confirmar → alert(). Uma entre poucas opções → choose().
2. Uma tela própria — configurações, uma ficha de personagem, um item da loja → GoSurface no meio da tela.
3. Uma lista longa ou uma página de gerenciamento — a mochila, o correio, os amigos → GoSheet vindo de baixo no celular, GoDrawer vindo do lado em uma tela larga.
4. Algo sobre o que acabou de ser tocado — os atributos de um item, as ações dele → GoPopover ou GoContextMenu ao lado.
5. Notícias com as quais o jogo pode seguir — salvo, descartado, convidado → GoSnackbar, GoNotice ou GoPromptCard. Eles nunca tomam a tela.
6. Ensinar os controles → GoCoachMark. Cheats enquanto você desenvolve → GoConsole.

Todos os popups de relance

Em qual camada cada um abre, e por que nessa ordem, está em Camadas, Voltar e entrada.

Todas as imagens desta página são o mesmo joguinho — vida e mana no canto superior esquerdo, moedas no superior direito, um joystick e três slots rápidos embaixo — em default_dark, com um popup aberto por cima. O mesmo diálogo nos catorze visuais →

Anatomia de um popup

Quase todo popup que bloqueia no gohud — diálogos, folhas, popovers, a lista do combobox e as suas próprias janelas — é um mesmo nó, GoSurface. Aprenda as partes dele uma vez e você conhece todos.

Diálogos que você aguarda com await

GoDialogs pergunta e espera. Um nó, três perguntas — e a resposta volta na mesma linha, então o código se lê na ordem em que o jogador vive a cena.

var dialogs := GoDialogs.new()
add_child(dialogs)

if await dialogs.confirm("Buy the starter pack?", "300 gems for a sword, a shield and 10 potions.",
        "Buy", "Not now"):
    buy_starter_pack()

As três perguntas

confirm(title, body, ok_text := "", cancel_text := "", extra := "",
        args := {}, destructive := false) -> bool
alert(title, body, ok_text := "", extra := "", args := {})      # use await para esperar
choose(title, options: Array, cancel_text := "", translate := false) -> int
confirm_key(…) · alert_key(…)                                 # chaves de tradução

Rótulos de botão vazios usam as palavras do próprio kit (confirm, cancel em GoConfig.text_keys). extra é acrescentado ao corpo em uma nova linha. args preenche os {placeholders} do título e do corpo: confirm("Buy {item}?", "It costs {price} gold.", "Buy", "", "", {"item": name, "price": 300}).

Toda saída tem uma resposta

Então o código depois do await sempre roda — nenhuma resposta fica pendurada, nem quando a cena muda por baixo do diálogo.

Ações destrutivas

Passe destructive = true para algo que não pode ser desfeito. O botão OK vira o botão preenchido Tone.DANGER_SOLID — branco sobre vermelho em todo visual, enquanto um rótulo de perigo apenas tonalizado teria de escurecer até quase preto em um tema claro para continuar legível. O tom é redefinido a cada chamada, porque a janela é reaproveitada.

if await dialogs.confirm("Delete this save?", "Slot 2 — Aria, level 12. This cannot be undone.",
        "Delete", "Keep it", "", {}, true):
    delete_save(2)

Arranjo dos botões

action_gap é o espaço entre os botões, body_gap o espaço acima deles — deixe-o maior que o espaço entre os botões para que a pergunta e a escolha se leiam como duas partes. Para um diálogo só, chame set_next_action_layout() antes de abri-lo. O único botão de um alert sempre ocupa a largura toda.

Um de cada vez

Um segundo confirm() enquanto outro está aberto devolve false na hora — um diálogo nunca se empilha sobre outro por acidente. Ligue queue_when_busy e ele passa a esperar a vez dele; alert() sempre espera. queue_limit (8) limita a fila e, quando ela estoura, o pedido mais antigo recebe false. pending() conta os pedidos em espera e clear_pending() responde false a todos eles. choose() nunca entra na fila: devolve -1 quando já há um diálogo aberto.

Celular e desktop

choose() abre como uma folha vinda de baixo no Android e no iOS — onde o polegar está — e como um cartão no meio da tela no desktop. Uma confirmação é limitada a max_width (420dp) e centralizada. Defina layer_index, max_width e os outros exports antes do add_child; eles são aplicados quando o nó entra na árvore.

var picked := await dialogs.choose("Sort the bag by", [
    {"text": "Newest first", "icon": GoIconSet.CLOCK},
    {"text": "Rarity", "icon": GoIconSet.STAR},
    {"text": "Drop everything", "icon": GoIconSet.TRASH, "danger": true}])
if picked >= 0:
    sort_bag(picked)

GoSurface — uma janela sua

Quando um popup é mais do que uma pergunta — configurações, uma ficha de personagem, um item para comprar —, construa-o sobre o GoSurface. Área segura, teclado, linhas fixas, rolagem, Voltar, foco e redimensionamento já estão resolvidos.

var layer := CanvasLayer.new()
layer.layer = 50
add_child(layer)

var window := GoSurface.new()
window.set_title("Settings")
window.close_requested.connect(layer.queue_free)
window.body.add_child(GoStyle.toggle("Music", false))
window.body.add_child(GoStyle.slider(0.0, 1.0, 0.05))
var row := GoStyle.row()
row.add_child(GoStyle.button("Cancel", window.request_close))
row.add_child(GoStyle.button("Save", save_and_close, GoStyle.Tone.PRIMARY))
window.footer.add_child(row)
window.footer.visible = true
layer.add_child(window)

Três posicionamentos

ANCHOR precisa de anchor_control. O cartão vai para a direita dele se anchor_min_width couber; senão, para o lado mais largo; senão, para dentro da tela, e abre para cima quando há mais espaço acima. Ele acompanha uma âncora em movimento a cada frame. anchor_width (320) e anchor_max_height (520) definem o tamanho.

Até que tamanho ele chega

Uma proporção acima do teto é cortada, com um único aviso numa build de debug. O teclado empurra o cartão para cima e rola o campo em foco até ele aparecer; a área segura o mantém longe do notch e da barra de gestos no Android e no iOS.

Propriedades

Sinais e chamadas

Folhas e painéis laterais

Uma lista que precisa de espaço sobe de baixo em um celular na vertical — onde o polegar está — e entra pelo lado em um tablet ou desktop, onde uma folha cobriria o jogo.

GoSheet — páginas vindas de baixo

var sheet := GoSheet.new()
add_child(sheet)

func show_bag(items: Array) -> void:
    sheet.open("Bag")
    var search := GoStyle.line_edit("Search the bag…")
    search.text_changed.connect(filter_bag)
    sheet.toolbar().add_child(search)
    sheet.toolbar().visible = true
    for item in items:
        sheet.body.add_child(GoStyle.list_button(GoIconSet.BOX, item.name, show_item.bind(item),
            Color.TRANSPARENT, item.description, false, GoIconSet.CHEVRON_RIGHT))
    sheet.add_footer(GoStyle.button("Close", sheet.close, GoStyle.Tone.PRIMARY))

• É um CanvasLayer (camada 10) que contém um GoSurface BOTTOM redimensionável — então fica acima do HUD, e o jogador pode arrastá-lo para deixá-lo mais alto.
• open(title) começa uma página nova: limpa o corpo, a barra de ferramentas e o botão de voltar e libera o que o add_footer() acrescentou. Chame de novo para mostrar outra página na mesma folha; set_back() mostra um botão de voltar para o caminho de volta. open_key() recebe uma chave de tradução.
• close() a esconde — ela não é liberada, então o próximo open() é instantâneo. closed e page_changed avisam quando isso acontece.
• height_ratio (0.6) é a altura com que ela abre; max_height_ratio sobe o teto; dismissable (true) a fecha com um toque no véu.

GoDrawer — pelo lado

var drawer := GoDrawer.new()
drawer.side = GoDrawer.Side.LEFT
drawer.follow_text_direction = true      # o lado de início: esquerda, ou direita em árabe
add_child(drawer)
drawer.body.add_child(GoNavBar.drawer_list([{"icon": GoIconSet.HOME, "text": "Town"},
    {"icon": GoIconSet.MAP, "text": "World map"}], 0, go_to))
drawer.open("Menu")

• Camada 80. 42% da largura da tela (width_ratio), entre min_width (320dp) e max_width (420dp) — num celular ele cobre a maior parte da tela, e é por isso que ali uma folha é a melhor escolha.
• O painel chega até a borda da tela; só o conteúdo dele recua para dentro da área segura, então um canto arredondado nunca corta a primeira linha.
• LEFT significa esquerda da tela até em árabe. Ligue follow_text_direction quando o que importa é "o lado de início"; effective_side() diz para onde ele foi.
• open(title) mantém o corpo — preencha-o uma vez só. set_title("") esconde o cabeçalho. motion_seconds (0.2) controla o deslize; reduce_motion o torna instantâneo.

Cartões e menus ao lado de um controle

O que o jogador acabou de tocar merece uma resposta bem ao lado do dedo, não no meio da tela.

GoPopover — um cartão sobre o que foi tocado

slot.pressed.connect(func() -> void:
    var card := GoStyle.item_card({"icon": GoIconSet.POTION, "title": "Health potion",
        "subtitle": "Heals 50 HP · 12 left"}, false)
    GoPopover.open(slot, card, {"width": 280}))

Uma superfície ANCHOR com a camada, a âncora e o desmonte já ligados — as dez linhas que todo jogo escreve de novo e de novo. Um de cada vez: abrir um segundo fecha o primeiro, porque cartões empilhados soterram a tela e ninguém consegue dizer qual pertence a qual slot. O véu é transparente — um cartão aberto para comparar equipamentos não pode escurecer os equipamentos —, mas ainda pega o primeiro toque de fora, que fecha o cartão e não vai adiante.

GoPopover.close() e GoPopover.is_open() são estáticos. open() devolve a superfície — ou null quando a âncora não está na árvore, então confira antes de fazer await shown.close_requested.

GoContextMenu — toque longo e clique direito

var menu := [
    {"text": "Use", "icon": GoIconSet.POTION, "action": use},
    {"separator": true},
    {"text": "Drop", "icon": GoIconSet.TRASH, "action": drop, "danger": true}]
GoContextMenu.attach(slot, menu)

var more := GoStyle.icon_button(GoIconSet.MORE, Callable(), -1, &"more")
more.pressed.connect(func() -> void: GoContextMenu.open_at(more, menu))

• Um clique direito o abre na hora. Um dedo pressionado por meio segundo (HOLD_SECONDS) o abre; mover mais de 12dp cancela — então rolar uma lista nunca abre um menu.
• Um item é {text, action, icon, disabled, checked, separator, danger, translate}. Passe um Callable em vez do array quando os itens dependem do que foi tocado; ele é chamado toda vez que o menu abre.
• danger coloca "⚠ " antes do texto — o menu da engine só consegue colorir todos os itens de uma vez.
• É o PopupMenu da engine, vestido pelo GoStyle.style_popup(). Ele não conta como superfície aberta.

Listas suspensas, seletores e o botão dividido

var sort := GoStyle.dropdown("Sort", ["Highest score", "Most wins", {"text": "Friends only", "disabled": true}],
    func(index: int) -> void: sort_board(index))
var quality := GoStyle.select(["Low", "Medium", "High", "Ultra"], "Quality")
quality.item_selected.connect(func(index: int) -> void: settings.quality = index)
var send := GoSplitButton.make("Send", send_now, ["Send later", "Save as draft"])

Os três abrem o menu popup da engine: dropdown() é um MenuButton que executa uma ação, select() um OptionButton que guarda um valor, GoSplitButton uma ação principal mais um menu na seta dele (chosen(index)). Os menus ficam totalmente opacos de propósito — um menu mostrado na própria janela do sistema operacional deixa pretos os pixels translúcidos.

GoCombobox — uma lista com busca

var friend := GoCombobox.make(friend_names, -1, "Find a friend")
friend.picked.connect(func(index: int) -> void: invite(friend_names[index]))

Ao ser tocado, ele abre uma lista ancorada na camada 96 com um véu transparente. A partir de search_threshold (8) itens aparece um campo de busca que recebe o foco; ele encontra o termo em qualquer ponto do texto ou da dica, sem diferenciar maiúsculas, e um resultado vazio avisa isso. list_width (0 = a largura do botão, no mínimo 180dp) define a largura da lista.

Popups que nunca param o jogo

Notícias que o jogador pode ler enquanto joga. Nenhum deles tem véu; um toque em qualquer lugar fora do próprio cartão vai para o jogo.

GoSnackbar — uma mensagem com Desfazer

var snack := GoSnackbar.new()
add_child(snack)

if await snack.post({"text": "Dropped {name}", "args": {"name": item.name}, "icon": GoIconSet.TRASH,
        "actions": ["Undo"], "seconds": 5.0}) == 0:
    restore(item)

post() devolve o índice do botão tocado, ou -1 quando o tempo acabou ou ele foi dispensado. As mensagens entram na fila (queue_limit 4; a mais antiga é descartada com -1), e o mesmo texto postado de novo enquanto aparece só renova o timer. Ele fica embaixo (ou no topo, placement), acima da área segura e do teclado, na camada 90 — legível por cima de um painel lateral. Com tap_to_dismiss (ligado), um toque em um cartão sem botões o fecha; um toque fora do cartão sempre chega ao jogo. show_text() e show_key() são as formas de uma linha.

GoNotice — uma linha no HUD

var notice := GoNotice.new()
hud_corner.add_child(notice)
notice.show_text("Game saved", GoTheme.SUCCESS)
notice.custom_minimum_size.x = notice.preferred_width(340)

Um painel simples que você mesmo posiciona — em um GoHudAnchor, num canto, em qualquer lugar. Ele não toma nem a entrada nem o foco, então tocar através dele chega ao botão que está embaixo, e uma mensagem nova substitui a anterior. Dê uma largura a ele: preferred_width(limit) devolve a largura natural de um texto curto e quebra um texto longo dentro de limit. set_content() mostra qualquer controle no lugar do texto.

GoPromptCard — uma pergunta que pode esperar

var spot := GoHudAnchor.new()
spot.spot = GoHudAnchor.Spot.TOP_CENTER
spot.reserve_space = false
spot.avoid_peers = true            # fica abaixo das barras de vida em vez de cobri-las
hud.add_child(spot)

var invite := GoPromptCard.new()
spot.add_child(invite)
invite.set_icon(GoIconSet.USERS, Color.TRANSPARENT, true)
invite.set_title("Party invite from Ann")
invite.set_subtitle("Dragon's Lair · 3 / 4 members")
invite.set_actions([{"text": "Accept", "action": accept, "primary": true},
    {"text": "Decline", "action": invite.hide}])
invite.fit_width(340)
invite.show()
get_tree().create_timer(15.0).timeout.connect(invite.hide)

• Ele começa escondido — chame show(). Não tem timer próprio; acrescente um se a pergunta expirar.
• Os botões dele não o fecham — as ações decidem. O × (set_closable(true)) emite closed.
• fit_width(width) define a largura e prevê a altura a partir da fonte, então nada posicionado em relação a ele pula um frame depois.
• A face dele segue hud_alpha — ele faz parte do HUD, não é uma janela.

GoBanner e dicas

GoBanner.make("You're offline.", [{"text": "Retry", "action": reconnect}], GoIconSet.WARNING) fica dentro da própria página, acima do conteúdo, e nunca expira; um botão o dispensa, a menos que ele tenha "keep": true. GoStyle.tooltip_node(text) é o que retornar de _make_custom_tooltip() — a engine desenha a placa (TooltipPanel) e o gohud o texto, com quebra de linha a partir de 260dp. Dicas são para mouse; nunca esconda atrás de uma algo de que o jogador precisa.

Tours e o console

GoCoachMark — um tour pelos controles de verdade

var tour := GoCoachMark.new()
tour.keep_clear = [top_bar]
tour_layer.add_child(tour)
tour.finished.connect(func(completed: bool) -> void: save.tutorial_done = true)
tour.start([{"target": bag_button, "title": "Bag", "body": "Everything you pick up lands here."},
    {"target": map_button, "title": "Map", "body": "Tap to open the full map."}])

• Um anel em volta do controle de verdade e um cartão ao lado dele. Tocar no alvo avança o tour (o sinal pressed dele, ou "signal" no passo); Próximo e Pular ficam no cartão. Um alvo escondido é pulado.
• O cartão fica fora do meio da tela (avoid_center_band), longe das âncoras do HUD e de keep_clear.
• Enquanto qualquer GoSurface estiver aberto, o tour se esconde e espera. Voltar ou Escape o encerram com finished(false).
• Ele não tem camada própria — adicione-o por último, ou em uma camada acima do HUD.

GoConsole — cheats enquanto você desenvolve

var console := GoConsole.new()
add_child(console)
console.register("give", "give <item> <count>", func(args: PackedStringArray) -> String:
    return "gave %s x%s" % [args[0], args[1]] if args.size() >= 2 else "give <item> <count>")

func _unhandled_input(event: InputEvent) -> void:
    if event.is_action_pressed(&"dev_console"): console.toggle()

Camada 200 — acima de tudo, para você poder depurar por cima de um diálogo — e ele continua rodando enquanto a árvore está pausada. Uma paleta sugere comandos enquanto você digita; as setas para cima e para baixo percorrem o histórico; Escape o fecha. Não há tecla embutida: associe a sua.

Camadas, Voltar e entrada

Três regras decidem o que o jogador pode tocar enquanto algo está aberto: o que fica por cima, de quem é o Voltar e quem recebe um toque.

O que fica por cima

A ordem é proposital: um snackbar informa o que acabou de acontecer, então aparece por cima de um painel lateral; um popover pertence ao que acabou de ser tocado, então fica acima disso; um diálogo faz uma pergunta e cobre os dois; o console cobre tudo, porque é o que você abre quando o resto deu errado.

De quem é o Voltar

• Só a janela de cima responde. Entre as superfícies abertas, a que está na camada mais alta (e, depois, a mais recente na árvore) recebe o Escape, o cancelar do gamepad (ui_cancel), o Voltar do Android e os toques no véu. Janelas empilhadas fecham uma de cada vez, nunca juntas.
• O Voltar do Android é tratado um frame depois, então um único toque nunca fecha duas janelas.
• Enquanto houver algo aberto que é dono do Voltar, o Voltar do Android não fecha o app (GoBackPolicy conta os donos e restaura quit_on_go_back depois do último). Um popup seu que recebe o Voltar deve chamar GoBackPolicy.acquire() e release() — no _exit_tree também.
• Um painel lateral, um tour de coach marks e um formulário dão passagem enquanto uma superfície está aberta — o Voltar vai primeiro para a superfície.
• GoConfig.close_on_back (ligado) é o interruptor das superfícies.

Quem recebe um toque

• Uma superfície cobre a tela inteira e bloqueia a entrada — com um véu transparente também. Nada em uma camada inferior pode ser tocado enquanto ela está aberta; camadas acima dela (um snackbar) ainda podem.
• A roda do mouse e o gesto de pinça também param na janela: rolar além do fim de uma lista nunca rola o jogo.
• A entrada do gameplay que não passa por controles — _unhandled_input para o movimento, um arraste de câmera — deve esperar: if GoSurface.is_any_open(): return. Isso cobre diálogos, folhas, popovers e o combobox; para um painel lateral, pergunte is_open() à parte.
• Snackbar, aviso, cartão de pergunta e coach mark só recebem entrada no próprio cartão; em todo o resto, quem recebe é o jogo.

Foco

Uma janela aberta por um ponteiro não foca nada — nenhum anel de foco pisca por causa de um toque. Aberta pelo teclado ou pelo gamepad, o botão de fechar (ou initial_focus) recebe o foco. O foco fica dentro da janela enquanto ela está aberta e volta para o controle que o tinha quando a janela fecha. Diálogos focam o OK toda vez.

Pausando o jogo

Pausar a árvore pausa os popups também — só o console continua funcionando. Para um menu de pausa, dê à camada dele process_mode = PROCESS_MODE_ALWAYS; assim a janela, os botões dela e o Voltar continuam rodando enquanto o jogo está parado.

O mesmo popup em todo visual

A confirmação do topo desta página, sobre o mesmo jogo, mudando só o preset. O código é idêntico — o tema, a skin e os ícones fazem o resto.

O que cada visual muda

Vestir um popup a partir de uma skin

Uma skin decide as partes que um Theme não alcança. Estes são os métodos que os popups chamam — sobrescreva-os na sua própria subclasse de GoSkin; por padrão eles não fazem nada.

Quanto dá para ver através

Cada tipo de popup segue a própria opacidade, então um cartão de HUD pode ficar leve enquanto um diálogo continua sólido: janelas, folhas, diálogos, popovers e o combobox seguem panel_alpha; o painel lateral e o cartão do tour, card_alpha; cartões de pergunta e o console, hud_alpha; snackbars e avisos, notice_alpha; menus, popup_alpha. Material e infantil deixam todos opacos; quadrinhos também, exceto os cartões de pergunta e o console, a 92%, e arcade também, exceto esses dois, a 94%. Sobrescreva um tipo com GoConfig.container_alpha_overrides, todos com container_alpha (uma proporção — 0.95), ou uma janela com o alpha dela. Só a face esmaece; o texto nunca fica transparente. Opacidade em detalhe →

Configurações que moldam todo popup

Campos de GoConfig (GoUi.config). Alguns são copiados quando uma janela é criada, então defina-os antes de montar a UI — ou chame GoUi.refresh() depois de mudá-los.

Receitas

Copie, cole, troque as palavras. Toda chamada aqui foi conferida com o código-fonte.

Uma compra com o preço na mensagem

func buy(item_name: String, price: int) -> void:
    if await dialogs.confirm("Buy {item}?", "It costs {price} gold.", "Buy", "", "",
            {"item": item_name, "price": price}):
        purchase(item_name)

Uma janela de configurações com Salvar fixo

func open_settings() -> void:
    var layer := CanvasLayer.new()
    layer.layer = 50
    add_child(layer)
    var window := GoSurface.new()
    window.set_title("Settings")
    window.dismiss_on_scrim = true
    window.close_requested.connect(layer.queue_free)
    window.body.add_child(GoStyle.section("Sound", false))
    window.body.add_child(GoStyle.toggle("Music", false))
    window.body.add_child(GoStyle.slider(0.0, 1.0, 0.05))
    var row := GoStyle.row()
    row.add_child(GoStyle.button("Cancel", window.request_close))
    row.add_child(GoStyle.button("Save", func() -> void:
        save_settings()
        layer.queue_free(), GoStyle.Tone.PRIMARY))
    window.footer.add_child(row)
    window.footer.visible = true
    layer.add_child(window)

Um formulário que diz o que está errado

var field := GoField.make("Name", GoStyle.line_edit(), "3–12 letters")
window.body.add_child(field)
create_button.pressed.connect(func() -> void:
    if name_is_taken():
        field.set_error("That name is taken")
        window.set_status_text("Name check failed", GoTheme.DANGER)
    else:
        window.clear_status()
        create_character())

Uma data em uma folha

sheet.open("Delivery date")
var picker := GoDatePicker.make({"year": 2026, "month": 10, "day": 14}, func(date: Dictionary) -> void:
    delivery = date
    sheet.close())
picker.min_date = GoDatePicker.today()
sheet.body.add_child(picker)

Um menu de pausa

func pause() -> void:
    get_tree().paused = true
    var layer := CanvasLayer.new()
    layer.layer = 50
    layer.process_mode = Node.PROCESS_MODE_ALWAYS      # continua rodando enquanto o jogo está pausado
    add_child(layer)
    var menu := GoSurface.new()
    menu.set_title("Paused")
    menu.close_requested.connect(func() -> void:
        get_tree().paused = false
        layer.queue_free())
    menu.body.add_child(GoStyle.button("Resume", menu.request_close, GoStyle.Tone.PRIMARY))
    menu.body.add_child(GoStyle.button("Settings", open_settings))
    menu.body.add_child(GoStyle.button("Quit to title", quit_to_title, GoStyle.Tone.DANGER))
    layer.add_child(menu)

Gameplay que espera os popups

func _unhandled_input(event: InputEvent) -> void:
    if GoSurface.is_any_open() or drawer.is_open():
        return
    handle_gameplay(event)

Armadilhas

• Um GoSurface nunca se libera sozinho. Conecte close_requested, ou o × não faz nada.
• Opções definidas depois do add_child — scrim_transparent, show_header, resizable, scroll_body, e layer_index e max_width do GoDialogs — não são aplicadas.
• Um segundo confirm() devolve false na hora. Ligue queue_when_busy se duas perguntas puderem se encontrar.
• Enter confirma. O OK tem o foco, nos diálogos destrutivos também.
• Voltar em uma folha fecha a folha, não a subpágina.
• Escape não fecha um painel lateral, e is_any_open() não o enxerga.
• Um popover ou uma lista de combobox bloqueia o jogo até fechar, mesmo com véu transparente — e um popover com dismissable = false e sem título não tem nada na tela que o feche.
• Um cartão de pergunta começa escondido e não tem tempo limite.
• Um snackbar com seconds: 0 e sem botão nunca sai. E, por padrão, ele pega os toques no próprio cartão.
• Um toque longo que ninguém conhece é um recurso que ninguém usa. Mostre um ⋯ também.
• Uma árvore pausada pausa o seu popup. Use PROCESS_MODE_ALWAYS na camada dele.
• Um aviso sem largura encolhe até o mínimo — use preferred_width().
• Nunca pergunte em um snackbar, nunca informe em um diálogo. Uma pergunta em um snackbar some se for ignorada; uma notícia não deveria parar o jogo.