Popup dan dialog

Pilih popup yang tepat

Setiap jendela yang muncul menyela permainan. Sebelum memilihnya, jawab satu pertanyaan saja: haruskah pemain menjawab dulu sebelum game berlanjut? Jika ya, blokir. Jika tidak, jangan pernah memblokir — kartu yang menghentikan game demi kabar yang tidak diminta pemain adalah cara tercepat membuat mereka menutup game Anda.

1. Pertanyaan yang butuh jawaban — beli, hapus, keluar, timpa → GoDialogs.confirm(). Sesuatu yang cukup diketahui → alert(). Satu dari beberapa pilihan → choose().
2. Layar tersendiri — setelan, lembar karakter, barang di toko → GoSurface di tengah layar.
3. Daftar panjang atau halaman pengelolaan — tas, surat, teman → GoSheet dari bawah di ponsel, GoDrawer dari samping di layar lebar.
4. Sesuatu tentang benda yang baru ditekan — statistik sebuah item, tindakan-tindakannya → GoPopover atau GoContextMenu tepat di sampingnya.
5. Kabar yang tidak perlu menghentikan game — tersimpan, dibuang, diundang → GoSnackbar, GoNotice, atau GoPromptCard. Semua ini tidak pernah mengambil alih layar.
6. Mengajarkan kontrol → GoCoachMark. Cheat selama pengembangan → GoConsole.

Semua popup dalam satu tabel

Di lapisan mana masing-masing terbuka, dan mengapa urutannya begitu, dijelaskan di Lapisan, Kembali, dan input.

Setiap gambar di halaman ini adalah game kecil yang sama — darah dan mana di kiri atas, koin di kanan atas, joystick dan tiga slot cepat di bawah — dalam default_dark, dengan satu popup terbuka di atasnya. Popup yang sama dalam keempat belas tampilan →

Anatomi sebuah popup

Hampir semua jendela yang memblokir di gohud — dialog, lembar, popover, daftar combobox, dan jendela buatan Anda sendiri — adalah satu node, GoSurface. Pelajari bagian-bagiannya sekali dan Anda mengenal semuanya.

Dialog yang Anda await

GoDialogs bertanya lalu menunggu. Satu node, tiga jenis pertanyaan — dan jawabannya kembali di baris yang sama, sehingga kodenya terbaca sesuai urutan yang dialami pemain.

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

Tiga jenis pertanyaan

confirm(title, body, ok_text := "", cancel_text := "", extra := "",
        args := {}, destructive := false) -> bool
alert(title, body, ok_text := "", extra := "", args := {})      # await untuk menunggunya
choose(title, options: Array, cancel_text := "", translate := false) -> int
confirm_key(…) · alert_key(…)                                 # kunci terjemahan

Label tombol yang kosong kembali ke kata-kata milik kit sendiri (confirm, cancel di GoConfig.text_keys). extra ditambahkan ke body pada baris baru. args mengisi {placeholders} di judul dan body: confirm("Buy {item}?", "It costs {price} gold.", "Buy", "", "", {"item": name, "price": 300}).

Setiap jalan keluar punya jawaban

Jadi kode setelah await selalu berjalan — tak ada jawaban yang dibiarkan menggantung, bahkan ketika scene berganti di bawah dialognya.

Tindakan yang tak bisa dibatalkan

Berikan destructive = true untuk sesuatu yang tidak bisa dibatalkan. Tombol OK berubah menjadi tombol Tone.DANGER_SOLID yang berisi penuh — putih di atas merah di setiap tampilan, sedangkan label bahaya yang hanya dironai harus digelapkan hingga nyaris hitam pada tema terang agar tetap terbaca. Nadanya disetel ulang pada setiap pemanggilan, karena jendelanya dipakai ulang.

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

Tata letak tombol

action_gap adalah jarak antartombol, body_gap jarak di atasnya — buat lebih lebar daripada jarak antartombol agar pertanyaan dan pilihannya terbaca sebagai dua bagian. Untuk satu dialog saja, panggil set_next_action_layout() sebelum membukanya. Satu-satunya tombol pada alert selalu selebar penuh.

Satu per satu

confirm() kedua selagi satu masih terbuka langsung mengembalikan false — dialog tidak pernah bertumpuk di atas dialog secara tak sengaja. Nyalakan queue_when_busy dan ia akan antre menunggu gilirannya; alert() selalu menunggu. queue_limit (8) membatasi panjang antrean, dan saat meluap permintaan tertua dijawab false. pending() menghitung permintaan yang menunggu dan clear_pending() menjawab semuanya false. choose() tidak pernah antre: ia mengembalikan -1 bila sebuah dialog sudah terbuka.

Ponsel dan desktop

choose() terbuka sebagai lembar dari bawah di Android dan iOS — tempat ibu jari berada — dan sebagai kartu di tengah di desktop. Sebuah konfirmasi dibatasi pada max_width (420dp) dan diletakkan di tengah. Setel layer_index, max_width, dan export lainnya sebelum add_child; semuanya diterapkan saat node masuk ke tree.

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 — jendela buatan Anda sendiri

Bila sebuah popup lebih dari sekadar pertanyaan — setelan, lembar karakter, barang untuk dibeli — bangun di atas GoSurface. Area aman, keyboard, baris yang menempel, gulir, Kembali, fokus, dan pengubahan ukuran sudah beres.

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)

Tiga penempatan

ANCHOR membutuhkan anchor_control. Kartunya ditaruh di kanan kontrol itu bila anchor_min_width muat, kalau tidak di sisi yang lebih lebar, kalau tidak juga di dalam layar, dan terbuka ke atas bila ruang di atas lebih lapang. Ia mengikuti anchor yang bergerak di setiap frame. anchor_width (320) dan anchor_max_height (520) menentukan ukurannya.

Seberapa besar jadinya

Rasio di atas batas dipotong kembali, dengan satu peringatan di build debug. Keyboard mendorong kartunya ke atas dan menggulir kolom yang terfokus ke dalam pandangan; area aman menjauhkannya dari notch dan bilah gestur di Android dan iOS.

Properti

Sinyal dan pemanggilan

Lembar dan laci

Daftar yang butuh ruang naik dari bawah pada ponsel yang dipegang tegak — tempat ibu jari berada — dan masuk dari samping pada tablet atau desktop, tempat sebuah lembar akan menutupi game.

GoSheet — halaman-halaman dari bawah

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

• Ia adalah CanvasLayer (lapisan 10) yang memuat GoSurface BOTTOM yang bisa diubah ukurannya — jadi ia berada di atas HUD, dan pemain bisa menyeretnya lebih tinggi.
• open(title) memulai halaman baru: ia mengosongkan body, bilah alat, dan tombol kembali serta membebaskan apa yang ditambahkan add_footer(). Panggil lagi untuk menampilkan halaman lain di lembar yang sama; set_back() menampilkan tombol kembali untuk jalan pulang. open_key() menerima kunci terjemahan.
• close() menyembunyikannya — tidak dibebaskan, jadi open() berikutnya seketika. closed dan page_changed memberi tahu Anda kapan itu terjadi.
• height_ratio (0.6) adalah tinggi saat dibuka; max_height_ratio menaikkan batasnya; dismissable (true) menutupnya saat selubung diketuk.

GoDrawer — dari samping

var drawer := GoDrawer.new()
drawer.side = GoDrawer.Side.LEFT
drawer.follow_text_direction = true      # sisi awal: kiri, atau kanan dalam bahasa Arab
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")

• Lapisan 80. Lebarnya 42% layar (width_ratio), di antara min_width (320dp) dan max_width (420dp) — di ponsel ia menutupi sebagian besar layar, itulah sebabnya lembar lebih tepat di sana.
• Panelnya mencapai tepi layar; hanya kontennya yang bergeser masuk dari area aman, sehingga sudut membulat tidak pernah memotong baris pertama.
• LEFT berarti kiri layar bahkan dalam bahasa Arab. Nyalakan follow_text_direction bila yang dimaksud adalah "sisi awal"; effective_side() memberi tahu ke mana ia akhirnya pergi.
• open(title) mempertahankan body — isi sekali saja. set_title("") menyembunyikan header. motion_seconds (0.2) menggesernya masuk; reduce_motion membuatnya seketika.

Kartu dan menu di samping sebuah kontrol

Apa yang baru saja ditekan pemain layak dijawab tepat di samping jarinya, bukan di tengah layar.

GoPopover — kartu pada benda yang ditekan

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

Sebuah jendela ANCHOR dengan lapisan, anchor, dan pembongkarannya sudah terpasang — sepuluh baris yang ditulis setiap game berulang-ulang. Satu per satu: membuka yang kedua menutup yang pertama, karena kartu yang bertumpuk mengubur layar dan tak seorang pun bisa tahu mana milik slot yang mana. Selubungnya transparan — kartu yang dibuka untuk membandingkan perlengkapan tidak boleh menggelapkan perlengkapannya — tetapi ia tetap menangkap ketukan pertama di luar, yang menutup kartunya dan tidak diteruskan.

GoPopover.close() dan GoPopover.is_open() bersifat statis. open() mengembalikan jendelanya — atau null bila anchor tidak ada di tree, jadi periksa dulu sebelum Anda await shown.close_requested.

GoContextMenu — tekan lama dan klik kanan

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

• Klik kanan langsung membukanya. Jari yang ditahan setengah detik (HOLD_SECONDS) membukanya; bergerak lebih dari 12dp membatalkannya — jadi menggulir daftar tidak pernah memunculkan menu.
• Sebuah item berupa {text, action, icon, disabled, checked, separator, danger, translate}. Berikan Callable alih-alih array bila entrinya bergantung pada apa yang ditekan; ia dipanggil setiap kali menu terbuka.
• danger menaruh "⚠ " di depan teks — menu milik engine hanya bisa mewarnai semua itemnya sekaligus.
• Ini adalah PopupMenu milik engine, didandani oleh GoStyle.style_popup(). Ia tidak dihitung sebagai jendela yang terbuka.

Dropdown, kotak pilihan, dan tombol terbelah

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

Ketiganya membuka menu popup milik engine: dropdown() adalah MenuButton yang menjalankan sebuah tindakan, select() adalah OptionButton yang menyimpan sebuah nilai, GoSplitButton adalah tindakan utama ditambah menu pada panahnya (chosen(index)). Menu sengaja dibiarkan buram sepenuhnya — menu yang ditampilkan di jendela OS-nya sendiri mengubah piksel tembus pandang menjadi hitam.

GoCombobox — daftar yang bisa dicari

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

Saat ditekan, ia membuka daftar tertambat di lapisan 96 dengan selubung transparan. Mulai dari search_threshold (8) entri, sebuah kolom pencarian muncul dan mengambil fokus; ia mencocokkan di bagian mana pun dari teks atau petunjuknya, tanpa membedakan huruf besar-kecil, dan hasil kosong pun diberitahukan. list_width (0 = lebar tombolnya, minimal 180dp) menentukan lebar daftarnya.

Popup yang tidak pernah menghentikan game

Kabar yang bisa dibaca pemain sambil bermain. Tak satu pun memiliki selubung; ketukan di mana saja selain kartunya sendiri sampai ke game.

GoSnackbar — pesan dengan Urungkan

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() mengembalikan indeks tombol yang ditekan, atau -1 bila waktunya habis atau ditutup. Kiriman mengantre (queue_limit 4, yang tertua dibuang dengan -1), dan teks yang sama yang dikirim lagi selagi tampil hanya mengisi ulang pengatur waktunya. Ia berada di bawah (atau di atas, placement), di atas area aman dan keyboard, pada lapisan 90 — tetap terbaca di atas laci. Dengan tap_to_dismiss (menyala) ketukan pada kartu tanpa tombol menutupnya; ketukan di luar kartu selalu sampai ke game. show_text() dan show_key() adalah bentuk satu barisnya.

GoNotice — satu baris di 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)

Panel polos yang Anda tempatkan sendiri — di dalam GoHudAnchor, di sebuah sudut, di mana saja. Ia tidak mengambil input maupun fokus, sehingga menekan menembusnya sampai ke tombol di bawahnya, dan pesan baru menggantikan yang lama. Beri ia lebar: preferred_width(limit) mengembalikan lebar alami teks pendek dan membungkus teks panjang di dalam limit. set_content() menampilkan kontrol apa saja sebagai ganti teks.

GoPromptCard — pertanyaan yang bisa menunggu

var spot := GoHudAnchor.new()
spot.spot = GoHudAnchor.Spot.TOP_CENTER
spot.reserve_space = false
spot.avoid_peers = true            # turun ke bawah bilah darah alih-alih menutupinya
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)

• Ia mulai dalam keadaan tersembunyi — panggil show(). Ia tidak punya pengatur waktu sendiri; tambahkan satu bila pertanyaannya bisa kedaluwarsa.
• Tombol-tombolnya tidak menutupnya — tindakannya yang memutuskan. × (set_closable(true)) memancarkan closed.
• fit_width(width) menyetel lebar dan memperkirakan tingginya dari font, sehingga tidak ada yang ditata terhadapnya melompat satu frame kemudian.
• Mukanya mengikuti hud_alpha — ia bagian dari HUD, bukan sebuah jendela.

GoBanner dan tooltip

GoBanner.make("You're offline.", [{"text": "Retry", "action": reconnect}], GoIconSet.WARNING) berada di dalam halaman itu sendiri, di atas konten, dan tidak pernah kedaluwarsa; sebuah tombol menutupnya kecuali ia punya "keep": true. GoStyle.tooltip_node(text) adalah yang dikembalikan dari _make_custom_tooltip() — engine menggambar pelatnya (TooltipPanel), gohud menggambar teksnya, dibungkus setelah 260dp. Tooltip itu untuk tetikus; jangan pernah menyembunyikan apa yang dibutuhkan pemain di baliknya.

Tur dan konsol

GoCoachMark — tur pada kontrol yang sungguhan

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

• Cincin di sekeliling kontrol yang sungguhan dan kartu di sampingnya. Menekan sasarannya melanjutkan tur (sinyal pressed-nya, atau "signal" pada langkah itu); Lanjut dan Lewati ada di kartu. Sasaran yang tersembunyi dilewati.
• Kartunya menjauh dari tengah layar (avoid_center_band), dari anchor HUD, dan dari keep_clear.
• Selama ada GoSurface yang terbuka, tur bersembunyi dan menunggu. Kembali atau Escape mengakhirinya dengan finished(false).
• Ia tidak punya lapisan sendiri — tambahkan paling akhir, atau di lapisan di atas HUD.

GoConsole — cheat selama pengembangan

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

Lapisan 200 — di atas segalanya, jadi Anda bisa men-debug di atas dialog — dan ia tetap berjalan saat tree dijeda. Sebuah palet menyarankan perintah selagi Anda mengetik; Atas dan Bawah menelusuri riwayat; Escape menutupnya. Tidak ada tombol bawaan: pasang tombol Anda sendiri.

Lapisan, Kembali, dan input

Tiga aturan menentukan apa yang bisa disentuh pemain selagi sesuatu terbuka: apa yang ada di paling atas, siapa pemilik Kembali, dan siapa yang menerima ketukan.

Apa yang ada di paling atas

Urutan ini disengaja: snackbar melaporkan apa yang baru terjadi, jadi ia harus terbaca di atas laci; popover milik apa yang baru ditekan, jadi ia berada di atasnya; dialog mengajukan pertanyaan dan menutupi keduanya; konsol menutupi segalanya, karena itulah yang Anda buka ketika semua yang lain sudah kacau.

Siapa pemilik Kembali

• Hanya jendela teratas yang menjawab. Di antara jendela yang terbuka, yang berada di lapisan tertinggi (lalu yang terbaru di tree) menerima Escape, tombol batal gamepad (ui_cancel), tombol Kembali Android, dan ketukan pada selubung. Jendela yang bertumpuk tertutup satu per satu, tidak pernah bersamaan.
• Tombol Kembali Android ditangani satu frame kemudian, sehingga satu tekanan tidak pernah menutup dua jendela.
• Selama masih ada pemilik Kembali yang terbuka, tombol Kembali Android tidak keluar dari aplikasi (GoBackPolicy menghitung pemiliknya dan memulihkan quit_on_go_back setelah yang terakhir). Popup buatan Anda yang menerima Kembali sebaiknya memanggil GoBackPolicy.acquire() dan release() — di _exit_tree juga.
• Laci, tur coach mark, dan formulir mengalah selagi ada jendela yang terbuka — Kembali pergi ke jendela itu lebih dulu.
• GoConfig.close_on_back (menyala) adalah sakelarnya untuk jendela-jendela itu.

Siapa yang menerima ketukan

• Sebuah jendela menutupi seluruh layar dan menghentikan input — selubung transparan juga. Tak ada apa pun di lapisan yang lebih rendah yang tertekan selagi ia terbuka; lapisan di atasnya (sebuah snackbar) tetap bisa ditekan.
• Roda tetikus dan gestur cubit juga berhenti di jendela itu: menggulir melewati ujung daftar tidak pernah menggulir game.
• Input permainan yang tidak melewati kontrol — _unhandled_input untuk gerakan, seretan kamera — sebaiknya berhenti sejenak: if GoSurface.is_any_open(): return. Itu mencakup dialog, lembar, popover, dan combobox; untuk laci tanyakan is_open() secara terpisah.
• Snackbar, pemberitahuan, kartu ajakan, dan coach mark hanya menerima input di kartunya sendiri; di tempat lain, game yang menerimanya.

Fokus

Jendela yang dibuka dengan pointer tidak memfokuskan apa pun — tidak ada cincin fokus yang berkedip saat disentuh. Bila dibuka dari papan ketik atau gamepad, tombol tutup (atau initial_focus) mengambil fokus. Fokus tetap di dalam jendela selama ia terbuka dan kembali ke kontrol yang tadi memegangnya saat jendela ditutup. Dialog selalu memfokuskan OK.

Menjeda game

Menjeda tree juga menjeda popup — hanya konsol yang tetap bekerja. Untuk menu jeda, beri lapisannya process_mode = PROCESS_MODE_ALWAYS; maka jendela, tombol-tombolnya, dan Kembali tetap berjalan selagi game berhenti.

Popup yang sama di setiap tampilan

Konfirmasi dari bagian atas halaman ini, di atas game yang sama, dengan hanya presetnya yang diganti. Kodenya identik — tema, skin, dan ikon mengerjakan sisanya.

Apa yang diubah setiap tampilan

Mendandani popup dari skin

Skin menentukan bagian-bagian yang tak terjangkau Theme. Hook berikut adalah yang dipanggil popup — timpa di subkelas GoSkin milik Anda; secara default semuanya tidak melakukan apa-apa.

Seberapa tembus pandang

Setiap jenis popup mengikuti opasitasnya sendiri, sehingga kartu HUD bisa tetap ringan sementara dialog tetap pejal: jendela, lembar, dialog, popover, dan combobox mengikuti panel_alpha; laci dan kartu coach card_alpha; kartu ajakan dan konsol hud_alpha; snackbar dan pemberitahuan notice_alpha; menu popup_alpha. Material dan kids membuat semuanya buram; comic juga, kecuali kartu ajakan dan konsol yang 92%, dan arcade, kecuali keduanya yang 94%. Timpa satu jenis dengan GoConfig.container_alpha_overrides, semuanya dengan container_alpha (sebuah rasio — 0.95), atau satu jendela dengan alpha-nya. Hanya mukanya yang memudar; teks tidak pernah tembus pandang. Opasitas secara rinci →

Setelan yang membentuk setiap popup

Kolom-kolom GoConfig (GoUi.config). Beberapa disalin saat sebuah jendela dibuat, jadi setel sebelum membangun UI — atau panggil GoUi.refresh() setelah mengubahnya.

Resep

Salin, tempel, ganti kata-katanya. Setiap pemanggilan di sini diperiksa terhadap kode sumbernya.

Pembelian yang menyebutkan harganya

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)

Jendela setelan dengan tombol Simpan yang menempel

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)

Formulir yang mengatakan apa yang salah

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

Tanggal di dalam lembar

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 jeda

func pause() -> void:
    get_tree().paused = true
    var layer := CanvasLayer.new()
    layer.layer = 50
    layer.process_mode = Node.PROCESS_MODE_ALWAYS      # tetap berjalan selagi game dijeda
    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 yang menunggu popup

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

Jebakan

• GoSurface tidak pernah membebaskan dirinya sendiri. Sambungkan close_requested, atau × tidak melakukan apa-apa.
• Opsi yang disetel setelah add_child — scrim_transparent, show_header, resizable, scroll_body, serta layer_index dan max_width milik GoDialogs — tidak diterapkan.
• confirm() kedua langsung mengembalikan false. Nyalakan queue_when_busy bila dua pertanyaan bisa bertemu.
• Enter mengonfirmasi. OK memegang fokus, pada dialog destruktif juga.
• Kembali pada lembar menutup lembarnya, bukan subhalamannya.
• Escape tidak menutup laci, dan is_any_open() tidak melihatnya.
• Popover atau daftar combobox memblokir game sampai ditutup, bahkan dengan selubung transparan — dan popover dengan dismissable = false tanpa judul tidak punya apa pun di layar yang bisa menutupnya.
• Kartu ajakan mulai dalam keadaan tersembunyi dan tidak punya batas waktu.
• Snackbar dengan seconds: 0 tanpa tombol tidak pernah pergi. Dan secara default ia menangkap ketukan pada kartunya.
• Tekan lama yang tak diketahui siapa pun adalah fitur yang tak dipakai siapa pun. Tampilkan juga ⋯.
• Tree yang dijeda menjeda popup Anda. Pakai PROCESS_MODE_ALWAYS pada lapisannya.
• Pemberitahuan tanpa lebar menyusut ke bentuk tersempitnya — pakai preferred_width().
• Jangan pernah bertanya lewat snackbar, jangan pernah sekadar memberi kabar lewat dialog. Pertanyaan lenyap bila diabaikan; kabar tidak semestinya menghentikan game.