SuperAPI AI 工具集

bevy-ui-layout

编程与开发

查看项目

更新于 10-16 10:40

技能介绍

Bevy UI 布局

用途

该技能用于布局 Bevy 的 HUD 或菜单节点。资料明确指出:文本内容仍由 bevy-ui-text 负责,颜色与控件样式仍由 bevy-ui-theming 负责。也就是说,本技能聚焦于界面结构布局,不处理文本与主题。

主要能力

资料说明可在以下场景加载本技能:布局 HUD 或菜单节点时。它涵盖的控件映射如下:

  • 列或行:一个 Node 实体。子实体通过 ChildOf 关联。
  • 按钮:ui_widgets::Button 加 Pressed 标记。
  • 图片:ImageNode,由 Node 设定尺寸。
  • 网格:Display::Grid、GridTrack、GridPlacement。

布局相关字段包括:Flexbox 的 flex_direction、justify_content、align_items、row_gap;Grid 的 display、grid_template_columns、grid_template_rows、grid_column、grid_row。

资料提到 bevy_feathers 是面向编辑器的样式化控件集合;游戏 HUD 使用 Node、Button 和 ImageNode。

使用方式

资料通过 ECS 形式说明:布局由引擎负责,游戏系统读取 Pressed 与 ComputedNode,不会执行第二次布局。资料给出的示例代码包括:

  • 生成菜单:根节点占满窗口,采用列方向、居中,子按钮为固定尺寸并带 ChildOf。
  • 按钮绘制:一个系统根据 Pressed 标记写入 BackgroundColor,该系统只读取该标记,因此是按钮填充的唯一写入者。
  • 网格布局:父节点命名轨道,子节点设置 grid_row 与 grid_column。
  • 图片图标:ImageNode 加带尺寸的 Node,资源句柄来自 AssetServer。

资料还给出状态所有权表,区分 Component、Resource、Commands、.chain() 与 Plugin 的职责与可变更方,并强调同一组件被两个系统可变查询时必须排序或拆分,无关系统保持并行。

版本与限制

目标版本为 Bevy 0.20+。资料列出绝不事项:不要在文档 URL 中固定 /0.20.0/ 版本;不要从两个无序系统可变查询同一组件;不要在此虚构物理、导航、网络或 XR crate;不要使用控制树锚点或容器节点,布局依靠 Node 字段、ChildOf 和 ComputedNode;不要虚构 API 或未命名的第三方 crate。

关于收费、价格、平台、效果或缺失步骤,资料暂未提供。