Solid Glass Composer 组件实战教程:打造专业AI对话输入框

原创2026-11-01 21:51:231,364 阅读

Solid Glass Composer 组件实战教程:打造专业AI对话输入框

Solid Glass 是专为 AI 应用打造的设计系统,它的 Composer 组件就是一个现成的专业 AI 对话输入框:附件标签、发送/停止一键切换、底部模型选择栏全部内置。本教程将带你用最快速度安装 Composer,并把它接入自己的 AI 聊天界面。

Solid Glass Composer 组件构建的 AI 智能体工作区,底部展示带附件与模型选择栏的 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。

Solid Glass 设计系统深色主题组件展示,Composer 等 AI 组件呈现实心玻璃质感的对话输入框风格

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 应用

接入聊天界面时,对照这份清单即可:

  1. 状态管理:value / onValueChange 是受控写法,与你的消息状态同步即可;
  2. 生成流程:请求开始置 running={true},结束置 false,停止键的显隐全自动;
  3. 主题:Solid Glass 是一个样式表,引入 solid-glass.css 后,已有 shadcn 组件自动呈现实心玻璃质感,组件代码零改动;
  4. 参考整屏:想看"会话列表 + 对话流 + 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 工作台。

登录后查看全文
solid-glass