Açılır pencereler ve iletişim kutuları

Doğru açılır pencereyi seçin

Bir açılır pencere oyunun akışını keser. Birini seçmeden önce tek bir soruyu yanıtlayın: oyun devam etmeden önce oyuncunun yanıt vermesi gerekiyor mu? Evet ise engelleyin. Hayır ise asla engellemeyin — oyuncunun istemediği bir haber için oyunu durduran bir kart, oyununuzu kapattırmanın en hızlı yoludur.

1. Yanıtı olan bir soru — satın al, sil, ayrıl, üzerine yaz → GoDialogs.confirm(). Görülüp onaylanacak bir bilgi → alert(). Birkaç seçenekten biri → choose().
2. Kendine ait bir ekran — ayarlar, karakter sayfası, mağazadaki bir eşya → ekranın ortasında bir GoSurface.
3. Uzun bir liste ya da bir yönetim sayfası — çanta, posta, arkadaşlar → telefonda alttan GoSheet, geniş ekranda yandan GoDrawer.
4. Az önce basılan şeyle ilgili bir şey — bir eşyanın özellikleri, eylemleri → hemen yanında GoPopover ya da GoContextMenu.
5. Oyun sürerken verilebilecek haberler — kaydedildi, düşürüldü, davet edildin → GoSnackbar, GoNotice ya da GoPromptCard. Bunlar ekranı asla ele geçirmez.
6. Denetimleri öğretmek → GoCoachMark. Geliştirirken hileler → GoConsole.

Tüm açılır pencereler bir bakışta

Her birinin hangi katmanda açıldığı ve sıranın neden böyle olduğu Katmanlar, Geri ve girdi bölümünde.

Bu sayfadaki her görüntü aynı küçük oyundur — sol üstte can ve mana, sağ üstte altınlar, altta bir joystick ve üç hızlı slot — default_dark ile, üstünde tek bir açılır pencere açık. Aynı açılır pencere on dört görünümün hepsinde →

Bir açılır pencerenin anatomisi

gohud'daki engelleyen açılır pencerelerin neredeyse tamamı — iletişim kutuları, alt sayfalar, popover'lar, combobox listesi ve kendi pencereleriniz — tek bir düğümdür: GoSurface. Parçalarını bir kez öğrenin, hepsini bilirsiniz.

await ettiğiniz iletişim kutuları

GoDialogs sorar ve bekler. Tek düğüm, üç soru — ve yanıt aynı satıra geri gelir; böylece kod, oyuncunun yaşadığı sırayla okunur.

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

Üç soru

confirm(title, body, ok_text := "", cancel_text := "", extra := "",
        args := {}, destructive := false) -> bool
alert(title, body, ok_text := "", extra := "", args := {})      # beklemek için await edin
choose(title, options: Array, cancel_text := "", translate := false) -> int
confirm_key(…) · alert_key(…)                                 # çeviri anahtarları

Boş düğme etiketleri kitin kendi sözcüklerine döner (GoConfig.text_keys içindeki confirm, cancel). extra gövdeye yeni bir satırda eklenir. args, başlıktaki ve gövdedeki {placeholders} yer tutucularını doldurur: confirm("Buy {item}?", "It costs {price} gold.", "Buy", "", "", {"item": name, "price": 300}).

Her çıkış yolunun bir yanıtı var

Bu yüzden await sonrasındaki kod her zaman çalışır — sahne iletişim kutusunun altında değişse bile hiçbir yanıt askıda kalmaz.

Geri alınamayan eylemler

Geri alınamayacak bir şey için destructive = true verin. Tamam düğmesi dolgulu Tone.DANGER_SOLID düğmesine dönüşür — her görünümde kırmızı üstünde beyaz; tonlanmış bir tehlike etiketi ise açık bir temada okunaklı kalmak için neredeyse siyaha kadar koyulaşmak zorunda kalırdı. Pencere yeniden kullanıldığı için ton her çağrıda sıfırlanır.

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

Düğme yerleşimi

action_gap düğmeler arasındaki boşluk, body_gap ise üstlerindeki boşluktur — soru ile seçimin iki ayrı parça olarak okunması için bunu düğme boşluğundan geniş tutun. Yalnızca tek bir iletişim kutusu için, açmadan önce set_next_action_layout() çağırın. Bir uyarının tek düğmesi her zaman tam genişliği alır.

Aynı anda bir tane

Biri açıkken çağrılan ikinci bir confirm() anında false döndürür — bir iletişim kutusu kazara başka birinin üstüne yığılmaz. queue_when_busy açıksa bunun yerine sırasını bekler; alert() her zaman bekler. queue_limit (8) sırayı sınırlar; sıra taşarsa en eski istek false ile yanıtlanır. pending() bekleyen istekleri sayar, clear_pending() hepsini false ile yanıtlar. choose() asla sıraya girmez: bir iletişim kutusu zaten açıksa -1 döndürür.

Telefon ve masaüstü

choose() Android ve iOS'ta başparmağın olduğu yerde, alttan bir sayfa olarak açılır; masaüstünde ise ortada bir kart olarak. Bir onay max_width (420dp) ile sınırlanır ve ortalanır. layer_index, max_width ve diğer dışa aktarılan özellikleri add_child çağrısından önce ayarlayın; düğüm ağaca girdiğinde uygulanırlar.

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 — kendi pencereniz

Bir açılır pencere bir sorudan fazlası olduğunda — ayarlar, karakter sayfası, satın alınacak bir eşya — onu GoSurface üzerine kurun. Güvenli alan, sanal klavye, sabit satırlar, kaydırma, Geri, odak ve yeniden boyutlandırma hazırdır.

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)

Üç yerleşim

ANCHOR için anchor_control gerekir. anchor_min_width sığıyorsa kart denetimin sağına yerleşir, sığmıyorsa daha geniş tarafa, o da olmazsa ekranın içine; üstte daha çok yer varsa yukarı doğru açılır. Hareket eden bir anchor'ı her karede izler. Boyutunu anchor_width (320) ve anchor_max_height (520) belirler.

Ne kadar büyür

Üst sınırı aşan bir oran geri kırpılır; hata ayıklama derlemesinde bir kez uyarı verilir. Sanal klavye kartı yukarı iter ve odaktaki alanı görünür hâle kaydırır; güvenli alan kartı Android ve iOS'ta çentikten ve hareket çubuğundan uzak tutar.

Özellikler

Sinyaller ve çağrılar

Alt sayfalar ve çekmeceler

Yer isteyen bir liste, dik tutulan bir telefonda başparmağın olduğu yerden, yani alttan gelir; tablette ya da masaüstünde ise yandan gelir, çünkü orada bir alt sayfa oyunun üstünü kaplardı.

GoSheet — alttan gelen sayfalar

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

• İçinde BOTTOM yerleşimli, yeniden boyutlandırılabilir bir GoSurface taşıyan bir CanvasLayer'dır (katman 10) — böylece HUD'ın üstünde durur ve oyuncu onu sürükleyerek uzatabilir.
• open(title) yeni bir sayfa başlatır: gövdeyi, araç çubuğunu ve geri düğmesini temizler, add_footer() ile eklenenleri bellekten siler. Aynı alt sayfada başka bir sayfa göstermek için yeniden çağırın; set_back() başa dönüş için bir geri düğmesi gösterir. open_key() bir çeviri anahtarı alır.
• close() onu gizler — bellekten silinmez, bu yüzden bir sonraki open() anında açılır. Ne zaman olduğunu closed ve page_changed bildirir.
• height_ratio (0.6) açıldığı yüksekliktir; max_height_ratio üst sınırı yükseltir; dismissable (true) perdeye dokununca onu kapatır.

GoDrawer — yandan

var drawer := GoDrawer.new()
drawer.side = GoDrawer.Side.LEFT
drawer.follow_text_direction = true      # başlangıç tarafı: solda, Arapçada sağda
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")

• Katman 80. Ekran genişliğinin %42'si (width_ratio), min_width (320dp) ile max_width (420dp) arasında — telefonda ekranın çoğunu kaplar; orada alt sayfanın daha iyi bir seçim olmasının nedeni budur.
• Panel ekranın kenarına dayanır; yalnızca içeriği güvenli alana göre içeri çekilir, böylece yuvarlak bir köşe ilk satırı asla kırpmaz.
• LEFT, Arapçada bile ekranın solu demektir. Asıl mesele "başlangıç tarafı" olduğunda follow_text_direction'ı açın; nereye yerleştiğini effective_side() söyler.
• open(title) gövdeyi korur — bir kez doldurun. set_title("") başlık satırını gizler. motion_seconds (0.2) kayarak gelmesini sağlar; reduce_motion bunu anlık yapar.

Bir denetimin yanındaki kartlar ve menüler

Oyuncunun az önce bastığı şey, ekranın ortasında değil, parmağın hemen yanında bir yanıtı hak eder.

GoPopover — basılan şeyin üstünde bir kart

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

Katmanı, anchor'ı ve kapanıştaki temizliği önceden bağlanmış bir ANCHOR yüzeyi — her oyunun tekrar tekrar yazdığı o on satır. Aynı anda bir tane: ikincisini açmak ilkini kapatır, çünkü üst üste yığılan kartlar ekranı gömer ve hangisinin hangi slota ait olduğu anlaşılmaz. Perde saydamdır — ekipmanı karşılaştırmak için açılan bir kart ekipmanı karartmamalıdır — ama dışarıdaki ilk dokunuşu yine de yakalar; bu dokunuş kartı kapatır ve daha ileri gitmez.

GoPopover.close() ve GoPopover.is_open() statiktir. open() yüzeyi döndürür — anchor ağaçta değilse null; bu yüzden await shown.close_requested yazmadan önce denetleyin.

GoContextMenu — uzun basış ve sağ tık

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

• Sağ tık onu hemen açar. Yarım saniye (HOLD_SECONDS) basılı tutulan bir parmak onu açar; 12dp'den fazla kıpırdamak iptal eder — böylece bir listeyi kaydırmak asla menü açmaz.
• Bir öğe {text, action, icon, disabled, checked, separator, danger, translate} biçimindedir. Girdiler neye basıldığına bağlıysa dizi yerine bir Callable geçin; menü her açıldığında çağrılır.
• danger metnin önüne "⚠ " koyar — motorun menüsü öğelerini ancak hepsini birden renklendirebilir.
• Motorun PopupMenu'sudur ve GoStyle.style_popup() tarafından giydirilir. Açık bir yüzey olarak sayılmaz.

Açılır menüler, seçiciler ve bölünmüş düğme

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

Üçü de motorun açılır menüsünü açar: dropdown() bir eylem çalıştıran bir MenuButton'dır, select() bir değer tutan bir OptionButton, GoSplitButton ise bir ana eylem artı okunun üstünde bir menüdür (chosen(index)). Menüler bilerek tamamen opak tutulur — kendi işletim sistemi penceresinde gösterilen bir menü yarı saydam pikselleri siyaha çevirir.

GoCombobox — arama yapan bir liste

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

Basıldığında 96. katmanda, saydam perdeli, sabitlenmiş bir liste açar. search_threshold (8) girdiden itibaren bir arama alanı belirir ve odağı alır; büyük/küçük harfe bakmadan metnin ya da ipucunun herhangi bir yerinde eşleşir, sonuç boşsa bunu da söyler. Listenin boyutunu list_width (0 = düğmenin genişliği, en az 180dp) belirler.

Oyunu asla durdurmayan açılır pencereler

Oyuncunun oynarken okuyabileceği haberler. Hiçbirinde perde yoktur; kartın kendisi dışında herhangi bir yere dokunuş oyuna gider.

GoSnackbar — Geri al düğmeli bir mesaj

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() basılan düğmenin dizinini, süre dolduysa ya da kapatıldıysa -1 döndürür. Gönderiler sıraya girer (queue_limit 4; taşınca en eskisi -1 ile düşürülür) ve gösterilirken aynı metin yeniden gönderilirse yalnızca zamanlayıcısı yenilenir. Altta (ya da placement ile üstte), güvenli alanın ve sanal klavyenin üstünde, 90. katmanda durur — bir çekmecenin üstünde de okunur. tap_to_dismiss (açık) ile düğmesi olmayan bir karta dokunmak onu kapatır; kartın dışına dokunuş her zaman oyuna ulaşır. show_text() ve show_key() tek satırlık biçimleridir.

GoNotice — HUD üzerinde bir satır

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)

Kendiniz yerleştirdiğiniz sade bir panel — bir GoHudAnchor içinde, bir köşede, istediğiniz yerde. Ne girdi ne de odak alır; bu yüzden üstüne basmak alttaki düğmeye ulaşır ve yeni bir mesaj eskisinin yerini alır. Ona bir genişlik verin: preferred_width(limit) kısa metnin doğal genişliğini döndürür, uzun metni ise limit içinde satıra kaydırır. set_content() metin yerine herhangi bir denetimi gösterir.

GoPromptCard — bekleyebilen bir soru

var spot := GoHudAnchor.new()
spot.spot = GoHudAnchor.Spot.TOP_CENTER
spot.reserve_space = false
spot.avoid_peers = true            # can çubuklarını örtmek yerine altlarına in
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)

• Gizli başlar — show() çağırın. Kendi zamanlayıcısı yoktur; soru zaman aşımına uğrayacaksa bir tane ekleyin.
• Düğmeleri onu kapatmaz — buna eylemler karar verir. × (set_closable(true)) closed yayar.
• fit_width(width) genişliği ayarlar ve yüksekliği yazı tipinden önceden hesaplar; böylece ona göre yerleştirilen hiçbir şey bir kare sonra zıplamaz.
• Yüzü hud_alpha'yı izler — bir pencere değil, HUD'ın bir parçasıdır.

GoBanner ve ipuçları

GoBanner.make("You're offline.", [{"text": "Retry", "action": reconnect}], GoIconSet.WARNING) sayfanın kendisinde, içeriğin üstünde durur ve asla zaman aşımına uğramaz; "keep": true verilmedikçe bir düğme onu kapatır. GoStyle.tooltip_node(text), _make_custom_tooltip()'tan döndürmeniz gereken şeydir — plakayı motor (TooltipPanel), metni gohud çizer ve 260dp'yi geçen metin satıra kaydırılır. İpuçları fare içindir; oyuncunun ihtiyaç duyduğu bir şeyi asla bir ipucunun arkasına saklamayın.

Turlar ve konsol

GoCoachMark — gerçek denetimlerde bir tur

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

• Gerçek denetimin çevresinde bir halka ve yanında bir kart. Hedefe basmak turu ilerletir (onun pressed sinyali ya da adımdaki "signal"); İleri ve Atla kartın üstündedir. Gizli bir hedef atlanır.
• Kart ekranın ortasından (avoid_center_band), HUD anchor'larından ve keep_clear'dan uzak durur.
• Herhangi bir GoSurface açıkken tur gizlenir ve bekler. Geri ya da Escape onu finished(false) ile bitirir.
• Kendi katmanı yoktur — onu en son ekleyin ya da HUD'ın üstündeki bir katmana koyun.

GoConsole — geliştirirken hileler

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

Katman 200 — her şeyin üstünde, böylece bir iletişim kutusunun üzerinde hata ayıklayabilirsiniz — ve ağaç duraklatılmışken de çalışmaya devam eder. Bir palet siz yazdıkça komut önerir; Yukarı ve Aşağı tuşları geçmişte gezinir; Escape onu kapatır. Yerleşik bir tuşu yoktur: kendinizinkini atayın.

Katmanlar, Geri ve girdi

Bir şey açıkken oyuncunun neye dokunabileceğine üç kural karar verir: en üstte ne var, Geri kimin, bir dokunuşu kim alır.

En üstte ne durur

Sıra bilinçlidir: bir snackbar az önce olanı bildirir, bu yüzden bir çekmecenin üstünde okunur; bir popover az önce basılan şeye aittir, bu yüzden onun üstünde durur; bir iletişim kutusu soru sorar ve ikisini de örter; konsol her şeyi örter, çünkü geri kalan her şey ters gittiğinde açtığınız şey odur.

Geri kimin

• Yalnızca en üstteki pencere yanıt verir. Açık yüzeyler arasında en yüksek katmandaki (eşitse ağaçta en son gelen) Escape'i, oyun kumandasının iptal tuşunu (ui_cancel), Android Geri'yi ve perdeye dokunuşları alır. Üst üste açılmış pencereler teker teker kapanır, asla birlikte değil.
• Android Geri bir kare sonra ele alınır; böylece tek bir basış asla iki pencereyi kapatamaz.
• Geri'nin sahibi olan herhangi bir şey açıkken Android Geri uygulamadan çıkmaz (GoBackPolicy sahipleri sayar ve sonuncusu kapanınca quit_on_go_back'i geri yükler). Geri'yi alan kendi açılır pencereniz GoBackPolicy.acquire() ve release() çağırmalıdır — _exit_tree içinde de.
• Bir yüzey açıkken çekmece, rehber işareti turu ve form kenara çekilir — Geri önce yüzeye gider.
• GoConfig.close_on_back (açık) yüzeyler için açma/kapama anahtarıdır.

Dokunuşu kim alır

• Bir yüzey tüm ekranı kaplar ve girdiyi durdurur — saydam bir perde de. O açıkken alt katmanlardaki hiçbir şeye basılmaz; üstündeki katmanlara (bir snackbar) yine basılabilir.
• Fare tekerleği ve iki parmakla yakınlaştırma hareketleri de pencerede durur: bir listenin sonunu geçecek kadar kaydırmak oyunu asla kaydırmaz.
• Denetimlerden geçmeyen oyun girdisi — hareket için _unhandled_input, bir kamera sürüklemesi — beklemelidir: if GoSurface.is_any_open(): return. Bu, iletişim kutularını, alt sayfaları, popover'ları ve combobox'ı kapsar; çekmeceye is_open() ile ayrıca sorun.
• Snackbar, bildirim, soru kartı ve rehber işareti girdiyi yalnızca kendi kartlarında alır; geri kalan her yerde girdi oyuna gider.

Odak

İşaretçiyle açılan bir pencere hiçbir şeye odaklanmaz — bir dokunuşta odak halkası yanıp sönmez. Klavyeyle ya da oyun kumandasıyla açıldığında odağı kapatma düğmesi (ya da initial_focus) alır. Pencere açıkken odak onun içinde kalır, pencere kapanınca da odağı önceden elinde tutan denetime geri döner. İletişim kutuları her seferinde Tamam'a odaklanır.

Oyunu duraklatmak

Ağacı duraklatmak açılır pencereleri de duraklatır — yalnızca konsol çalışmaya devam eder. Bir duraklatma menüsü için katmanına process_mode = PROCESS_MODE_ALWAYS verin; o zaman oyun dururken pencere, düğmeleri ve Geri çalışmaya devam eder.

Her görünümde aynı açılır pencere

Bu sayfanın başındaki onay, aynı oyunun üstünde, yalnızca ön ayar değiştirilerek. Kod birebir aynıdır — gerisini tema, kaplama ve simgeler yapar.

Her görünüm neyi değiştirir

Bir açılır pencereyi kaplamayla giydirmek

Kaplama, bir Theme'in erişemediği parçalara karar verir. Açılır pencerelerin çağırdığı kancalar bunlardır — onları kendi GoSkin alt sınıfınızda ezin; varsayılan olarak hiçbir şey yapmazlar.

Ne kadar saydam

Her açılır pencere türü kendi opaklığını izler; böylece bir HUD kartı hafif kalırken bir iletişim kutusu katı kalabilir: pencereler, alt sayfalar, iletişim kutuları, popover'lar ve combobox panel_alpha'yı; çekmece ve rehber kartı card_alpha'yı; soru kartları ve konsol hud_alpha'yı; snackbar'lar ve bildirimler notice_alpha'yı; menüler popup_alpha'yı izler. Material ve Kids hepsini opak yapar; Comic de öyle, yalnızca soru kartları ve konsol %92'dir; Arcade de öyle, yalnızca bu ikisi %94'tür. Tek bir türü GoConfig.container_alpha_overrides ile, hepsini container_alpha ile (bir oran — 0.95), tek bir pencereyi de kendi alpha değeriyle geçersiz kılın. Yalnızca yüz solar; metin asla saydamlaşmaz. Opaklık ayrıntılı olarak →

Her açılır pencereyi biçimlendiren ayarlar

GoConfig (GoUi.config) alanları. Birkaçı pencere oluşturulurken kopyalanır; bu yüzden onları arayüzü kurmadan önce ayarlayın — ya da değiştirdikten sonra GoUi.refresh() çağırın.

Tarifler

Kopyalayın, yapıştırın, sözcükleri değiştirin. Buradaki her çağrı kaynak koda karşı denetlenmiştir.

Fiyatı içinde yazan bir satın alma

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)

Kaydet düğmesi sabit bir ayarlar penceresi

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)

Neyin yanlış olduğunu söyleyen bir form

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

Alt sayfada bir tarih

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)

Bir duraklatma menüsü

func pause() -> void:
    get_tree().paused = true
    var layer := CanvasLayer.new()
    layer.layer = 50
    layer.process_mode = Node.PROCESS_MODE_ALWAYS      # oyun duraklatılmışken de çalışmaya devam eder
    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)

Açılır pencereleri bekleyen oynanış

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

Tuzaklar

• Bir GoSurface kendini asla bellekten silmez. close_requested'i bağlayın, yoksa × hiçbir şey yapmaz.
• add_child sonrasında ayarlanan seçenekler — scrim_transparent, show_header, resizable, scroll_body ve GoDialogs'un layer_index ile max_width değerleri — uygulanmaz.
• İkinci bir confirm() anında false döndürür. İki soru çakışabiliyorsa queue_when_busy'yi açın.
• Enter onaylar. Odak Tamam'dadır, geri alınamayan eylemlerin iletişim kutularında da.
• Alt sayfada Geri, alt sayfayı kapatır, iç sayfayı değil.
• Escape bir çekmeceyi kapatmaz, is_any_open() da onu görmez.
• Bir popover ya da combobox listesi kapanana dek oyunu engeller, saydam bir perdeyle bile — ve dismissable = false verilmiş, başlığı olmayan bir popover'ı ekrandaki hiçbir şey kapatmaz.
• Bir soru kartı gizli başlar ve zaman aşımı yoktur.
• seconds: 0 verilmiş ve düğmesi olmayan bir snackbar asla gitmez. Üstelik varsayılan olarak kartına gelen dokunuşları yakalar.
• Kimsenin bilmediği bir uzun basış, kimsenin kullanmadığı bir özelliktir. Yanında bir ⋯ da gösterin.
• Duraklatılmış bir ağaç açılır pencerenizi de duraklatır. Katmanında PROCESS_MODE_ALWAYS kullanın.
• Genişliği verilmemiş bir bildirim en dar hâline büzülür — preferred_width() kullanın.
• Snackbar'da asla soru sormayın, iletişim kutusunda asla bilgi vermeyin. Görmezden gelinen bir soru kaybolur gider; haber oyunu durdurmamalıdır.