SuperAPI AI 工具集

opentui

前端与建站

查看项目

更新于 10-16 04:58

技能介绍

用途:OpenTUI 是面向终端界面的 React 渲染器,采用 Yoga 布局(与 React Native 类似),并非 React DOM 或 Ink,适合用 React 组件方式构建终端屏幕、组件与视图导航。当前版本 0.1.69。

主要能力:提供 useKeyboard、useRenderer、useTerminalDimensions 等 Hook,以及 box、text、scrollbox、a、input、textarea 等内建 JSX 元素(需小写)。scrollbox 支持 scrollTop、scrollHeight、viewport.height、scrollTo、scrollBy、getChildren 等 API。0.1.64+ 支持 OSC8 超链接。

使用要点:text 仅接受字符串,不能嵌套元素,行内样式需用 flexDirection: "row" 的 box 包裹;键盘处理须先检查 focused;滚动位置需在状态变化前同步保存,而非在 useEffect 中保存。布局可用 flexDirection、flexGrow、flexShrink 等实现全高加固定页眉页脚,并注意 Yoga 的间距问题。键盘键名如 return、up/down/left/right、escape、tab 等。

可选用法:可安装 react-devtools-core@7,用 npx react-devtools@7 启动独立开发者工具,并以 DEV=true bun run start 运行。

参考文件:COMPONENTS.md、KEYBOARD.md、SCROLLBOX.md、LAYOUT.md、PATTERNS.md,以及 xfeed 中的 app.tsx、PostList.tsx、PostCard.tsx、FolderPicker.tsx、useListNavigation.ts。

限制:官方文档与收费信息暂未提供;资料未说明具体平台支持范围,仅提及 OSC8 需终端支持(如 iTerm2、Kitty)。