mirror of
https://github.com/ant-design/ant-design.git
synced 2024-11-28 21:19:37 +08:00
c7e11a0eac
* upgrade rc-mentions * update docs for mentions component * update docs
2.2 KiB
2.2 KiB
category | subtitle | type | title |
---|---|---|---|
Components | 提及 | 数据录入 | Mentions |
提及组件。
原 Mention 组件已废弃,原文档请点击这里。
何时使用
用于在输入中提及某人或某事,常用于发布、聊天或评论功能。
API
<Mention
onChange={onChange}
suggestions={['afc163', 'benjycui', 'yiminghe', 'jljsj33', 'dqaria', 'RaoHai']}
/>
API
<Mentions onChange={onChange}>
<Mentions.Option value="sample">Sample</Mentions.Option>
</Mentions>
Mention
参数 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
autoFocus | 自动获得焦点 | boolean | false |
3.19.0 |
defaultValue | 默认值 | string | - | 3.19.0 |
filterOption | 自定义过滤逻辑 | false | (input: string, option: OptionProps) => boolean | - | 3.19.0 |
notFoundContent | 当下拉列表为空时显示的内容 | ReactNode | 'Not Found' | 3.19.0 |
placement | 弹出层展示位置 | 'top' | 'bottom' | 'bottom' | 3.19.0 |
prefix | 设置触发关键字 | string | string[] | '@' | 3.19.0 |
split | 设置选中项前后分隔符 | string | ' ' | 3.19.0 |
validateSearch | 自定义触发验证逻辑 | (text: string, props: MentionsProps) => void | - | 3.19.0 |
value | 设置值 | string | - | 3.19.0 |
onChange | 值改变时触发 | (text: string) => void | - | 3.19.0 |
onSelect | 选择选项时触发 | (option: OptionProps, prefix: string) => void | - | 3.19.0 |
onSearch | 搜索时触发 | (text: string, prefix: string) => void | - | 3.19.0 |
onFocus | 获得焦点时触发 | () => void | - | 3.19.0 |
onBlur | 失去焦点时触发 | () => void | - | 3.19.0 |
getPopupContainer | 指定建议框挂载的 HTML 节点 | () => HTMLElement | - | 3.22.0 |
Mention 方法
名称 | 描述 | 版本 |
---|---|---|
blur() | 移除焦点 | 3.19.0 |
focus() | 获取焦点 | 3.19.0 |
Option
参数 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
children | 选项内容 | ReactNode | - | 3.19.0 |
value | 选择时填充的值 | string | '' | 3.19.0 |