Wyskakujące okna i dialogi

Wybierz właściwe okno

Wyskakujące okno przerywa grę. Zanim któreś wybierzesz, odpowiedz na jedno pytanie: czy gracz musi odpowiedzieć, zanim gra pójdzie dalej? Jeśli tak — blokuj. Jeśli nie — nigdy nie blokuj: karta, która zatrzymuje grę dla wiadomości, o którą gracz nie prosił, to najszybszy sposób, żeby zamknął twoją grę.

1. Pytanie, na które jest odpowiedź — kup, usuń, wyjdź, nadpisz → GoDialogs.confirm(). Coś do przyjęcia do wiadomości → alert(). Jedna z kilku opcji → choose().
2. Osobny ekran — ustawienia, karta postaci, przedmiot w sklepie → GoSurface na środku ekranu.
3. Długa lista albo strona zarządzania — sakwa, poczta, znajomi → GoSheet od dołu na telefonie, GoDrawer z boku na szerokim ekranie.
4. Coś o rzeczy, którą właśnie naciśnięto — statystyki przedmiotu, jego akcje → GoPopover albo GoContextMenu tuż obok.
5. Wiadomości, przy których gra może toczyć się dalej — zapisano, wyrzucono, zaproszenie → GoSnackbar, GoNotice albo GoPromptCard. One nigdy nie zajmują ekranu.
6. Nauka sterowania → GoCoachMark. Cheaty w trakcie tworzenia → GoConsole.

Wszystkie okna w skrócie

Na której warstwie otwiera się każde z nich i dlaczego w tej kolejności — zobacz Warstwy, Wstecz i wejście.

Każdy obrazek na tej stronie to ta sama mała gra — zdrowie i mana w lewym górnym rogu, monety w prawym górnym, joystick i trzy szybkie sloty na dole — w default_dark, z jednym otwartym oknem na wierzchu. To samo okno we wszystkich czternastu wyglądach →

Budowa wyskakującego okna

Niemal każde blokujące okno w gohud — okna dialogowe, arkusze, popovery, lista comboboksa i twoje własne okna — to jeden węzeł: GoSurface. Poznaj jego części raz, a znasz je wszystkie.

Okna dialogowe, na które czekasz przez await

GoDialogs pyta i czeka. Jeden węzeł, trzy pytania — a odpowiedź wraca w tej samej linii, więc kod czyta się w kolejności, w jakiej przeżywa to gracz.

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()

Trzy pytania

confirm(title, body, ok_text := "", cancel_text := "", extra := "",
        args := {}, destructive := false) -> bool
alert(title, body, ok_text := "", extra := "", args := {})      # użyj await, żeby poczekać
choose(title, options: Array, cancel_text := "", translate := false) -> int
confirm_key(…) · alert_key(…)                                 # klucze tłumaczeń

Puste etykiety przycisków wracają do słów samego zestawu (confirm, cancel w GoConfig.text_keys). extra dopisuje się do treści w nowej linii. args wypełnia {placeholders} w tytule i w treści: confirm("Buy {item}?", "It costs {price} gold.", "Buy", "", "", {"item": name, "price": 300}).

Każda droga wyjścia ma odpowiedź

Dlatego kod po await zawsze się wykona — żadna odpowiedź nie zostaje w zawieszeniu, nawet gdy scena zmieni się pod oknem.

Akcje nieodwracalne

Podaj destructive = true dla czegoś, czego nie da się cofnąć. Przycisk OK staje się wypełnionym przyciskiem Tone.DANGER_SOLID — biały na czerwonym w każdym wyglądzie, podczas gdy zabarwiona etykieta niebezpieczeństwa musiałaby w jasnym motywie ściemnieć niemal do czerni, żeby pozostać czytelna. Ton jest resetowany przy każdym wywołaniu, bo okno jest używane wielokrotnie.

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

Układ przycisków

action_gap to odstęp między przyciskami, body_gap odstęp nad nimi — zrób go szerszym niż odstęp między przyciskami, żeby pytanie i wybór czytały się jako dwie części. Dla jednego okna z osobna wywołaj set_next_action_layout() przed jego otwarciem. Jedyny przycisk alertu zawsze zajmuje całą szerokość.

Jedno naraz

Drugie confirm(), gdy jedno jest otwarte, od razu zwraca false — okno dialogowe nigdy przypadkiem nie piętrzy się na innym. Włącz queue_when_busy, a zamiast tego poczeka na swoją kolej; alert() czeka zawsze. queue_limit (8) ogranicza kolejkę, a gdy się przepełni, najstarsze żądanie dostaje odpowiedź false. pending() liczy oczekujące żądania, a clear_pending() odpowiada na wszystkie false. choose() nigdy nie czeka w kolejce: zwraca -1, gdy jakieś okno jest już otwarte.

Telefon i komputer

choose() otwiera się jako arkusz od dołu na Androidzie i iOS — tam, gdzie jest kciuk — a na komputerze jako karta na środku. Potwierdzenie jest ograniczone do max_width (420dp) i wyśrodkowane. Ustaw layer_index, max_width i pozostałe eksporty przed add_child; nakładane są, gdy węzeł wchodzi do drzewa.

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 — twoje własne okno

Gdy okno to coś więcej niż pytanie — ustawienia, karta postaci, przedmiot do kupienia — zbuduj je na GoSurface. Bezpieczny obszar, klawiatura, przyklejone wiersze, przewijanie, Wstecz, fokus i zmiana rozmiaru są już zrobione.

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)

Trzy umiejscowienia

ANCHOR potrzebuje anchor_control. Karta trafia na prawo od niej, jeśli zmieści się anchor_min_width, w przeciwnym razie na szerszą stronę, a w ostateczności do wnętrza ekranu; otwiera się w górę, gdy nad kotwicą jest więcej miejsca. Podąża za ruchomą kotwicą w każdej klatce. Rozmiar ustalają anchor_width (320) i anchor_max_height (520).

Jak duże się robi

Proporcja powyżej limitu jest przycinana, z jednym ostrzeżeniem w kompilacji debugowej. Klawiatura wypycha kartę w górę i przewija pole z fokusem do widoku; bezpieczny obszar trzyma ją z dala od wycięcia i paska gestów na Androidzie i iOS.

Właściwości

Sygnały i wywołania

Arkusze i panele boczne

Lista, która potrzebuje miejsca, wysuwa się od dołu na telefonie trzymanym pionowo — tam, gdzie jest kciuk — a z boku na tablecie albo komputerze, gdzie arkusz zakryłby grę.

GoSheet — strony od dołu

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))

• To CanvasLayer (warstwa 10) z GoSurface w umiejscowieniu BOTTOM i ze zmiennym rozmiarem — więc siedzi ponad HUD, a gracz może go przeciągnąć wyżej.
• open(title) zaczyna nową stronę: czyści ciało, pasek narzędzi i przycisk wstecz oraz zwalnia to, co dodało add_footer(). Wywołaj je ponownie, żeby pokazać inną stronę w tym samym arkuszu; set_back() pokazuje przycisk wstecz do powrotu. open_key() przyjmuje klucz tłumaczenia.
• close() go ukrywa — nie jest zwalniany, więc następne open() działa natychmiast. closed i page_changed mówią, kiedy to nastąpiło.
• height_ratio (0.6) to wysokość przy otwarciu; max_height_ratio podnosi limit; dismissable (true) zamyka arkusz po stuknięciu w zasłonę.

GoDrawer — z boku

var drawer := GoDrawer.new()
drawer.side = GoDrawer.Side.LEFT
drawer.follow_text_direction = true      # strona początku: lewa, po arabsku prawa
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")

• Warstwa 80. 42% szerokości ekranu (width_ratio), między min_width (320dp) a max_width (420dp) — na telefonie zakrywa większość ekranu, i dlatego tam lepszym wyborem jest arkusz.
• Panel sięga krawędzi ekranu; tylko jego treść odsuwa się od bezpiecznego obszaru, więc zaokrąglony narożnik nigdy nie utnie pierwszego wiersza.
• LEFT oznacza lewą stronę ekranu także po arabsku. Włącz follow_text_direction, gdy chodzi o „stronę początku”; effective_side() powie, gdzie panel trafił.
• open(title) zachowuje ciało — wypełnij je raz. set_title("") ukrywa nagłówek. motion_seconds (0.2) wsuwa panel; reduce_motion sprawia, że pojawia się natychmiast.

Karty i menu obok kontrolki

To, co gracz właśnie nacisnął, zasługuje na odpowiedź tuż przy palcu, a nie na środku ekranu.

GoPopover — karta przy naciśniętej rzeczy

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}))

Powierzchnia ANCHOR z już podłączoną warstwą, kotwicą i sprzątaniem — te dziesięć linii, które każda gra pisze wciąż od nowa. Jedna naraz: otwarcie drugiej zamyka pierwszą, bo karty ułożone w stos grzebią ekran i nikt nie pozna, która należy do którego slotu. Zasłona jest przezroczysta — karta otwarta po to, by porównać ekwipunek, nie może go przyciemniać — ale nadal łapie pierwsze stuknięcie poza kartą, które zamyka kartę i nie idzie dalej.

GoPopover.close() i GoPopover.is_open() są statyczne. open() zwraca powierzchnię — albo null, gdy kotwicy nie ma w drzewie, więc sprawdź to, zanim napiszesz await shown.close_requested.

GoContextMenu — przytrzymanie i prawy przycisk myszy

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))

• Prawy przycisk myszy otwiera je od razu. Palec przytrzymany przez pół sekundy (HOLD_SECONDS) je otwiera; ruch o więcej niż 12dp anuluje — więc przewijanie listy nigdy nie wyskakuje menu.
• Pozycja to {text, action, icon, disabled, checked, separator, danger, translate}. Podaj Callable zamiast tablicy, gdy pozycje zależą od tego, co naciśnięto; wywoływany jest przy każdym otwarciu menu.
• danger stawia „⚠ ” przed tekstem — menu silnika potrafi pokolorować tylko wszystkie pozycje naraz.
• To silnikowe PopupMenu, ubrane przez GoStyle.style_popup(). Nie liczy się jako otwarta powierzchnia.

Listy rozwijane, wybory i przycisk dzielony

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"])

Wszystkie trzy otwierają menu podręczne silnika: dropdown() to MenuButton, który wykonuje akcję, select() to OptionButton, który przechowuje wartość, a GoSplitButton to główna akcja plus menu pod strzałką (chosen(index)). Menu są celowo w pełni nieprzezroczyste — menu pokazane we własnym oknie systemu operacyjnego zamienia półprzezroczyste piksele w czarne.

GoCombobox — lista z wyszukiwaniem

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

Po naciśnięciu otwiera przypiętą listę na warstwie 96 z przezroczystą zasłoną. Od search_threshold (8) pozycji pojawia się pole wyszukiwania i przejmuje fokus; dopasowuje w dowolnym miejscu tekstu lub podpowiedzi, bez względu na wielkość liter, a pusty wynik to komunikuje. Rozmiar listy ustala list_width (0 = szerokość przycisku, co najmniej 180dp).

Okna, które nigdy nie zatrzymują gry

Wiadomości, które gracz może przeczytać w trakcie gry. Żadne z nich nie ma zasłony; stuknięcie gdziekolwiek poza samą kartą trafia do gry.

GoSnackbar — komunikat z Cofnij

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() zwraca indeks naciśniętego przycisku albo -1, gdy minął czas lub komunikat zamknięto. Wpisy czekają w kolejce (queue_limit 4, najstarszy wypada z -1), a ten sam tekst wysłany ponownie, gdy jest pokazywany, tylko odnawia swój licznik czasu. Siedzi na dole (albo u góry — placement), nad bezpiecznym obszarem i klawiaturą, na warstwie 90 — czytelny ponad panelem bocznym. Z tap_to_dismiss (włączone) stuknięcie w kartę bez przycisków ją zamyka; stuknięcie poza kartą zawsze trafia do gry. show_text() i show_key() to formy jednolinijkowe.

GoNotice — wiersz na 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)

Zwykły panel, który umieszczasz sam — w GoHudAnchor, w rogu, gdziekolwiek. Nie przejmuje ani wejścia, ani fokusu, więc naciśnięcie przez niego trafia w przycisk pod spodem, a nowy komunikat zastępuje stary. Nadaj mu szerokość: preferred_width(limit) zwraca naturalną szerokość krótkiego tekstu, a długi zawija w granicach limit. set_content() pokazuje dowolną kontrolkę zamiast tekstu.

GoPromptCard — pytanie, które może poczekać

var spot := GoHudAnchor.new()
spot.spot = GoHudAnchor.Spot.TOP_CENTER
spot.reserve_space = false
spot.avoid_peers = true            # zejdź pod paski zdrowia, zamiast je zakrywać
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)

• Startuje ukryta — wywołaj show(). Nie ma własnego licznika czasu; dodaj go, jeśli pytanie wygasa.
• Jej przyciski jej nie zamykają — decydują o tym akcje. × (set_closable(true)) emituje closed.
• fit_width(width) ustawia szerokość i przewiduje wysokość na podstawie czcionki, więc nic, co jest do niej dopasowane, nie podskoczy klatkę później.
• Jej powierzchnia podąża za hud_alpha — to część HUD, nie okno.

GoBanner i podpowiedzi

GoBanner.make("You're offline.", [{"text": "Retry", "action": reconnect}], GoIconSet.WARNING) siedzi w samej stronie, nad treścią, i nigdy nie wygasa; przycisk go zamyka, chyba że ma "keep": true. GoStyle.tooltip_node(text) to to, co zwracasz z _make_custom_tooltip() — tło (TooltipPanel) rysuje silnik, tekst rysuje gohud, z zawijaniem powyżej 260dp. Podpowiedzi są dla myszy; nigdy nie chowaj za nimi czegoś, czego gracz potrzebuje.

Przewodniki i konsola

GoCoachMark — przewodnik po prawdziwych kontrolkach

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."}])

• Pierścień wokół prawdziwej kontrolki i karta obok niej. Naciśnięcie celu przesuwa przewodnik dalej (jego sygnał pressed albo "signal" w kroku); Dalej i Pomiń są na karcie. Ukryty cel jest pomijany.
• Karta trzyma się z dala od środka ekranu (avoid_center_band), od kotwic HUD i od keep_clear.
• Gdy otwarta jest jakakolwiek GoSurface, przewodnik się chowa i czeka. Wstecz albo Escape kończy go z finished(false).
• Nie ma własnej warstwy — dodaj go na końcu albo na warstwie ponad HUD.

GoConsole — cheaty w trakcie tworzenia

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()

Warstwa 200 — ponad wszystkim, więc da się debugować na wierzchu okna dialogowego — i działa dalej, gdy drzewo jest wstrzymane. Paleta podpowiada komendy w trakcie pisania; strzałki w górę i w dół przechodzą po historii; Escape ją zamyka. Nie ma wbudowanego klawisza: przypisz własny.

Warstwy, Wstecz i wejście

Trzy reguły decydują, czego gracz może dotknąć, gdy coś jest otwarte: co jest na wierzchu, do kogo należy Wstecz i kto przyjmuje stuknięcie.

Co jest na wierzchu

Kolejność jest celowa: snackbar donosi o tym, co właśnie się stało, więc czyta się go ponad panelem bocznym; popover należy do tego, co właśnie naciśnięto, więc siedzi nad tym; okno dialogowe zadaje pytanie i zakrywa oba; konsola zakrywa wszystko, bo to ją otwierasz, gdy cała reszta zawiodła.

Do kogo należy Wstecz

• Odpowiada tylko najwyższe okno. Spośród otwartych powierzchni ta na najwyższej warstwie (a przy remisie najpóźniejsza w drzewie) przejmuje Escape, anulowanie z pada (ui_cancel), androidowe Wstecz i stuknięcia w zasłonę. Okna ułożone w stos zamykają się po jednym, nigdy razem.
• Androidowe Wstecz jest obsługiwane klatkę później, więc jedno naciśnięcie nigdy nie zamknie dwóch okien.
• Dopóki otwarte jest cokolwiek, co posiada Wstecz, androidowe Wstecz nie zamyka aplikacji (GoBackPolicy liczy właścicieli i przywraca quit_on_go_back po ostatnim). Twoje własne okno, które przejmuje Wstecz, powinno wywołać GoBackPolicy.acquire() i release() — także w _exit_tree.
• Panel boczny, przewodnik wskazówek i formularz ustępują, gdy otwarta jest powierzchnia — Wstecz trafia najpierw do niej.
• GoConfig.close_on_back (włączone) to przełącznik dla powierzchni.

Kto przyjmuje stuknięcie

• Powierzchnia zakrywa cały ekran i zatrzymuje wejście — przezroczysta zasłona także. Gdy jest otwarta, nic na niższej warstwie nie zostanie naciśnięte; warstwy nad nią (snackbar) — nadal tak.
• Kółko myszy i gest szczypania też zatrzymują się na oknie: przewinięcie poza koniec listy nigdy nie przewija gry.
• Wejście rozgrywki, które nie przechodzi przez kontrolki — _unhandled_input do ruchu, przeciąganie kamery — powinno się wstrzymać: if GoSurface.is_any_open(): return. To obejmuje okna dialogowe, arkusze, popovery i combobox; panel boczny zapytaj osobno przez is_open().
• Snackbar, powiadomienie, karta pytania i wskazówka instruktażowa przyjmują wejście tylko na własnej karcie; wszędzie indziej dostaje je gra.

Fokus

Okno otwarte wskaźnikiem nie daje nikomu fokusu — przy dotyku nie miga żaden pierścień. Otwarte z klawiatury albo pada przekazuje fokus przyciskowi zamknięcia (albo initial_focus). Fokus zostaje wewnątrz okna, dopóki jest otwarte, i wraca do kontrolki, która go miała, gdy okno się zamknie. Okna dialogowe za każdym razem dają fokus przyciskowi OK.

Wstrzymywanie gry

Wstrzymanie drzewa wstrzymuje też okna — działa dalej tylko konsola. Dla menu pauzy nadaj jego warstwie process_mode = PROCESS_MODE_ALWAYS; wtedy okno, jego przyciski i Wstecz działają, gdy gra stoi.

To samo okno w każdym wyglądzie

Potwierdzenie z początku tej strony, nad tą samą grą, ze zmienionym tylko presetem. Kod jest identyczny — resztę robią motyw, skórka i ikony.

Co zmienia każdy wygląd

Ubierz okno ze skórki

Skórka decyduje o częściach, do których motyw nie sięga. Te haki wywołują okna — nadpisz je we własnej podklasie GoSkin; domyślnie nic nie robią.

Jak bardzo prześwitują

Każdy rodzaj okna ma własne krycie, więc karta HUD może zostać lekka, a okno dialogowe pełne: okna, arkusze, okna dialogowe, popovery i combobox idą za panel_alpha; panel boczny i karta przewodnika za card_alpha; karty pytań i konsola za hud_alpha; snackbary i powiadomienia za notice_alpha; menu za popup_alpha. Material i Kids robią je wszystkie nieprzezroczystymi; Comic też, poza kartami pytań i konsolą, które mają 92%, a Arcade też, poza tymi dwoma, które mają 94%. Nadpisz jeden rodzaj przez GoConfig.container_alpha_overrides, wszystkie przez container_alpha (proporcja — 0.95), a jedno okno przez jego alpha. Blednie tylko powierzchnia; tekst nigdy nie prześwituje. Krycie szczegółowo →

Ustawienia, które kształtują każde okno

Pola GoConfig (GoUi.config). Kilka z nich jest kopiowanych przy tworzeniu okna, więc ustaw je przed zbudowaniem interfejsu — albo wywołaj GoUi.refresh() po ich zmianie.

Przepisy

Skopiuj, wklej, zmień słowa. Każde wywołanie tutaj jest sprawdzone ze źródłem.

Zakup z ceną w treści

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)

Okno ustawień z przyklejonym Zapisz

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)

Formularz, który mówi, co jest nie tak

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())

Data w arkuszu

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)

Menu pauzy

func pause() -> void:
    get_tree().paused = true
    var layer := CanvasLayer.new()
    layer.layer = 50
    layer.process_mode = Node.PROCESS_MODE_ALWAYS      # działa dalej, gdy gra jest wstrzymana
    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)

Rozgrywka, która czeka na okna

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

Pułapki

• GoSurface nigdy nie zwalnia się sama. Podłącz close_requested, inaczej × nic nie zrobi.
• Opcje ustawione po add_child — scrim_transparent, show_header, resizable, scroll_body oraz layer_index i max_width w GoDialogs — nie zostaną nałożone.
• Drugie confirm() od razu zwraca false. Włącz queue_when_busy, jeśli dwa pytania mogą się spotkać.
• Enter potwierdza. Fokus ma OK, także w nieodwracalnych oknach.
• Wstecz na arkuszu zamyka arkusz, a nie podstronę.
• Escape nie zamyka panelu bocznego, a is_any_open() go nie widzi.
• Popover albo lista comboboksa blokuje grę, dopóki się nie zamknie, nawet z przezroczystą zasłoną — a popovera z dismissable = false i bez tytułu nie zamknie nic na ekranie.
• Karta pytania startuje ukryta i nie wygasa.
• Snackbar z seconds: 0 i bez przycisku nigdy nie zniknie. Do tego domyślnie łapie stuknięcia w swoją kartę.
• Przytrzymanie, o którym nikt nie wie, to funkcja, której nikt nie używa. Pokaż też ⋯.
• Wstrzymane drzewo wstrzymuje twoje okno. Użyj PROCESS_MODE_ALWAYS na jego warstwie.
• Powiadomienie bez szerokości kurczy się do najwęższej postaci — użyj preferred_width().
• Nigdy nie pytaj w snackbarze, nigdy nie informuj w oknie dialogowym. Zignorowane pytanie znika; wiadomość nie powinna zatrzymywać gry.