提示词输入栏
Beautiful UI 的独立组件,请不要替换为 JGuang UI/Base UI 的同名 API。
安装
npx shadcn@latest add https://jiguang132.com/r/beautiful-ui/prompt-bar.json
Registry 将复制可编辑源码和依赖到独立命名空间。检查主题变量与 Tailwind CSS v4 配置;不要覆盖已有的项目组件。
使用与验证
在左侧选择组件,在预览中操作它的状态;使用“查看代码”检查真实源码。安装后执行类型检查和构建,再验证键盘焦点、手机布局与深浅色主题。
来源
https://github.com/slev12397/beautiful-ui/tree/44a274e598395ab61e7c96c26fda2758780253b7 MIT 许可证;不包括付费内容。下方提供上游英文参考内容,中文使用指南已适配;上游详细参考暂保留英文。
适用场景
提供紧凑或多行的智能体提示词输入入口。
关键参数与数据
| 原生参数 | 说明 |
|---|---|
variant | Rounded、Pill 选择原生外形。 |
demo | 真实输入应设为 false,关闭自动演示。 |
tall | 使用多行输入并把操作控件放在单独一行。 |
placeholder | 本地化输入提示。 |
onSend | 仅接收去除首尾空白的文本。 |
交互与状态检查
在 demo=false 下检查两种外形、文字输入和发送;请求中与失败状态由业务处理。
业务接入边界
演示中的模型、附件控件不会通过 onSend 提交;外观不代表已有上传或模型后端。
以下安装用法和源码参数参考保留原生 API 名称。上游英文参考未宣称全文中文化。
可运行用法
先安装下方完整示例,再使用已安装的示例入口。参数化示例、共享工具、原生组件和 CSS 均随安装包提供,不需要手工修正相对导入。
import Demo from '@/components/beautiful-ui/examples/presets/prompt-bar-user-input';
import '@/styles/beautiful-ui.css';
export default function Example() { return <Demo />; }
可用状态与示例
圆角输入栏、胶囊输入栏、用户输入、多行用户输入
组件中的状态与数据为演示用途,不包含后端接口。接入实际项目时请检查源码中的公开参数,再连接业务数据。 Composer with @ sources, / commands, model picker, and dictation.
完整示例安装
这些是实际运行的原生状态和参数化业务示例,不是额外的独立组件。每份包包含必要源码、辅助文件、固定依赖、独立 CSS 和许可证。业务示例选择名不是新增的原生组件属性;真实 API 见下方参数参考。
圆角输入栏
npx shadcn@latest add https://jiguang132.com/r/beautiful-ui/examples/prompt-bar/prompt-bar-rounded.json
默认导入: @/components/beautiful-ui/examples/presets/prompt-bar-rounded
依赖: clsx@2.1.1, glimm@0.3.1, tailwind-merge@3.6.0, shadow-plugin@2.1.1
胶囊输入栏
npx shadcn@latest add https://jiguang132.com/r/beautiful-ui/examples/prompt-bar/prompt-bar-pill.json
默认导入: @/components/beautiful-ui/examples/presets/prompt-bar-pill
依赖: clsx@2.1.1, glimm@0.3.1, tailwind-merge@3.6.0, shadow-plugin@2.1.1
用户输入
npx shadcn@latest add https://jiguang132.com/r/beautiful-ui/examples/prompt-bar/prompt-bar-user-input.json
默认导入: @/components/beautiful-ui/examples/presets/prompt-bar-user-input
依赖: clsx@2.1.1, glimm@0.3.1, tailwind-merge@3.6.0, shadow-plugin@2.1.1
多行用户输入
npx shadcn@latest add https://jiguang132.com/r/beautiful-ui/examples/prompt-bar/prompt-bar-multiline-input.json
默认导入: @/components/beautiful-ui/examples/presets/prompt-bar-multiline-input
依赖: clsx@2.1.1, glimm@0.3.1, tailwind-merge@3.6.0, shadow-plugin@2.1.1
入口初始化 Tailwind CSS v4,导入 beautiful-ui.css 一次,并由宿主 html 的 dark 类同步主题。示例按 html lang 选择中英文,不包含后端、认证或录屏。网络/剪贴板权限仍取决于浏览器。
源码参数参考
以下实现签名和类型从本地固定版本源码生成。保留可选属性、原生继承类型、联合分支和 never 限制;不会将其他设计系统的 API 混入。forwardRef 实现中的 ref 属于 React 引用,不是新增业务属性。此区域是原始类型参考,不是上游说明的全文翻译。
PromptBar({
variant = "Rounded",
demo = true,
tall = false,
placeholder,
onSend,
}: {
variant?: string;
/** the self-running walkthrough; turn off when embedding in a real surface */
demo?: boolean;
/** hero sizing: a multi-line input with controls on their own row */
tall?: boolean;
placeholder?: string;
onSend?: (text: string) => void;
})
源码中的解构默认值
只列出直接写在参数或 props 解构中的默认表达式。条件表达式、运行时主题和其他计算值请结合源码;这里不是全部行为的默认值清单。
// PromptBar
variant = "Rounded"
// PromptBar
demo = true
// PromptBar
tall = false