全部控件 — gohud

布局 (15)

`GoScaffold`

一次搭好应用界面：顶栏、滚动页面、底栏、FAB 与抽屉。

继承 Control

var page := GoStyle.column()
var screen := GoScaffold.make("Inbox", page, true)
screen.set_fab(GoFab.make(GoIconSet.EDIT))
add_child(screen)

`GoTopBar`

沿顶边排列的 1～3 个槽位，中间槽始终居中。

继承 GoEdgeBar

var bar := GoTopBar.make(3)
bar.add_start(GoStyle.icon_button(GoIconSet.BACK, go_back, -1, &"back"))
bar.add_center(GoStyle.label("Stage 3"))
bar.add_end(GoStyle.chip("1,250"))

`GoBottomBar`

沿底边排列，避开手势条。

继承 GoEdgeBar

var actions := GoBottomBar.make(1, GoBottomBar.Justify.SPACE_BETWEEN)
for name in ["Attack", "Guard", "Run"]: actions.add_start(GoStyle.button(name))
screen.add_child(actions)

`GoLeftSideBar`

沿左边最多三层。

继承 GoSideBar

var tools := GoLeftSideBar.make(3)
tools.add_start(GoStyle.icon_button(GoIconSet.MENU, open_menu, -1, &"menu"))
tools.add_end(GoStyle.icon_button(GoIconSet.USER, open_profile, -1, &"profile"))
screen.add_child(tools)

`GoRightSideBar`

沿右边最多三层。

继承 GoSideBar

var tools := GoRightSideBar.make(3)
tools.add_start(GoStyle.icon_button(GoIconSet.SETTINGS, open_settings, -1, &"settings"))
tools.add_center(GoStyle.icon_button(GoIconSet.SEARCH, find, -1, &"search"))
screen.add_child(tools)

`GoSideBar`

上面两者的基础侧栏；在从右到左的语言中也保持原侧。

继承 GoEdgeBar

var rail := GoRightSideBar.make(1, GoSideBar.Justify.CENTER)
rail.add_start(GoStyle.icon_button(GoIconSet.MAP, open_map, -1, &"map"))

`GoEdgeBar`

所有边栏共享的规则：槽位、均匀分布、贴边与安全区域。

继承 Container

var bar := GoTopBar.make(1)
bar.justify = GoEdgeBar.Justify.SPACE_BETWEEN
bar.pin_to_edge = GoEdgeBar.Pin.ALWAYS

`GoGrid`

宽度完全相同的列——固定数量，或能放多少放多少。

继承 Container

var cards := GoGrid.make(1, 160.0)
for item in items: cards.add_child(GoStyle.item_card(item))

`GoForm`

限制宽度并避开键盘与 HUD 的表单。

继承 MarginContainer

var form := GoForm.new()
form.avoid_hud = true
form.add_child(GoScroll.new())
add_child(form)

`GoScroll`

从内容任意位置都能触控滚动，支持从右到左的语言。

继承 ScrollContainer

var list := GoScroll.new()
list.add_child(GoStyle.column())
var strip := GoScroll.horizontal()

`GoHudAnchor`

把 HUD 部件固定在安全区域的九个位置之一。

继承 Control

var corner := GoHudAnchor.new()
corner.spot = GoHudAnchor.Spot.TOP_LEFT
corner.add_child(GoStyle.hud_panel())

`GoStyle.column · row · wrap_row`

使用主题间距的列、行与自动换行的行。

所属 GoStyle

var page := GoStyle.column()
var line := GoStyle.row()
var chips := GoStyle.wrap_row()

`GoStyle.responsive_grid · aspect`

变宽时增加列的网格，以及保持比例的盒子。

所属 GoStyle

var tiles := GoStyle.responsive_grid(160)
var thumb := GoStyle.aspect(16.0 / 9.0)

`GoStyle.padding · spacer · divider`

内边距、占满剩余空间的间隔与分隔线。

所属 GoStyle

var pad := GoStyle.padding(16)
line.add_child(GoStyle.spacer())
page.add_child(GoStyle.divider())

`GoStyle.foldable · section`

分区标题，以及可展开折叠的分区。

所属 GoStyle

page.add_child(GoStyle.section("Sound", false))
var more := GoStyle.foldable("Advanced", true, null, false)

窗口与浮层 (12)

`GoSurface`

浮动窗口——居中、从底部弹出，或贴靠某个控件。

继承 Control

var window := GoSurface.new()
window.set_title("Settings")
window.close_requested.connect(window.queue_free)
layer.add_child(window)

`GoSheet`

带分页、返回导航与固定底栏的底部面板。

继承 CanvasLayer

var sheet := GoSheet.new()
add_child(sheet)
sheet.open("Inventory")
sheet.body.add_child(bag_list)

`GoPage`

带分类栏（横屏在左、竖屏为顶部标签）、预览、返回以及在页内推入的子页面的全屏页面。

继承 CanvasLayer

var page := GoPage.new()
add_child(page)
page.open("Settings")
page.set_tabs([{id = &"sound", label = "Sound", icon = GoIconSet.VOLUME_HIGH, badge = ""}])
page.push("About", func(box: VBoxContainer) -> void: box.add_child(GoStyle.label("Version 1.0")))

`GoDialogs`

可 await 的确认与提示窗口；提示会排队等候。

继承 Node

var dialogs := GoDialogs.new()
add_child(dialogs)
if await dialogs.confirm("Delete save", "This cannot be undone.", "", "", "", {}, true):
	delete_save()

`GoDialogs.choose`

从几项中选一项——手机上是底部面板，桌面上是卡片。

所属 GoDialogs

var index := await dialogs.choose("Sort by", ["Newest", "Price", "Rating"])
if index >= 0: sort_by(index)

`GoDrawer`

从左侧或右侧滑入的面板。

继承 CanvasLayer

var drawer := GoDrawer.new()
add_child(drawer)
drawer.side = GoDrawer.Side.RIGHT
drawer.open("Bag")

`GoPopover`

在被点按之处旁边弹出的信息卡，一次一张。

继承 RefCounted

GoPopover.open(slot, GoStyle.item_card(item, false))

`GoContextMenu`

长按或右键弹出菜单；手指一移动就取消。

继承 RefCounted

GoContextMenu.attach(slot, [{"text": "Use"}, {"text": "Drop", "danger": true}])

`GoCoachMark`

指向真实控件的引导教程。

继承 Control

var tour := GoCoachMark.new()
add_child(tour)
tour.start([{"target": bag_button, "title": "Bag", "body": "Your items live here."}])

`GoConsole`

带命令与历史记录的开发者控制台；发布版中关闭。

继承 CanvasLayer

var console := GoConsole.new()
add_child(console)
console.register("give", "Grant an item", give_item)

`GoRibbonHeader`

悬在卡片上缘的屏幕标题飘带，带图标字形与外观的角落图案。

继承 Control

var header := GoRibbonHeader.make("PAUSED", GoIconSet.PAUSE)
card_column.add_child(header)

`GoFitBox`

让整张卡片留在屏幕内：太大时连同飘带一起缩小，长列表则改为滚动。

继承 Container

var fit := GoFitBox.new()
fit.add_child(card)

消息与等待 (12)

`GoSnackbar`

底部消息，可排队，也可带按钮。

继承 Node

var snack := GoSnackbar.new()
add_child(snack)
if await snack.post({"text": "Item dropped", "actions": ["Undo"]}) == 0:
	restore_item()

`GoNotice`

绝不抢占输入或焦点的提示。

继承 PanelContainer

var notice := GoNotice.new()
hud.add_child(notice)
notice.show_text("Saved", GoTheme.SUCCESS)

`GoPromptCard`

不打断游戏的询问——邀请、交易。

继承 PanelContainer

var invite := GoPromptCard.new()
invite.set_title("Party invite from Ann")
invite.set_actions([{"text": "Accept", "action": accept, "primary": true}])

`GoBanner`

一直留在页面上直到被处理的消息。

继承 PanelContainer

var offline := GoBanner.make("You're offline.", [{"text": "Retry", "action": reconnect}], GoIconSet.WARNING)
page.add_child(offline)

`GoSpinner`

等待指示；把按钮原地变成转圈，避免被按两次。

继承 Control

GoSpinner.busy(buy_button, true)
await shop.buy(item)
GoSpinner.busy(buy_button, false)

`GoBadge`

未读圆点、NEW 标签与 99+，挂在角上。

继承 PanelContainer

GoBadge.attach(mail_button, unread)
GoBadge.attach(shop_button, 0, "NEW")

`GoProgress`

线形或环形进度，波浪或平直；不知总量时为不确定状态。

继承 Control

var upload := GoProgress.linear()
upload.value = 0.4
var ring := GoProgress.circular(true)

`GoLoadingIndicator`

会变形的 Material 3 Expressive 等待标记；开启 reduce_motion 时静止。

继承 Control

var wait := GoLoadingIndicator.new()
wait.contained = true
page.add_child(wait)

`GoRefresh`

在列表顶部向下拉即可刷新。

继承 Control

var refresh := GoRefresh.attach(feed)
refresh.refresh_requested.connect(func() -> void:
	await reload_posts()
	refresh.finish())

`GoStyle.alert`

信息、成功、警告或危险色调的内嵌消息。

所属 GoStyle

page.add_child(GoStyle.alert("Maintenance at 3 AM", GoTheme.WARNING))

`GoStyle.skeleton · empty_state`

加载时的占位，以及空列表的提示。

所属 GoStyle

page.add_child(GoStyle.skeleton(200))
page.add_child(GoStyle.empty_state(GoIconSet.BOX, "No items yet", false))

`GoStyle.tooltip_node`

主题样式的工具提示，不会把单词拆开。

所属 GoStyle

func _make_custom_tooltip(text: String) -> Object:
	return GoStyle.tooltip_node(text)

应用导航 (13)

`GoAppBar`

顶部应用栏；页面滚动时浮起；支持中号与大号标题。

继承 PanelContainer

var bar := GoAppBar.make("Inbox", GoIconSet.MENU, open_drawer)
bar.add_action(GoIconSet.SEARCH, &"search", open_search)
bar.follow(list)

`GoNavBar`

底部 3～5 个目的地；宽屏上为侧边导航栏。

继承 PanelContainer

var nav := GoNavBar.make([{"icon": GoIconSet.HOME, "text": "Home"},
	{"icon": GoIconSet.BELL, "text": "Alerts", "badge": 3}], 0, show_tab)
var rail := GoNavBar.rail([{"icon": GoIconSet.HOME, "text": "Home"}])

`GoNavBar.drawer_list`

放在抽屉里的整宽目的地行。

所属 GoNavBar

drawer.body.add_child(GoNavBar.drawer_list([{"icon": GoIconSet.HOME, "text": "Inbox"},
	{"icon": GoIconSet.STAR, "text": "Starred"}], 0, go_to))

`GoFab`

浮在角落的界面主操作；40～96dp，或带文字的扩展型。

继承 Button

var cart := GoFab.make(GoIconSet.PLUS, "Add to cart", add_to_cart)
cart.float_in(self, nav.get_combined_minimum_size().y)

`GoSearchBar`

带清除按钮与尾部操作的圆角搜索框。

继承 PanelContainer

var search := GoSearchBar.make("Search products", find)
search.add_action(GoIconSet.FILTER, &"Filter", open_filters)

`GoSplitButton`

一个主操作，其变体藏在箭头后面。

继承 HBoxContainer

var send := GoSplitButton.make("Send", send_now, ["Send later", "Save as draft"])
send.chosen.connect(func(index: int) -> void: send_variant(index))

`GoTabView`

铺满整行的标签页，与可滑动切换的页面。

继承 VBoxContainer

var tabs := GoTabView.make(["Posts", "Photos", "Saved"], [posts, photos, saved])
tabs.tab_changed.connect(func(index: int) -> void: track_tab(index))

`GoStyle.tabs`

标签行，可靠前排列或铺满整行；下划线贯穿全宽。

所属 GoStyle

var row := GoStyle.tabs(["Overview", "Stats", "Gear"], 0, false, true)
row.tab_changed.connect(show_panel)

`GoStyle.bottom_app_bar`

带图标操作与 FAB 的底栏。

所属 GoStyle

screen.set_bottom_bar(GoStyle.bottom_app_bar([{"icon": GoIconSet.SEARCH, "tooltip": &"search"},
	{"icon": GoIconSet.HEART, "tooltip": &"Like"}], GoFab.make(GoIconSet.PLUS)))

`GoStyle.toolbar`

装着图标操作的浮动胶囊。

所属 GoStyle

page.add_child(GoStyle.toolbar([{"icon": GoIconSet.EDIT, "tooltip": &"Edit", "action": edit},
	{"icon": GoIconSet.TRASH, "tooltip": &"Delete", "action": delete}]))

`GoStyle.breadcrumb`

以可逐级返回的路径显示当前位置。

所属 GoStyle

page.add_child(GoStyle.breadcrumb(["Home", "Shop", "Swords"], go_to_level))

`GoPagination`

让当前页居中的页码，或一行“加载更多”。

继承 HBoxContainer

var pages := GoPagination.make(1, 12, load_page)
page.add_child(pages)

`GoCarousel`

横幅广告与角色选择，除非要求否则不会自行翻页。

继承 VBoxContainer

var banners := GoCarousel.new()
banners.set_pages([promo, event, pack])

按钮、标签与选择 (10)

`GoStyle.button`

七种色调的按钮：普通、主要、描边、文字、紧凑、危险与实心危险。

所属 GoStyle

row.add_child(GoStyle.button("Play", play, GoStyle.Tone.PRIMARY))
row.add_child(GoStyle.button("Details", open_details, GoStyle.Tone.OUTLINED))
row.add_child(GoStyle.button("Skip", skip, GoStyle.Tone.BARE))

`GoStyle.glow`

给实心按钮加光晕，使其浮起。

所属 GoStyle

row.add_child(GoStyle.glow(GoStyle.button("Play", play, GoStyle.Tone.PRIMARY)))

`GoIconButton`

仅图标的按钮：看起来小，可点区域 48dp，带屏幕阅读器名称。

继承 Button

row.add_child(GoStyle.icon_button(GoIconSet.CLOSE, close, -1, &"close"))
var bell := GoIconButton.new()
bell.icon_name = GoIconSet.BELL

`GoGlyphButton`

图标紧挨着文字的按钮，街机菜单里那种亮面胶囊。

继承 Button

row.add_child(GoGlyphButton.make("Play", GoIconSet.PLAY, GoTheme.VAR_PRIMARY_BUTTON))

`GoStyle.chip`

文字始终清晰可读的状态或标签胶囊。

所属 GoStyle

row.add_child(GoStyle.chip("Rare", GoUi.color(GoTheme.INFO)))

`GoStyle.filter_chip · input_chip`

可开关的标签，以及带 ✕ 的已输入值。

所属 GoStyle

filters.add_child(GoStyle.filter_chip("In stock", false, refilter))
to.add_child(GoStyle.input_chip("Ann", remove_ann, GoIconSet.USER))

`GoStyle.segmented`

从几项中恰选一项，连成一行。

所属 GoStyle

page.add_child(GoStyle.segmented(["Day", "Week", "Month"], 0, show_range))

`GoStyle.choice_grid`

从网格中挑选一个色块——颜色或皮肤。

所属 GoStyle

var skins := GoStyle.choice_grid([{"color": "f6cfae", "tooltip": "Peach"},
	{"color": "8d5a36", "tooltip": "Cocoa"}], 0, pick_skin)

`GoStyle.radio_group`

只能选其一的单选按钮。

所属 GoStyle

page.add_child(GoStyle.radio_group(["Easy", "Normal", "Hard"], 1))

`GoStyle.toggle · checkbox`

带标签的开关与复选框。

所属 GoStyle

var music := GoStyle.toggle("Music", false)
var terms := GoStyle.checkbox("I agree to the terms", false)

输入与选择器 (14)

`GoStyle.line_edit · textarea`

单行与多行文本框。

所属 GoStyle

var nickname := GoStyle.line_edit("Your name")
var note := GoStyle.textarea("Message", 4)

`GoField`

标签、控件与提示，错误显示在出错的字段下方。

继承 VBoxContainer

var field := GoField.make("Nickname", GoStyle.line_edit(), "3–12 letters", false)
field.set_error("That name is taken")

`GoInputGroup`

把输入框与按钮焊接成一个整体。

继承 HBoxContainer

var chat := GoInputGroup.make(GoStyle.line_edit("Message"), {"suffix": GoStyle.button("Send", send)})

`GoCombobox`

不仅从开头、也能在名称中间搜索的选择器。

继承 Button

var friend := GoCombobox.make(friends, -1, "Find a friend")
friend.picked.connect(invite)

`GoCodeInput`

以格子显示的优惠码与礼品码；粘贴与输入法照常可用。

继承 VBoxContainer

var coupon := GoCodeInput.make(12, 4)
coupon.completed.connect(redeem)

`GoStyle.select · dropdown`

下拉列表，以及打开菜单的按钮。

所属 GoStyle

var quality := GoStyle.select(["Low", "Medium", "High"])
var sort := GoStyle.dropdown("Sort", ["Newest", "Price"], sort_by)

`GoStyle.slider`

主题样式的滑块。

所属 GoStyle

var volume := GoStyle.slider(0.0, 1.0, 0.05)
volume.value_changed.connect(set_volume)

`GoRangeSlider`

两个不会交叉的滑钮——价格或等级范围。

继承 Control

var price := GoRangeSlider.make(0.0, 500.0, 40.0, 220.0, 10.0)
price.change_ended.connect(func(low: float, high: float) -> void: refilter(low, high))

`GoSlider`

手绘风格的滑块：填充越过滑钮一点，按住时滑钮变大。

继承 HSlider

var music := GoSlider.make(0.0, 1.0, 0.01)
music.theme_type_variation = &"GoSliderGreen"

`GoSwitch`

手绘风格的开关，滑钮旁显示 ON / OFF。

继承 CheckButton

var vibration := GoSwitch.make(true)
vibration.set_texts(tr("ON"), tr("OFF"))

`GoDatePicker`

点选的月历；开启 range_mode 可选日期范围。

继承 Container

var stay := GoDatePicker.make()
stay.range_mode = true
stay.range_picked.connect(func(start: Dictionary, end: Dictionary) -> void: book(start, end))

`GoTimePicker`

时钟表盘：先选小时再选分钟；12 或 24 小时；方框上可用上下键。

继承 Container

var alarm := GoTimePicker.make(7, 30, func(hour: int, minute: int) -> void: set_alarm(hour, minute))
alarm.use_24h = true

`GoWheelPicker`

会转动并把一项停在中间色带上的滚轮。

继承 Control

var amount := GoWheelPicker.make(["x1", "x5", "x10", "x50"], 0, set_amount)
row.add_child(amount)

`GoStepper`

带“下一步/上一步”的编号步骤，纵向或横向排列。

继承 VBoxContainer

var checkout := GoStepper.make([{"title": "Cart", "content": cart}, {"title": "Pay", "content": pay}])
checkout.finished.connect(place_order)

列表、卡片与数据 (8)

`GoStyle.list_row · list_button`

带图标、标题、摘要与尾部标记的列表行。

所属 GoStyle

page.add_child(GoStyle.list_button(GoIconSet.SETTINGS, "Settings", open_settings, Color.TRANSPARENT, "", false))

`GoListView`

成千上万行，只创建可见的行。

继承 GoScroll

var feed := GoListView.make(10000, 72.0, func(index: int) -> Control: return post_row(posts[index]))
feed.end_reached.connect(load_more)

`GoReorderList`

用拖柄或长按拖动来排序的行。

继承 Container

var queue := GoReorderList.make([intro_row, theme_row, boss_row])
queue.reordered.connect(func(from: int, to: int) -> void: songs.insert(to, songs.pop_at(from)))

`GoSwipeRow`

侧滑即可删除或归档的行；列表照常滚动。

继承 Container

inbox.add_child(GoSwipeRow.wrap(mail_row, {"icon": GoIconSet.TRASH, "text": "Delete",
	"tone": GoTheme.DANGER, "action": delete_mail}))

`GoTable`

可排序的表头与可选择的行；数字按数值排序。

继承 VBoxContainer

var board := GoTable.make(["Name", {"text": "Score", "numeric": true}], [["Ann", 9124], ["Ben", 91240]])
board.row_selected.connect(open_profile)

`GoStyle.card · item_card`

卡片，以及所选物品的详情卡。

所属 GoStyle

var card := GoStyle.card()
card.add_child(GoStyle.label("Daily quest"))
popup.add_child(GoStyle.item_card({"title": "Rusty sword", "subtitle": "Common"}))

`GoStyle.avatar`

圆形中的首字母或图片。

所属 GoStyle

row.add_child(GoStyle.avatar("AK", 40))

`GoStyle.label`

使用从 micro 到 title 的七种文字角色之一的文本。

所属 GoStyle

page.add_child(GoStyle.label("Level 12", GoTheme.ROLE_TITLE))
page.add_child(GoStyle.label("Next level in 340 XP", GoTheme.ROLE_CAPTION, GoUi.color(GoTheme.MUTED)))

HUD 与游戏组件 (30)

`GoBar`

显示数值、分数或百分比的 HP、MP、XP 条。

继承 Control

var hp := GoBar.new()
hp.label_text = "HP"
hp.set_values(320, 500)

`GoSlot`

快捷栏格：图标、数量、冷却与快捷键集于一面。

继承 Button

var potion := GoSlot.new()
potion.icon_name = GoIconSet.POTION
potion.quantity = 12
potion.start_cooldown(5.0)

`GoSlotGrid`

背包网格；物品可在格子间拖动。

继承 HFlowContainer

var bag := GoSlotGrid.new()
bag.set_cell(0, {"icon": GoIconSet.POTION, "quantity": 12})

`GoJoystick`

虚拟摇杆——固定、跟随拇指或相对模式。

继承 Control

var pad := GoJoystick.new()
pad.mode = GoJoystick.Mode.FOLLOW
pad.moved.connect(func(direction: Vector2) -> void: player.move(direction))

`GoKbd`

读取真实按键绑定的键帽，改键后提示也不会出错。

继承 HBoxContainer

hint.add_child(GoKbd.for_action(&"interact"))

`GoChoiceColumn`

点一下即可选的短竖列——召唤列表；游戏可标记任意多行。

继承 Control

var animals := GoChoiceColumn.make(["Hen", "Cat", "Dog", "Pig", "Cow"], 4, summon)
animals.set_selected(2, true)
side_bar.add_center(animals)

`GoLevelCard`

关卡选择卡片：缩略图、标题、副标题，并按状态显示对勾、锁或 PLAY! 标签。

继承 Button

var card := GoLevelCard.make("STAGE 3", "OPPONENTS: 3", GoLevelCard.State.CURRENT)
card.pressed.connect(play_stage)

`GoStarRow`

一排评分星星：部分亮起金色，其余变暗——关卡最佳通关或结算画面的评级。

继承 HBoxContainer

var rating := GoStarRow.make(2)
rating.star_size = 40.0

`GoKeyCluster`

倒 T 形排列的四个移动键（WASD 或方向键），就像操作说明页那样。

继承 Control

var wasd := GoKeyCluster.make(["W", "A", "S", "D"])
var arrows := GoKeyCluster.make(GoKeyCluster.ARROWS)

`GoCoverImage`

填满方框并裁掉多余部分的图片，类似 CSS 的 object-fit: cover。

继承 Control

var shot := GoCoverImage.make(preload("res://art/level_3.png"), Vector2(0.5, 0.3))
shot.custom_minimum_size = Vector2(74, 74)

`GoHudCard`

比赛 HUD 顶栏的一块面板：图标加横幅和血条、计数、时钟或就绪量表。

继承 PanelContainer

var clock := GoHudCard.make(GoUi.skin().widget_art(&"stopwatch"))
clock.title = "MATCH TIME"
clock.set_clock(83.0)

`GoCountdown`

比赛开始倒数：3、2、1、GO! 大字显示在圆盘上，每一步弹出。

继承 Label

var count := GoCountdown.new()
count.show_step("3")

`GoHudButton`

HUD 角落按钮：图片按钮旁用键帽显示对应的键盘按键。

继承 HBoxContainer

var pause := GoHudButton.make(GoUi.skin().widget_art(&"pause_button"), 52.0, "Esc")
pause.pressed.connect(func() -> void: print("pause"))

`GoNameplate`

悬浮在 3D 世界角色上方的名牌，无论远近在屏幕上大小不变。

继承 PanelContainer

var plate := GoNameplate.make("BOT RED", Color(0.86, 0.24, 0.24))
plate.follow(camera, anchor.global_position)

`GoNoticeFeed`

单行通知（如击杀播报）依次堆叠、淡入并自动消失的信息流。

继承 VBoxContainer

var feed := GoNoticeFeed.new()
feed.push("RED knocked out BLUE")
feed.push("YOU knocked out GREEN", true)

`GoTouchButton`

触屏用的圆形拇指按钮，带冷却圈、就绪脉冲和可选的拖动瞄准。

继承 Control

var jump := GoTouchButton.make(&"btn_jump", "JUMP", 86.0)
jump.pressed_down.connect(send_jump)
var skill := GoTouchButton.make(&"btn_repulse", "REPULSE", 92.0)
skill.cooling = true
skill.cooldown = 0.4

`GoSpotlight`

将某个控件周围的屏幕调暗并加上描边；暗幕会淡出，描边保留。

继承 Control

var spot := GoSpotlight.new()
hud.add_child(spot)
spot.follow(jump_button, true)

`GoEditFrame`

布局编辑器为玩家可移动的每个元素绘制的轮廓：普通、带手柄的选中、警告、隐藏。不接收输入。

继承 Control

var frame := GoEditFrame.new()
editor.add_child(frame)
frame.circle = true
frame.state = GoEditFrame.State.SELECTED

`GoGestureHint`

半透明的指尖循环演示一个触控手势——两指张开再捏合，教玩家双指缩放。不接收输入。

继承 Control

var hint := GoGestureHint.new()
hud.add_child(hint)
hint.position = Vector2(480, 0)
hint.size = Vector2(480, 540)
hint.play()

`GoTaskCard`

教程关卡卡片：步骤、标题、要做的事、完成即打勾的分项标签和提示；可折叠成一行。

继承 PanelContainer

var card := GoTaskCard.new()
card.caption = "TRAINING · STEP 1/12"
card.title = "MOVE"
card.body = "Move with W A S D."
card.set_parts(["W", "A", "S", "D"], [true])

`GoPerfReadout`

常驻性能条：fps、帧时间、三角形、绘制调用、节点和内存；fps 下降时变红。

继承 PanelContainer

var perf := GoPerfReadout.new()
perf.tier_text = "LOW (auto)"
overlay_layer.add_child(perf)

`GoSignalBars`

手机式信号格：从左到右逐渐升高的竖条，以绿、金、红点亮，旁边显示“48 ms”之类的读数——对局 HUD 的延迟。

继承 PanelContainer

var ping := GoSignalBars.make(4, GoSignalBars.Tone.GOOD)
ping.set_reading(2, GoSignalBars.Tone.FAIR, "180 ms")

`GoRewardRow`

展示玩家靠进度获得之物的一行：带进度条和奖励的任务或成就，按状态显示领取按钮、对勾或挂锁。高度固定，适用于 GoListView。

继承 PanelContainer

var quest := GoRewardRow.make("Win 3 matches", GoIconSet.STAR)
quest.key = "win_3"
quest.set_progress(1, 3)
quest.set_reward(50, GoIconSet.COIN)
quest.set_claim_text("CLAIM")
quest.set_state(GoRewardRow.State.READY)
quest.claim_pressed.connect(func(id: Variant) -> void: server.claim(id))

`GoFoldTab`

把 HUD 面板折叠成小药丸再展开：带箭头的细把手，折叠后是保留图标、短文字和量条的药丸。宿主在 fold_changed 时重新排布 HUD。

继承 Button

var tab := GoFoldTab.new()
tab.side = SIDE_LEFT
tab.icon_name = GoIconSet.USERS
tab.pill_text = "3"
tab.fold_changed.connect(func(now_folded: bool) -> void: party.visible = not now_folded)

`GoMapPreview`

关卡的小地图：区域、连接和起点；锁定时显示为灰色剪影。

继承 Control

var map := GoMapPreview.new()
map.add_rect(Vector2(0, 0), Vector2(6, 4), Color("#f2b84b"))
map.add_circle(Vector2(18, 0), 5.0, Color("#6fc3ff"))
map.add_link(Vector2(0, 0), Vector2(18, 0), 2.0, Color("#c9a26b"))
map.set_starts(PackedVector2Array([Vector2(-3, 0), Vector2(20, 0)]))

`GoRewardCalendar`

每日签到奖励；只能点今天。

继承 VBoxContainer

var attendance := GoRewardCalendar.make(days, claimed_until)
attendance.claimed.connect(func(day: int) -> void: server.claim_day(day))

`GoRadar`

属性五边形，用虚线比较装备。

继承 Control

var stats := GoRadar.make({"STR": 0.85, "AGI": 0.5, "INT": 0.3, "VIT": 0.7, "LUK": 0.45})
stats.set_compare(with_new_sword)

`GoDonut`

以扇形显示占比，图例不仅有颜色也有文字。

继承 Control

var share := GoDonut.make([{"label": "Physical", "value": 620}, {"label": "Magic", "value": 340}])
card.add_child(share.legend())

`GoZoomView`

双指、滚轮或双击缩放地图；在边界内平移。

继承 Control

var map := GoZoomView.wrap(world_map, 4.0)
map.custom_minimum_size.y = 320
page.add_child(map)

`GoStyle.hud_panel · overlay_panel`

浮在游戏画面上的面板，让文字在任何画面上都清晰可读。

所属 GoStyle

var bars := GoStyle.hud_panel()
var pill := GoStyle.overlay_panel()

外观与系统 (9)

`GoUi · GoThemePresets`

从预设（默认、科幻、中世纪、Material、儿童、漫画、街机）中选择一种；颜色与尺寸从令牌读取。

继承 RefCounted

GoUi.use_preset(GoThemePresets.MATERIAL_LIGHT)
var accent := GoUi.color(GoTheme.ACCENT)
var gap := GoUi.metric(GoTheme.GAP)

`GoConfig`

一个资源装下所有设置，插件更新后仍保留。

继承 Resource

GoUi.config.reduce_motion = true
GoUi.config.container_alpha = 1.0
GoUi.refresh()

`GoSkin`

由代码绘制的形状——标签、槽位、摇杆与新组件——按你的风格。

继承 Resource

class_name MySkin
extends GoSkin

func banner_box() -> StyleBox:
	return surface_box(GoTheme.BOX_CARD)

`GoIconSet · GoGameIcons`

按名称使用图标：默认集、187 个游戏图标或你自己的 SVG。

继承 Resource · RefCounted

GoUi.config.icons = GoGameIcons.icon_set()
var gear := GoUi.icons().node(GoIconSet.SETTINGS, 24)

`GoStyleBoxCut · GoStyleBoxBracket · GoStyleBoxMedieval`

供你的面板使用的切角、括号与锻造外框。

继承 StyleBox

var face := GoStyleBoxCut.new()
face.cut = 8
panel.add_theme_stylebox_override(&"panel", face)

`GoStyleBoxSprite · GoTextureSprite`

按九宫格绘制 PNG 的彩绘外框，以及用于滑块手柄或开关的图标版本。

继承 StyleBox

var plate := GoStyleBoxSprite.new()
plate.texture = preload("res://ui/painted/gloss_green.png")
plate.pixels_per_unit = 3.0
button.add_theme_stylebox_override(&"normal", plate)

`GoSafeArea · GoScale`

避开刘海、手势条与键盘的区域，以及以 dp 计的断点。

继承 Control · RefCounted

var usable := GoSafeArea.usable_rect(get_viewport())
var size_class := GoScale.breakpoint_for_dp(minf(usable.size.x, usable.size.y))   # by the short side

`GoFeedback`

把音效提示与触感反馈交给你自己的音频；gohud 不附带声音。

继承 RefCounted

GoFeedback.sound_handler = func(cue: String) -> void: audio.play_cue(cue)
GoFeedback.haptic_handler = func(ms: int, amplitude: float) -> void: Input.vibrate_handheld(ms, amplitude)

`GoBackPolicy`

当前由谁接管 Android 返回键与 Esc，在窗口之间共享。

继承 RefCounted

GoBackPolicy.acquire(get_tree())