ポップアップとダイアログ

ふさわしいポップアップを選ぶ

ポップアップは流れを断ち切る。選ぶ前に、ひとつの問いにだけ答える：ゲームが先へ進む前に、プレイヤーが 必ず答えなければならないか？ そうなら塞ぐ。そうでないなら決して塞がない — 頼んでもいない知らせでゲームを止める カードは、プレイヤーにゲームを閉じさせるいちばんの近道だ。

1. 答えのある問い — 購入、削除、退出、上書き → GoDialogs.confirm()。確認してもらうだけのこと → alert()。いくつかから1つ → choose()。
2. それ自体が1つの画面 — 設定、キャラクターシート、ショップのアイテム → 画面中央の GoSurface。
3. 長いリストや管理画面 — かばん、メール、フレンド → スマホでは下から出る GoSheet、広い画面では横から出る GoDrawer。
4. 今押したものについての情報 — アイテムのステータス、できる操作 → その脇に出る GoPopover か GoContextMenu。
5. ゲームを止めずに伝えられる知らせ — 保存した、捨てた、招待された → GoSnackbar、GoNotice、GoPromptCard。これらは画面を占領しない。
6. 操作を教える → GoCoachMark。開発中のチート → GoConsole。

すべてのポップアップを一覧で

それぞれがどのレイヤーで開くか、なぜその順なのかは レイヤー、戻る、入力 にある。

このページの画像はすべて同じ小さなゲームだ — 左上に体力とマナ、右上にコイン、下にスティックとクイックスロット3つ — を default_dark で表示し、その上にポップアップを1つ開いている。同じ ポップアップを14の見た目で →

ポップアップの構造

gohud でゲームを塞ぐポップアップのほとんど — ダイアログ、シート、ポップオーバー、コンボボックスのリスト、 自作のウィンドウ — は1つのノード、GoSurface だ。その部品を一度覚えれば、全部が分かる。

await で受け取るダイアログ

GoDialogs は尋ねて、待つ。ノード1つに問いが3種類 — 答えが同じ行に返ってくるので、 コードがプレイヤーの体験する順に読める。

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

3種類の問い

confirm(title, body, ok_text := "", cancel_text := "", extra := "",
        args := {}, destructive := false) -> bool
alert(title, body, ok_text := "", extra := "", args := {})      # 待つなら await する
choose(title, options: Array, cancel_text := "", translate := false) -> int
confirm_key(…) · alert_key(…)                                 # 翻訳キー

ボタンの文言を空にすると、キット自身の言葉（GoConfig.text_keys の confirm、cancel）になる。 extra は本文の下に改行して足される。args はタイトルと本文の {placeholders} を 埋める：confirm("Buy {item}?", "It costs {price} gold.", "Buy", "", "", {"item": name, "price": 300})。

どう抜けても答えが返る

だから await の後のコードは必ず実行される — ダイアログの下でシーンが変わっても、答えが宙に浮いたまま残ることはない。

取り消せない操作

元に戻せないことには destructive = true を渡す。OK ボタンが塗りつぶしの Tone.DANGER_SOLID ボタンになる — どの見た目でも赤地に白文字だ。淡く色を付けた危険ラベルでは、ライトテーマで 読めるようにするためにほぼ黒まで暗くするしかない。ウィンドウは使い回されるので、トーンは呼ぶたびに設定し直される。

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

ボタンの並べ方

action_gap はボタンどうしの間隔、body_gap はその上の間隔だ — ボタン間より広くとると、 問いと選択肢が2つの部分として読める。1つのダイアログにだけ効かせたいときは、開く前に set_next_action_layout() を呼ぶ。alert のボタン1つは常に全幅をとる。

一度に1つ

1つ開いている間に2つめの confirm() を呼ぶと、即座に false が返る — ダイアログがうっかり ダイアログの上に積み重なることはない。queue_when_busy を有効にすると、代わりに順番を待つ。alert() は常に待つ。 queue_limit（8）が待ち行列の長さを抑え、あふれると最も古い要求に false が返る。 pending() は待っている要求を数え、clear_pending() はそのすべてに false を返す。 choose() は並ばない：すでにダイアログが開いていれば -1 を返す。

スマホとデスクトップ

choose() は Android と iOS では親指の届く下からシートとして、デスクトップでは中央のカードとして 開く。確認は幅が max_width（420dp）で抑えられ、中央に置かれる。layer_index、 max_width などの export は add_child の前に設定する。ノードがツリーに入るときに適用されるからだ。

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 — 自作のウィンドウ

ポップアップが問い以上のもの — 設定、キャラクターシート、購入するアイテム — になるなら、 GoSurface の上に組む。セーフエリア、キーボード、固定の行、スクロール、戻る、フォーカス、サイズ変更はもう済んでいる。

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)

3つの配置

ANCHOR には anchor_control が要る。カードは anchor_min_width が収まればその右に、 収まらなければ広いほうの側に、それも無理なら画面の内側に置かれ、上の余地のほうが大きければ上向きに開く。動くアンカーには 毎フレーム追従する。大きさは anchor_width（320）と anchor_max_height（520）で決まる。

どこまで大きくなるか

上限を超える比率は切り詰められ、デバッグビルドで一度だけ警告が出る。キーボードはカードを押し上げ、フォーカスのある 入力欄が見えるようにスクロールする。セーフエリアのおかげで、Android と iOS でもノッチやジェスチャーバーにかからない。

プロパティ

シグナルと呼び出し

シートとドロワー

場所の要るリストは、縦に持ったスマホでは親指のある下からせり上がり、タブレットやデスクトップでは 横から入ってくる — そこではシートがゲームを覆ってしまうからだ。

GoSheet — 下から出るページ

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

• BOTTOM 配置でサイズ変更できる GoSurface を持つ CanvasLayer（レイヤー10）だ — だから HUD より上に出て、プレイヤーはドラッグで高くできる。
• open(title) は新しいページを始める：本文、ツールバー、戻るボタンをクリアし、add_footer() で足したものを 解放する。同じシートで別のページを見せるには、もう一度呼ぶ。set_back() は最初のページへ戻るための戻るボタンを 表示する。open_key() は翻訳キーを受け取る。
• close() は隠す — 解放はしないので、次の open() は即座に開く。いつ起きたかは closed と page_changed が知らせる。
• height_ratio（0.6）は開くときの高さ、max_height_ratio は上限を引き上げる。dismissable （true）なら幕のタップで閉じる。

GoDrawer — 横から

var drawer := GoDrawer.new()
drawer.side = GoDrawer.Side.LEFT
drawer.follow_text_direction = true      # 始まりの側：左、アラビア語では右
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")

• レイヤー80。幅は画面の42%（width_ratio）で、min_width（320dp）と max_width （420dp）の間だ — スマホでは画面の大半を覆うので、そこではシートのほうがよい。
• パネルは画面の端まで届き、中身だけがセーフエリアの内側に入る。だから丸めた角が最初の行を切り落とさない。
• LEFT はアラビア語でも画面の左だ。「始まりの側」であることが要点なら follow_text_direction を 有効にする。実際にどちらに出たかは effective_side() が教えてくれる。
• open(title) は本文をそのまま残す — 一度だけ埋める。set_title("") はヘッダーを隠す。 motion_seconds（0.2）で滑り込み、reduce_motion なら即座に出る。

コントロールの脇に出るカードとメニュー

プレイヤーが今押したものには、画面の真ん中ではなく指のすぐ横で答えるべきだ。

GoPopover — 押したものに付くカード

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

レイヤー、アンカー、後片付けまで配線済みの ANCHOR サーフェスだ — どのゲームも何度も書く、あの10行である。 一度に1つ：2つめを開くと1つめが閉じる。カードが積み重なると画面が埋まり、どのカードがどのスロットのものか 誰にも分からなくなるからだ。幕は透明だ — 装備を見比べるために開いたカードが、その装備を暗くしてはならない — が、外側の最初のタップは受け止める。そのタップはカードを閉じるだけで、先へは届かない。

GoPopover.close() と GoPopover.is_open() は static だ。open() はサーフェスを返す — アンカーがツリーにないときは null なので、await shown.close_requested の前に確かめる。

GoContextMenu — 長押しと右クリック

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

• 右クリックはすぐに開く。指を0.5秒（HOLD_SECONDS）置くと開き、12dp を超えて動くと 取り消す — だからリストをスクロールしてもメニューは出てこない。
• 項目は {text, action, icon, disabled, checked, separator, danger, translate} だ。押したものによって項目が変わるなら、 配列の代わりに Callable を渡す。メニューが開くたびに呼ばれる。
• danger は文言の前に「⚠ 」を付ける — エンジンのメニューは全項目の色をまとめてしか変えられないからだ。
• エンジンの PopupMenu を GoStyle.style_popup() で装ったものだ。開いているサーフェスとしては数えない。

ドロップダウン、セレクト、スプリットボタン

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

3つともエンジンのポップアップメニューを開く：dropdown() は操作を実行する MenuButton、 select() は値を保つ OptionButton、GoSplitButton はメインの操作に矢印側のメニューを 足したもの（chosen(index)）だ。メニューはあえて完全に不透明にしてある — 独立した OS ウィンドウに出るメニューは、 半透明のピクセルを黒くしてしまう。

GoCombobox — 検索できるリスト

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

押すと、レイヤー96に透明な幕とともに脇に留まるリストを開く。項目が search_threshold（8）個以上あると 検索欄が現れてフォーカスを取る。大文字と小文字を区別せず、文言やヒントのどこにでも一致し、結果がなければそう 表示する。リストの幅は list_width（0 = ボタンの幅、最小180dp）で決める。

ゲームを決して止めないポップアップ

プレイしながら読める知らせだ。どれにも幕はない。カードそのもの以外へのタップは ゲームに届く。

GoSnackbar — 「元に戻す」付きのメッセージ

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() は押されたボタンの番号を返し、時間切れや閉じられたときは -1 を返す。投稿は 順番待ちし（queue_limit 4、あふれると最も古いものが -1 で外れる）、表示中に同じ文言をもう一度投稿するとタイマーを 延ばすだけになる。下端（または上端、placement）のセーフエリアとキーボードの上、レイヤー90に出る — ドロワーの上でも 読める。tap_to_dismiss（有効）なら、ボタンのないカードはタップで閉じる。カードの外側のタップは常に ゲームに届く。show_text() と show_key() は1行で書ける形だ。

GoNotice — HUD 上の1行

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)

自分で置く素のパネルだ — GoHudAnchor の中、隅、どこでも。入力もフォーカスも取らないので、 その上を押せば下のボタンに届き、新しいメッセージは古いものを置き換える。幅を与える： preferred_width(limit) は短い文には自然な幅を返し、長い文は limit の中で折り返す。 set_content() は文字の代わりに任意のコントロールを表示する。

GoPromptCard — 待ってくれる問いかけ

var spot := GoHudAnchor.new()
spot.spot = GoHudAnchor.Spot.TOP_CENTER
spot.reserve_space = false
spot.avoid_peers = true            # 体力バーを覆わず、その下へよける
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)

• 隠れた状態で始まる — show() を呼ぶ。自前のタイマーはないので、問いに期限があるなら自分で付ける。
• ボタンを押しても閉じない — どうするかは操作が決める。×（set_closable(true)）は closed を出す。
• fit_width(width) は幅を設定し、フォントから高さを予測する。だから、それに合わせて配置したものが1フレーム後に跳ねない。
• 面は hud_alpha に従う — ウィンドウではなく HUD の一部だ。

GoBanner とツールチップ

GoBanner.make("You're offline.", [{"text": "Retry", "action": reconnect}], GoIconSet.WARNING) はページそのものの中、 コンテンツの上に置かれ、時間切れにならない。ボタンを押すと閉じるが、"keep": true があれば残る。 GoStyle.tooltip_node(text) は _make_custom_tooltip() から返すものだ — 下地（TooltipPanel）は エンジンが、文字は gohud が描き、260dp を超えると折り返す。ツールチップはマウス用だ。プレイヤーに必要なものを決してその陰に隠さない。

ツアーとコンソール

GoCoachMark — 実物のコントロールを巡るツアー

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

• 実物のコントロールを囲むリングと、その脇のカードだ。対象を押すと進む（その pressed シグナル、またはステップの "signal"）。「次へ」と「スキップ」はカードにある。隠れた対象は飛ばされる。
• カードは画面の中央（avoid_center_band）、HUD のアンカー、keep_clear を避けて置かれる。
• GoSurface が1つでも開いている間、ツアーは隠れて待つ。戻るか Escape は finished(false) でツアーを終える。
• 自前のレイヤーを持たない — 最後に追加するか、HUD より上のレイヤーに追加する。

GoConsole — 開発中のチート

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

レイヤー200 — すべての上なので、ダイアログの上からでもデバッグできる — で、ツリーが一時停止していても動き続ける。 打つそばからコマンドを提案するパレットが出て、上下キーで履歴をたどり、Escape で閉じる。組み込みのキーはない：自分で割り当てる。

レイヤー、戻る、入力

何かが開いている間にプレイヤーが何に触れられるかは、3つの規則で決まる：何が上にあるか、 戻るは誰のものか、タップは誰が受けるか。

何が上にあるか

この順には理由がある：スナックバーは今起きたことを知らせるので、ドロワーの上で読める。ポップオーバーは今押したものに 属するので、その上に乗る。ダイアログは問いを投げるので両方を覆う。コンソールはすべてを覆う — ほかが全部おかしくなった ときに開くものだからだ。

戻るは誰のものか

• 答えるのは最前面のウィンドウだけだ。 開いているサーフェスのうち、いちばん高いレイヤーのもの（同じならツリーで最も後のもの）が、 Escape、ゲームパッドのキャンセル（ui_cancel）、Android の戻る、幕のタップを受け取る。重ねたウィンドウは1枚ずつ閉じ、 まとめては閉じない。
• Android の戻るは1フレーム遅れて処理されるので、1回押してウィンドウが2枚閉じることはない。
• 戻るを持つものが開いている間、Android の戻るはアプリを終了しない（GoBackPolicy が持ち主を数え、 最後の1つが閉じると quit_on_go_back を元に戻す）。戻るを受け取る自作のポップアップは GoBackPolicy.acquire() と release() を呼ぶ — _exit_tree でも。
• ドロワー、コーチマークのツアー、フォームは、サーフェスが開いている間は身を引く — 戻るはまずサーフェスに届く。
• GoConfig.close_on_back（有効）がサーフェスのスイッチだ。

タップは誰が受けるか

• サーフェスは画面全体を覆って入力を止める — 透明な幕でもそうだ。開いている間、下のレイヤーにあるものは 何も押せない。上のレイヤー（スナックバー）は押せる。
• マウスホイールやピンチのジェスチャーもウィンドウで止まる：リストの端を越えてスクロールしても、ゲームはスクロールしない。
• コントロールを通らないゲームの入力 — 移動用の _unhandled_input、カメラのドラッグ — は止めるべきだ： if GoSurface.is_any_open(): return。これでダイアログ、シート、ポップオーバー、コンボボックスが含まれる。ドロワーには 別に is_open() を尋ねる。
• スナックバー、通知、プロンプトカード、コーチマークは自分のカードでだけ入力を受ける。それ以外の場所では、ゲームが受け取る。

フォーカス

ポインターで開いたウィンドウは何にもフォーカスを与えない — タッチでフォーカスリングが光ることはない。キーボードやゲームパッドで 開くと、閉じるボタン（または initial_focus）がフォーカスを受ける。開いている間フォーカスはウィンドウの中に留まり、 閉じると、それまでフォーカスを持っていたコントロールへ戻る。ダイアログは毎回 OK にフォーカスを置く。

ゲームの一時停止

ツリーを一時停止するとポップアップも止まる — 動き続けるのはコンソールだけだ。ポーズメニューなら、そのレイヤーに process_mode = PROCESS_MODE_ALWAYS を与える。すると、ゲームが止まっている間もウィンドウ、ボタン、戻るが動き続ける。

すべての見た目で同じポップアップ

このページ冒頭の確認を同じゲームの上に出し、プリセットだけを変えた。コードは同一だ — 残りはテーマ、スキン、アイコンが受け持つ。

見た目ごとに変わるもの

スキンでポップアップを装う

スキンは、Theme が届かない部分を決める。ポップアップが呼ぶのは次のフックだ — 自分の GoSkin サブクラスで上書きする。既定では何もしない。

どこまで透けるか

ポップアップは種類ごとに自分の不透明度に従うので、HUD のカードは軽く、ダイアログはしっかりと保てる：ウィンドウ、シート、 ダイアログ、ポップオーバー、コンボボックスは panel_alpha、ドロワーとコーチマークのカードは card_alpha、 プロンプトカードとコンソールは hud_alpha、スナックバーと通知は notice_alpha、メニューは popup_alpha に従う。 Material とキッズはすべてを不透明にする。コミックも同じだが、プロンプトカードとコンソールだけは 92% だ。アーケードも同じで、その2つだけが 94% になる。1種類だけ変えるなら GoConfig.container_alpha_overrides、全部なら container_alpha（比率 — 0.95）、ウィンドウ1つならその alpha で上書きする。薄くなるのは面だけで、 文字が透けることは決してない。不透明度の詳細 →

すべてのポップアップを形づくる設定

GoConfig（GoUi.config）のフィールドだ。いくつかはウィンドウが作られるときにコピーされるので、 UI を作る前に設定する — あるいは変更後に GoUi.refresh() を呼ぶ。

レシピ

コピーして貼り付け、文言を変える。ここにある呼び出しは、すべてソースと照らし合わせて確かめてある。

価格入りの購入確認

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)

保存ボタンを固定した設定ウィンドウ

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)

何が間違っているかを伝えるフォーム

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

シートで日付を選ぶ

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)

ポーズメニュー

func pause() -> void:
    get_tree().paused = true
    var layer := CanvasLayer.new()
    layer.layer = 50
    layer.process_mode = Node.PROCESS_MODE_ALWAYS      # ゲームが一時停止しても動き続ける
    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)

ポップアップを待つゲームプレイ

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

落とし穴

• GoSurface は自分では解放されない。 close_requested をつながないと、× を押しても何も起きない。
• add_child の後に設定したオプション — scrim_transparent、show_header、resizable、 scroll_body、そして GoDialogs の layer_index と max_width — は適用されない。
• 2つめの confirm() は即座に false を返す。 2つの問いが重なりうるなら queue_when_busy を有効にする。
• Enter で確定する。 取り消せないダイアログでも OK にフォーカスがある。
• シートで戻るを押すと、シートが閉じる。 サブページが閉じるのではない。
• Escape はドロワーを閉じず、 is_any_open() もドロワーを見ない。
• ポップオーバーやコンボボックスのリストは、閉じるまでゲームを塞ぐ。 幕が透明でもそうだ — しかも dismissable = false でタイトルのないポップオーバーには、画面上に閉じる手段がない。
• プロンプトカードは隠れた状態で始まり、 時間切れもない。
• seconds: 0 でボタンのないスナックバーは、いつまでも消えない。 しかも既定では自分のカードへのタップを受け取る。
• 誰も知らない長押しは、誰も使わない機能だ。 ⋯ も表示する。
• 一時停止したツリーはポップアップも止める。 そのレイヤーに PROCESS_MODE_ALWAYS を使う。
• 幅のない通知は いちばん狭く縮む — preferred_width() を使う。
• スナックバーで尋ねず、ダイアログで知らせない。 無視された問いは消えてしまうし、知らせのためにゲームを止めるべきではない。