SuperAPI AI 工具集

godot-ui-control

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:在 Godot 4.7 中用 Control 系列节点搭建 HUD、菜单、背包、对话框、设置界面等 UI,处理随窗口尺寸变化的响应式布局、主题样式,以及键盘与手柄的焦点导航。世界内的 2D 节点(Node2D/精灵)不属于本技能;UI 过渡动画、卡牌/视觉小说等类型化界面、完整输入重绑定也各有相关技能。

主要能力与用法:用 Control 而非 Node2D 做 UI,Control 具有矩形(位置+尺寸)、锚点,并参与焦点与主题。响应式布局用锚点:锚点是相对父矩形 0–1 的比例,用编辑器的 Layout 预设(Top-Left、Full Rect、Center 等)而非手摆像素;代码中可设 anchors_preset = Control.PRESET_FULL_RECT,等价于 Full Rect。让容器负责定位子节点:把子节点放入 VBoxContainer、HBoxContainer、GridContainer、MarginContainer 等,由容器决定位置与尺寸,用 size_flags 控制流动(如 Control.SIZE_EXPAND_FILL 占满剩余空间),容器内不要给子节点设锚点。主题用 Theme:在顶层 Control 上挂 Theme 资源,子节点继承,必要时用 add_theme_font_size_override、add_theme_color_override、add_theme_stylebox_override 做单节点覆盖。焦点需接线:设定默认聚焦控件并调用 grab_focus(),配置邻居或依赖自动邻居,确保 focus_mode 不为 FOCUS_NONE。连接 pressed、toggled、text_submitted、value_changed 等信号。

限制与易错点:容器子节点不能自行设置位置或锚点,需自由摆放时应移出容器或用普通 Control/PanelContainer 包裹;锚点是父级比例、偏移是像素增量,只改 position 而锚点为 0 会导致 UI 不随窗口缩放;Node2D 下的按钮/标签无法正确主题化与获取焦点,UI 应放在 CanvasLayer/Control 子树下;无聚焦控件时手柄方向输入无效;过度使用逐节点覆盖会削弱集中主题;4.x 中 rect_size/rect_position/rect_min_size 已改名为 size/position/custom_minimum_size;铺满矩形的 Control 可能吞掉下方点击,装饰性面板应设 MOUSE_FILTER_IGNORE。详细锚点/偏移计算、各类容器、Theme 与 StyleBox、焦点邻居及 CanvasLayer 内容见 references/layout-and-theming.md。