SuperAPI AI 工具集

unity-uitoolkit

通用与其它

查看项目

更新于 10-15 17:25

技能介绍

用途:本模块仅面向 Unity UI Toolkit,用 UXML 描述结构、USS 描述样式、UIDocument 将界面接入场景、PanelSettings 负责运行时渲染,可用于编写运行时或编辑器 UI、接入 UIDocument、把 UI 绑定到数据源以及构建世界空间 UI。需要 Unity 2022.3+,不要与 UGUI/Canvas 的 ui_* 技能混用。

主要能力:文件类技能可创建、读取、覆写、删除 USS/UXML 并批量创建,uitk_write_file 仅接受 .uss 或 .uxml 后缀。场景类技能可创建与修改 UIDocument、创建与读写 PanelSettings、列出与检查场景中的 UIDocument 及其实时 VisualElement 树。结构类技能支持增删改、克隆元素和解析 UXML 层级;样式类支持增删选择器规则和查看 var() 设计令牌;模板与代码生成支持 menu、hud、dialog、settings、inventory、list、tab-view、toolbar、card、notification 等起步模板,以及生成 EditorWindow 与运行时 MonoBehaviour 脚手架。

版本相关:运行时数据绑定(uitk_runtime_binding_add)需 6000.0,会按 Unity UI Builder 的方式把 <DataBinding> 写入 UXML 资产,可重复调用原地更新;世界空间面板需 6000.2;UXML 升级服务文档见于 6000.3,但并非所有 6000.3 构建都包含,需先用 listOnly=true 探测。使用前应确认最低版本,缺少服务时会返回带 requiredUnityVersion 与 currentUnityVersion 的结构化错误。

使用方式:先创建 USS/UXML,再通过 uitk_create_document 接入;运行时渲染需要有效的 PanelSettings。常用做法是先设计令牌、再组件规则、再布局容器;增量修改走 uitk_read_file 到 uitk_write_file;创建两个以上文件用 uitk_create_batch;世界空间 UI 先配置 PanelSettings,再用 uitk_worldspace_panel_create(会自动切换世界空间渲染模式);运行时绑定先建元素,再按属性逐项添加,最后用 uitk_runtime_binding_list 校验。

限制:USS 不是完整 CSS,不支持 display:grid/block/inline、box-shadow、calc()、@media、::before/::after、z-index 与渐变,需用 flex 布局、额外子元素、图片纹理和 PanelSettings.scaleMode 等方式替代。删除类技能与会生成 .cs 文件、必然触发域重载的 uitk_create_editor_window、uitk_create_runtime_ui 在 Approval 与 Auto 模式下被静态拦截,仅在 Bypass 模式或加入 Allowlist 后可调用;含这两步的事务批量会被前置拒绝,应拆出单独调用。写入类技能通过 AssetDatabase.ImportAsset 单独导入资产,不触发全项目刷新,但可能重建引用并引起检查器与场景视图重绘。模块不提供绑定转换器与更新触发器的一等参数,也不支持移除单个运行时绑定。中文对话时界面可见文本应使用中文,USS 类名与 CSS 变量保持英文。其余功能、收费与价格资料暂未提供。