Solid Glass Composer 组件实战教程:打造专业AI对话输入框
Solid Glass Composer 组件实战教程:打造专业AI对话输入框
Solid Glass 是专为 AI 应用打造的设计系统,它的 Composer 组件就是一个现成的专业 AI 对话输入框:附件标签、发送/停止一键切换、底部模型选择栏全部内置。本教程将带你用最快速度安装 Composer,并把它接入自己的 AI 聊天界面。
为什么 AI 应用需要一个专门的 Composer?
普通的 textarea + 发送按钮,解决不了 AI 聊天的真实问题:
- 附件管理:用户会把文件、文件夹挂到消息上,标签要能点掉、能用退格键选中删除;
- 生成中状态:AI 正在回答时,发送按钮要变成"停止"按钮,同时用户仍应能输入下一条消息;
- 消息级设置:模式、模型、思考强度这些选项要有地方放,又不能挤占输入区;
- 视觉噪音:AI 界面有大量流式文字,界面必须安静、可读——这正是 Solid Glass "实心玻璃"材质想解决的。
Composer 把上面这些一次性封装好,源码非常克制且易读,值得一读:composer.tsx。
一条命令安装:把 Composer 加入你的项目
Solid Glass 基于 shadcn/ui 生态(React 19 + Tailwind CSS 4),组件同样走注册表安装:
npx shadcn@latest add deeplethe/solid-glass/composer
npm install lucide-react
Composer 依赖 button 与 dropdown-menu 两个基础组件,shadcn 会一并装好。可安装的组件清单定义在 registry.json 中,完整安装说明见 README.md 与 installation.mdx。
Composer 基础用法:三行代码跑起来
只需要一个"输入框当前文本"的状态和一个发送回调:
const [text, setText] = React.useState("")
<Composer value={text} onValueChange={setText} onSubmit={send} />
开箱即得的行为包括:
- Enter 发送,Shift+Enter 换行,并且自动识别中文输入法——按 Enter 选候选词时不会误发消息;
- 自动增高:文本区随内容撑高,超过 20 行自动出现滚动条;
- 发送键的"亮度"即状态:有内容时发亮可点,空着时变暗;
running时它自动变成安静的"停止"方块——此时若已输入文字,又切回发送,消息会排在当前轮次之后。
完整交互演示在 composer-demo.tsx,运行态效果见 composer-running.tsx。
Composer 属性速查表
| 属性 | 类型 | 说明 |
|---|---|---|
value |
string |
当前消息文本(受控组件) |
onValueChange |
(value: string) => void |
文本变化回调 |
onSubmit |
(value: string) => void |
发送回调,收到完整文本 |
onStop |
() => void |
生成中点击"停止"的回调 |
running |
boolean |
是否正在执行一轮,发送键自动变停止键 |
placeholder |
string |
占位提示文字 |
leading |
ReactNode |
行首插槽,常放"添加"按钮 |
tags |
ReactNode |
附件区,放 Tag 组件 |
above |
ReactNode |
文本上方的区域,如图片预览 |
canSubmit |
boolean |
手动控制能否发送(默认看是否有文本) |
onBackspaceAtStart |
() => boolean |
光标在行首时按退格的钩子,用于选中前一个标签 |
完整 API 表与文档页面见 composer.mdx。
进阶技巧:附件、停止键与底部设置栏
📎 用标签管理附件
tags 是个插槽,推荐搭配 Solid Glass 自家的 Tag 组件:它支持上传进度条、错误态,还有 armed 高亮态。演示里"两次退格删除标签"的经典交互就是靠 onBackspaceAtStart 实现的:第一次按高亮最后一个标签,第二次按真正删除。
⏹ 一个键切换"发送"与"停止"
你只需要传 running,Composer 自己决策:框内为空时它是停止方块,点击触发 onStop;用户一旦输入文字,它就切回发送键。"用亮度表达状态,而不是换按钮皮肤"是这个组件最核心的设计哲学,源码注释写得很到位(composer.tsx)。
🎛 底部设置栏:ComposerFooter
输入区下方那一条"消息设置栏"由 ComposerFooter 与 ComposerPick 组成:
<ComposerFooter>
<ComposerPick label="Mode" value={mode} options={MODES} onValueChange={setMode} />
<ComposerFooterEnd>
<ComposerPick label="Model" value={model} options={MODELS} onValueChange={setModel} />
</ComposerFooterEnd>
</ComposerFooter>
ComposerPick是"多个选项里选一个"的下拉:触发器显示当前值,展开时保持点亮,每个选项还能配hint说明文字;- 默认
align="end"右对齐,左侧的模式切换可改align="start"; ComposerFooterEnd是右对齐容器,最右边放一个 ContextRing 就能显示上下文用量环。
把 Composer 接入真实的 AI 应用
接入聊天界面时,对照这份清单即可:
- 状态管理:
value/onValueChange是受控写法,与你的消息状态同步即可; - 生成流程:请求开始置
running={true},结束置false,停止键的显隐全自动; - 主题:Solid Glass 是一个样式表,引入 solid-glass.css 后,已有 shadcn 组件自动呈现实心玻璃质感,组件代码零改动;
- 参考整屏:想看"会话列表 + 对话流 + Composer"的完整效果,直接参考 agent-workspace.tsx 这个 block。
小结
Composer 三步给你专业 AI 对话输入框:
- ✅ 一条命令安装:
npx shadcn@latest add deeplethe/solid-glass/composer - ✅ 三行代码起步:
value+onValueChange+onSubmit - ✅ 进阶能力免费送:附件标签、停止切换、底部模型选择栏
再搭配同系列的 ask-card.tsx(向用户提问的卡片)、turn-status.tsx(轮次状态行)、tool-steps.tsx(工具步骤列表),你就能快速拼出一套设计语言统一的 AI 工作台。

