SuperAPI AI 工具集

ratatui

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:帮助解答 Rust ratatui 终端界面(TUI)库相关问题,并按其约定生成 Rust 代码。资料标注版本为 ratatui 0.30.0,更新于 2026-01-19,可在 crates.io 查看更新。

主要能力:按模块组织,涵盖基础(终端初始化、应用结构、事件循环)、布局(Constraint、Rect、Flex、区域切分)、组件(Block、List、Table、Gauge 及自定义组件)、样式(Color、Style、Modifier、Text/Span/Line)。提供 API 速查表,如 ratatui::run、ratatui::init、ratatui::restore、terminal.draw、Layout::vertical/horizontal、render_widget、render_stateful_widget;列出约束类型 Length、Min、Max、Percentage、Ratio、Fill;列出内置组件及其状态类型,如 List/ListState、Table/TableState、Scrollbar/ScrollbarState。

使用方式:生成代码前需先阅读 ./references/_shared/rust-defaults.md 的共享规则;Cargo.toml 使用 edition = "2024",依赖写 ratatui = "0.30",默认使用 crossterm 后端。简单应用可用 ratatui::run() 自动处理初始化与恢复;布局可用 Layout::vertical/horizontal 配合 areas();内容组件可用 Block 包裹边框与标题;Windows 上处理 KeyEventKind::Press 以避免重复按键事件;自定义组件可为 &MyWidget 实现 Widget。

适用场景:编写 ratatui 应用代码、解释概念、排查问题、查阅文档。

限制:ratatui 为立即模式,每帧重建 UI;组件渲染时被消费,复用需在 &Widget 上实现;布局使用 Cassowary 约束求解算法;事件处理独立于 ratatui,需直接用 crossterm/termion;有状态组件需外部管理状态。资料未提供收费、价格、平台支持范围等更多信息。