用途:在构建基于 React 的 CLI 终端应用时,提供 Ink 组件模式的实践指导,帮助组织可复用、可组合的终端 UI 组件。
主要能力:以函数组件配合 TypeScript 保证类型安全;使用 Ink 内置组件 Box、Text、Newline、Spacer;覆盖常见布局模式,如纵向堆叠(flexDirection="column")、横向排列配合 Spacer、居中内容(justifyContent/alignItems)、带边框与内边距的容器(padding、borderStyle、borderColor);并给出列表项(图标+标签+值)、状态消息(success/error/warning 配色与图标)、进度指示(current/total)、可折叠区块等常见模式示例。
使用方式:定义组件 props 接口,用 React.FC 编写组件并返回 Ink 的 Box/Text 结构;布局通过 Ink 的 props 而非 CSS 控制;组件保持扁平、职责单一,必要时用 React.memo 优化渲染,用 ink-testing-library 测试,并用错误边界包裹组件。
适用场景:需要为命令行工具提供结构化、带颜色与交互状态的终端界面时。
限制与注意:不要使用 document、window 等 DOM 专用 API,不要使用 CSS 类或内联样式,不要直接修改终端状态,需处理空数组、null 等边界情况,避免过深的组件嵌套。资料未提供安装命令、版本要求与具体收费信息。