SuperAPI AI 工具集

Unity UI Toolkit

前端与建站

查看项目

更新于 10-16 05:05

技能介绍

用途:辅助 Unity UI Toolkit 开发,涵盖 UXML 标记、USS 样式、C# VisualElement API 与现代 UI 模式。

主要能力:UXML 方面支持元素层级与命名规范、常用控件(TextField、Button、Toggle、Slider、ObjectField、ListView)、布局容器(VisualElement、ScrollView、Foldout、TwoPaneSplitView)以及模板与绑定的数据驱动 UI。USS 方面支持基于类的样式与选择器、Flexbox 布局(flex-direction、justify-content、align-items)、USS 变量与暗色主题优化、伪类(:hover、:active、:disabled)、过渡与动画。C# 方面支持 Query API(如 rootElement.Q<Button>("my-button"))、事件处理(.clicked += 与 .RegisterValueChangedCallback())、用构造函数动态创建 UI、通过 Bind() 与 SerializedObject 做数据绑定。

使用方式与最佳实践:结构用 UXML、样式用 USS、逻辑用 C#;为元素命名以便 Query API 访问;用类而非内联样式;在字段中缓存 VisualElement 引用;在 OnDestroy() 中正确清理事件。常见模式包括编辑器窗口的 CreateGUI 中加载并克隆 VisualTreeAsset、用 AddToClassList/RemoveFromClassList/ToggleInClassList 切换 USS 类、用 SerializedObject 绑定。

版本要求:运行时 UI Toolkit 需 Unity 2021.2+;仅编辑器 UI Toolkit 需 Unity 2019.4+(功能有限)。

适用场景:构建 UI Toolkit 界面、编写 UXML/USS、在 C# 中操作 VisualElement。选择 UGUI 还是 UI Toolkit 时用 unity-ui-selector;实现复杂 UI 逻辑或自定义 VisualElement 控件时用 @unity-scripter 智能体;生成新编辑器窗口模板时用 EditorScriptUIToolkit 模板。相关技能包括 unity-ui-selector、unity-template-generator、unity-script-validator。完整 API 文档见 ui-toolkit-reference.md。