mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-04 13:08:41 +08:00
3513cf7a1f
* placeholder style fix * add onSelect callback
55 lines
2.1 KiB
Markdown
55 lines
2.1 KiB
Markdown
---
|
||
category: Components
|
||
cols: 1
|
||
type: Views
|
||
title: Mention
|
||
---
|
||
|
||
Mention component。
|
||
|
||
## When To Use
|
||
|
||
When need to mention someone or something.
|
||
|
||
## API
|
||
|
||
```jsx
|
||
<Mention
|
||
onChange={onChange}
|
||
suggestions={['afc163', 'benjycui', 'yiminghe', 'jljsj33', 'dqaria', 'RaoHai']}
|
||
/>
|
||
```
|
||
|
||
### Mention API
|
||
|
||
| API | Description | Type |
|
||
|----------|---------------|----------|--------------|
|
||
| toString | convert EditorState to string | Function(editorState: EditorState): String |
|
||
| toEditorState | convert string to EditorState | Function(string: String): EditorState |
|
||
| getMentions | get mentioned people in current editorState | Function(editorState: EditorState): Array<String> |
|
||
|
||
|
||
### Mention props
|
||
|
||
| Property | Description | Type | Default |
|
||
|----------|---------------|----------|--------------|
|
||
| suggestions | suggestion content | Array<string> or Array<Mention.Nav> | [] |
|
||
| suggestionStyle | style of suggestion container | Object | {} |
|
||
| onSearchChange | Callback function called when search content changes | function(value:String) | [] |
|
||
| onChange | Callback function called when content of input changes | function(editorState: EditorState) | null |
|
||
| onSelect | Callback function called when select from suggestions | function(suggestion: String) | null |
|
||
| notFoundContent| suggestion when suggestions empty | string | '无匹配结果,轻敲空格完成输入' |
|
||
| loading | loading mode | boolean | false |
|
||
| multiLines | multilines mode | boolean | false |
|
||
| prefix | character which will trigger Mention to show mention list | string | '@' |
|
||
| defaultValue | default value | EditorState, you can use `Mention.toEditorState` to convert text to `EditorState` | null |
|
||
| value | core state of mention | EditorState | null |
|
||
| placeHolder | placeholder of input | string | null |
|
||
|
||
### Nav props
|
||
|
||
| Property | Description | Type | Default |
|
||
|----------|---------------|----------|--------------|
|
||
| value | value of suggestion,the value will insert into input filed while selected | string | "" |
|
||
| children | suggestion content | Objet | {} |
|