ant-design/components/mentions/index.en-US.md
MadCcc 40e77c40d3
docs: overview dark cover (#40666)
* docs: add dark overview

* docs: show dark cover in dark theme

* docs: update cover
2023-02-09 22:17:31 +08:00

3.7 KiB

category group title cover coverDark demo
Components Data Entry Mentions https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*e4bXT7Uhi9YAAAAAAAAAAAAADrJ8AQ/original https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*pxR2S53P_xoAAAAAAAAAAAAADrJ8AQ/original
cols
2

Mention component.

When To Use

When you need to mention someone or something.

Usage upgrade after 5.1.0

// works when >=5.1.0, recommended ✅
const options = [{ value: 'sample', label: 'sample' }];
return <Mentions options={options} />;

// works when <5.1.0, deprecated when >=5.1.0 🙅🏻‍♀️
return (
  <Mentions onChange={onChange}>
    <Mentions.Option value="sample">Sample</Mentions.Option>
  </Mentions>
);

Examples

Basic Asynchronous loading With Form Customize Trigger Token disabled or readOnly Placement autoSize Status _InternalPanelDoNotUseOrYouWillBeFired

API

Mention

Property Description Type Default Version
autoFocus Auto get focus when component mounted boolean false
autoSize Textarea height autosize feature, can be set to true | false or an object { minRows: 2, maxRows: 6 } boolean | object false
defaultValue Default value string -
filterOption Customize filter option logic false | (input: string, option: OptionProps) => boolean -
getPopupContainer Set the mount HTML node for suggestions () => HTMLElement -
notFoundContent Set mentions content when not match ReactNode Not Found
placement Set popup placement top | bottom bottom
prefix Set trigger prefix keyword string | string[] @
split Set split string before and after selected mention string
status Set validation status 'error' | 'warning' | 'success' | 'validating' - 4.19.0
validateSearch Customize trigger search logic (text: string, props: MentionsProps) => void -
value Set value of mentions string -
onBlur Trigger when mentions lose focus () => void -
onChange Trigger when value changed (text: string) => void -
onFocus Trigger when mentions get focus () => void -
onResize The callback function that is triggered when textarea resize function({ width, height }) -
onSearch Trigger when prefix hit (text: string, prefix: string) => void -
onSelect Trigger when user select the option (option: OptionProps, prefix: string) => void -
options Option Configuration Options [] 5.1.0

Mention methods

Name Description
blur() Remove focus
focus() Get focus

Option

Property Description Type Default
label Title of the option React.ReactNode -
key The key value of the option string -
disabled Optional boolean -
className className string -
style The style of the option React.CSSProperties -