SuperAPI AI 工具集

native-ui

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:面向原生渲染的 Native SDK 应用,说明如何用 .native 标记编写界面。应用由标记视图与核心组成:src/app.native 放全部 UI(元素、布局、绑定、消息分发),src/core.ts 放 Model、Msg 联合类型、update、effects、subscriptions 与派生绑定辅助函数,app.zon 定义身份、窗口、资源、权限与策略。TypeScript 核心会提前编译为原生代码,二进制中不含 JS 运行时。标记不可修改状态,只绑定取值并派发消息,逻辑都在核心。

主要能力:标记编译结果与手写 canvas.Ui(Msg) 构建器生成的控件树一致(相同控件 id 与类型化处理器表)。用 native init 创建应用,用 native check|dev|test|build 驱动项目。菜单栏状态项可用 TypeScript 默认方式导出 statusItem(model),也支持 Zig 核心的自定义接线。窗口内可并列 canvas 与 webview 面板(web_panes),URL 变化触发导航,reload_token 触发重载。macOS 上滚动区域由不可见 NSScrollView 驱动,获得系统惯性滚动与浮层滚动条,widget.value 仍为偏移记录,程序化滚动仍可用。右键菜单只声明一份,平台决定呈现:有原生菜单时用 NSMenu/TrackPopupMenu/GtkPopoverMenu,无原生呈现器时自动退化为锚定的 canvas 表面。支持 <context-menu> 元素与 Zig 的 ElementOptions.context_menu。自动化快照会列出各控件声明的菜单项,可用 widget-context-press、widget-context-menu 驱动真实次按钮操作。

使用方式:初始脚手架默认不写编辑器配置,可自行添加 .vscode/settings.json 设置 files.associations 将 *.native 关联为 html,或用 native init --full 生成。Zig 核心需显式选择 native init --template zig-core。发布时可在编译期解析标记 canvas.CompiledMarkupView。

限制:TypeScript 核心为默认路径,Zig 接线仅在现有树使用 Zig 核心或明确需要自有运行时时使用。菜单项为扁平结构,不支持子菜单。过滚动默认关闭,需按区域显式启用。移动端嵌入的触摸长按菜单仍未完成。具体收费、价格与支持平台资料未提供。