Suggestion 快捷指令
用于给予用户快捷提示的组件。
何时使用
需要构建一个对话场景下的输入框。
代码演示
基本用法
整行宽度
自定义
API
SuggestionsProps
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| block | 是否整行宽度 | boolean | false | - |
| children | 自定义输入框 | ({ onTrigger, onKeyDown }) => VNode | - | - |
| items | 建议项列表 | SuggestionItem[] | ((info: T) => SuggestionItem[]) | - | - |
| open | 受控打开面板 | boolean | - | - |
| rootClassName | 根元素样式类名 | string | - | - |
| onSelect | 选中建议项回调 | (value: string) => void | - | - |
| onOpenChange | 面板打开状态变化回调 | (open: boolean) => void | - | - |
onTrigger
typescript
type onTrigger<T> = (info: T | false) => void;Suggestion 接受泛型以自定义传递给 items renderProps 的参数类型,当传递 false 时,则关闭建议面板。
Suggestions Slots
| 插槽名 | 说明 | 类型 |
|---|---|---|
| default | 用于自定义输入框 | { onTrigger, onKeyDown } |
SuggestionItem
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| children | 子项目 | SuggestionItem[] | - | - |
| extra | 建议项额外内容 | VNode | string | - | - |
| icon | 建议项图标 | VNode | - | - |
| label | 建议项显示内容 | VNode | string | - | - |
| value | 建议项值 | string | - | - |
主题变量(Design Token)
组件暂无自定义 Component Token,可通过全局 Design Token 定制。
贡献者
贡献者
正在加载贡献者信息...