النوافذ المنبثقة ومربعات الحوار

اختر النافذة المنبثقة المناسبة

النافذة المنبثقة تقاطع اللاعب. وقبل أن تختار واحدة، أجب عن سؤال واحد: هل يجب أن يجيب اللاعب قبل أن تمضي اللعبة؟ إن كان الجواب نعم، فاحجب. وإن كان لا، فلا تحجب أبدًا — فبطاقة توقف اللعبة لتنقل خبرًا لم يطلبه اللاعب هي أسرع طريقة لتجعله يغلق لعبتك.

1. سؤال له جواب — شراء، حذف، مغادرة، كتابة فوق حفظ ← GoDialogs.confirm(). أمر يجب الإقرار به ← alert(). واحد من خيارات قليلة ← choose().
2. شاشة قائمة بذاتها — الإعدادات، صفحة الشخصية، غرض في المتجر ← GoSurface في وسط الشاشة.
3. قائمة طويلة أو صفحة إدارة — الحقيبة، البريد، الأصدقاء ← GoSheet من الأسفل على الهاتف، وGoDrawer من الجانب على الشاشة العريضة.
4. شيء يخصّ ما ضُغط عليه للتو — إحصاءات غرض، وما يمكن فعله به ← GoPopover أو GoContextMenu بجانبه.
5. خبر تستطيع اللعبة أن تمضي معه — تمّ الحفظ، أُسقط غرض، وصلت دعوة ← GoSnackbar أو GoNotice أو GoPromptCard. وهذه لا تستولي على الشاشة أبدًا.
6. تعليم أدوات التحكم ← GoCoachMark. أوامر الغشّ أثناء البناء ← GoConsole.

كل النوافذ المنبثقة في لمحة

على أي طبقة تُفتح كل واحدة، ولماذا بهذا الترتيب، تجده في الطبقات وزر الرجوع والإدخال.

كل صورة في هذه الصفحة هي اللعبة الصغيرة نفسها — الصحة والمانا أعلى اليسار، والعملات أعلى اليمين، وعصا توجيه وثلاث خانات سريعة في الأسفل — بالنمط الجاهز default_dark، وفوقها نافذة منبثقة واحدة مفتوحة. النافذة المنبثقة نفسها بالمظاهر الأربعة عشر كلها ←

تشريح النافذة المنبثقة

كل نافذة منبثقة حاجبة تقريبًا في gohud — مربعات الحوار والأوراق والبطاقات المنبثقة وقائمة المنتقي ونوافذك أنت — هي عقدة واحدة: GoSurface. تعلّم أجزاءها مرة واحدة فتعرفها كلها.

مربعات حوار تنتظرها بـ await

GoDialogs يسأل وينتظر. عقدة واحدة وثلاثة أسئلة — ويعود الجواب على السطر نفسه، فيُقرأ الكود بالترتيب الذي يعيشه اللاعب.

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

الأسئلة الثلاثة

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(…)                                 # بمفاتيح ترجمة

تسميات الأزرار الفارغة تعود إلى كلمات الأداة نفسها (confirm وcancel في GoConfig.text_keys). وextra يُضاف إلى المتن في سطر جديد. وargs يملأ {placeholders} في العنوان والمتن: confirm("Buy {item}?", "It costs {price} gold.", "Buy", "", "", {"item": name, "price": 300}).

لكل مخرج جواب

لذا فالكود بعد await يعمل دائمًا — لا يبقى سؤال معلّقًا بلا جواب أبدًا، حتى حين يتغيّر المشهد من تحت مربع الحوار.

الإجراءات التي لا رجعة فيها

مرّر destructive = true لما لا يمكن التراجع عنه. فيصير زر الموافقة الزرَّ المصمت 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 المسافة فوقها — اجعلها أوسع من مسافة الأزرار ليُقرأ السؤال والاختيار جزأين. ولمربع حوار واحد فقط، استدعِ set_next_action_layout() قبل فتحه. وزرّ التنبيه الوحيد يأخذ العرض الكامل دائمًا.

واحد في كل مرة

استدعاء 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 وسائر الخصائص المصدَّرة قبل 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)

ثلاثة مواضع

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

• هي CanvasLayer (الطبقة 10) تحمل GoSurface من نوع BOTTOM قابلة لتغيير الحجم — فتجلس فوق 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 وقد وُصلت له الطبقةُ والمرساةُ والتفكيكُ سلفًا — تلك الأسطر العشرة التي تكتبها كل لعبة مرارًا وتكرارًا. واحدة في كل مرة: فتح الثانية يغلق الأولى، لأن البطاقات المكدّسة تدفن الشاشة فلا يعرف أحد أي بطاقة تخصّ أي خانة. والحجاب شفاف — فبطاقة فُتحت لمقارنة العتاد يجب ألّا تُعتم العتاد — لكنه يظلّ يلتقط أول نقرة خارجية، فتُغلق البطاقة ولا تمضي النقرة أبعد.

GoPopover.close() وGoPopover.is_open() ساكنتان. و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))

• النقر الأيمن يفتحها فورًا. وإصبع يبقى مضغوطًا نصف ثانية (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"])

الثلاثة كلها تفتح قائمة المحرّك المنبثقة: dropdown() هو MenuButton ينفّذ إجراءً، وselect() هو OptionButton يحتفظ بقيمة، وGoSplitButton إجراء رئيسي مع قائمة على سهمه (chosen(index)). والقوائم تبقى معتمة تمامًا عن قصد — فالقائمة المعروضة في نافذة نظام تشغيل خاصة بها تحوّل البكسلات نصف الشفافة إلى سوداء.

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() هما الصيغتان ذواتا السطر الواحد.

GoNotice — سطر على 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)

لوحة بسيطة تضعها بنفسك — في 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) يضبط العرض ويتنبّأ بالارتفاع من الخط، فلا يقفز شيء مُخطَّط بالنسبة إليها بعد إطار.
• وجهها يتبع 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 مفتوحة تختفي الجولة وتنتظر. وزر الرجوع أو 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 يغلقها. ولا مفتاح مدمجًا لفتحها: اربط مفتاحك أنت.

الطبقات وزر الرجوع والإدخال

ثلاث قواعد تقرّر ما يستطيع اللاعب لمسه بينما شيء ما مفتوح: ما الذي في الأعلى، ومن يملك زر الرجوع، ومن يأخذ النقرة.

ما الذي في الأعلى

الترتيب مقصود: شريط الإشعار يخبر بما حدث للتو، فيُقرأ فوق الدرج؛ والبطاقة المنبثقة تخصّ ما ضُغط للتو، فتجلس فوقه؛ ومربع الحوار يطرح سؤالًا ويغطّي الاثنين؛ ووحدة التحكّم تغطّي كل شيء، لأنها ما تفتحه حين يفسد كل ما عداها.

من يملك زر الرجوع

• النافذة العليا وحدها تجيب. من بين الأسطح المفتوحة، تأخذ التي على أعلى طبقة (ثم الأحدث في الشجرة) مفتاح Escape وإلغاء ذراع التحكم (ui_cancel) وزر الرجوع في Android ونقرات الحجاب. والنوافذ المكدّسة تُغلق واحدة واحدة، لا معًا أبدًا.
• زر الرجوع في Android يُعالَج بعد إطار واحد، فلا تستطيع ضغطة واحدة أن تغلق نافذتين أبدًا.
• ما دام شيء يملك زر الرجوع مفتوحًا، لا يُنهي زر الرجوع في Android التطبيق (GoBackPolicy يعدّ المالكين ويعيد 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) التركيز. ويبقى التركيز داخل النافذة ما دامت مفتوحة، ويعود إلى عنصر التحكم الذي كان يحمله حين تُغلق. ومربعات الحوار تركّز على زر الموافقة في كل مرة.

إيقاف اللعبة مؤقتًا

إيقاف الشجرة مؤقتًا يوقف النوافذ المنبثقة أيضًا — ووحدة التحكّم وحدها تواصل العمل. ولقائمة إيقاف مؤقت، أعطِ طبقتها process_mode = PROCESS_MODE_ALWAYS؛ فتظلّ النافذة وأزرارها وزر الرجوع تعمل واللعبة متوقفة.

النافذة المنبثقة نفسها بكل مظهر

التأكيد من أعلى هذه الصفحة، فوق اللعبة نفسها، ولم يتغيّر سوى النمط الجاهز. الكود متطابق — والسمة والمظهر والأيقونات تتكفّل بالباقي.

ما الذي يغيّره كل مظهر

كسوة النافذة المنبثقة من المظهر

المظهر يقرّر الأجزاء التي لا تبلغها السمة. وهذه الخطافات هي التي تستدعيها النوافذ المنبثقة — تجاوزها في صنف مشتقّ من GoSkin خاص بك؛ وهي افتراضيًا لا تفعل شيئًا.

إلى أي حدّ تشفّ

كل نوع من النوافذ المنبثقة يتبع عتامته الخاصة، فتبقى بطاقة HUD خفيفة بينما يبقى مربع الحوار مصمتًا: النوافذ والأوراق ومربعات الحوار والبطاقات المنبثقة والمنتقي تتبع panel_alpha؛ والدرج وبطاقة الإرشاد card_alpha؛ وبطاقات السؤال ووحدة التحكّم hud_alpha؛ وأشرطة الإشعار والإشعارات notice_alpha؛ والقوائم popup_alpha. أما مظهرا Material والأطفال فيجعلانها كلها معتمة، وكذلك مظهر القصص المصوّرة باستثناء بطاقات السؤال ووحدة التحكّم بعتامة 92%، ومظهر الأركيد كذلك باستثناء هذين بعتامة 94%. تجاوز نوعًا واحدًا بـ GoConfig.container_alpha_overrides، أو كلها بـ container_alpha (نسبة — 0.95)، أو نافذة واحدة بخاصية alpha الخاصة بها. الوجه وحده يبهت؛ والنص لا يشفّ أبدًا. العتامة بالتفصيل ←

إعدادات تشكّل كل نافذة منبثقة

حقول GoConfig (GoUi.config). بعضها يُنسخ حين تُنشأ النافذة، فاضبطها قبل بناء الواجهة — أو استدعِ 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، وlayer_index وmax_width في GoDialogs — لا تُطبَّق.
• استدعاء confirm() الثاني يعيد false فورًا. شغّل queue_when_busy إن كان سؤالان قد يلتقيان.
• Enter يؤكّد. زر الموافقة يحمل التركيز، في مربعات الحوار التي لا رجعة فيها أيضًا.
• زر الرجوع على الورقة يغلق الورقة، لا الصفحة الفرعية.
• Escape لا يغلق الدرج، وis_any_open() لا يراه.
• البطاقة المنبثقة أو قائمة المنتقي تحجب اللعبة حتى تُغلق، حتى مع حجاب شفاف — والبطاقة المنبثقة التي فيها dismissable = false وبلا عنوان ليس على الشاشة ما يغلقها.
• بطاقة السؤال تبدأ مخفية وليست لها مهلة.
• شريط الإشعار الذي فيه seconds: 0 وبلا زر لا يرحل أبدًا. وهو يلتقط النقرات على بطاقته افتراضيًا.
• ضغطة مطوّلة لا يعرف بها أحد ميزةٌ لا يستعملها أحد. أظهر ⋯ أيضًا.
• الشجرة المتوقفة مؤقتًا توقف نافذتك المنبثقة. استعمل PROCESS_MODE_ALWAYS على طبقتها.
• الإشعار الذي بلا عرض ينكمش إلى أضيق ما يكون — استعمل preferred_width().
• لا تسأل في شريط إشعار، ولا تُخبر في مربع حوار. فالسؤال يختفي حين يُتجاهل؛ والخبر لا ينبغي أن يوقف اللعبة.