すべてのウィジェット

レイアウト (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`

左端に沿って最大 3 段。

継承 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`

右端に沿って最大 3 段。

継承 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 の部品をセーフエリアの 9 か所のどれかに固定する。

継承 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`

現在のページを中央に保つ番号付きページ、または「もっと見る」1 行。

継承 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`

7 種類の色調のボタン — 通常、主要、アウトライン、テキスト、小型、危険、塗りつぶし危険。

所属 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`

マスで表示するクーポン・ギフトコード。貼り付けと IME 入力もそのまま使える。

継承 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`

交差しない 2 つのつまみ — 価格やレベルの範囲。

継承 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`

タップで選ぶ 1 か月。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`

マイクロから見出しまで 7 種類の文字の役割から一つで。

所属 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字に並ぶ移動キー4つ（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 の上段のボード 1 枚。アイコンとバナー・バー、数、時計、または準備ゲージ。

継承 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のping表示に。

継承 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`

プリセット（デフォルト・SF・中世・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 を9スライスで描くペイント済みの面と、スライダーのつまみやスイッチ用のアイコン版。

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