mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-16 09:39:10 +08:00
066be35de3
* feat: support options * feat: update package * feat: update package * feat: update doc * feat: update doc * feat: update doc * feat: add test case
238 lines
5.7 KiB
TypeScript
238 lines
5.7 KiB
TypeScript
import classNames from 'classnames';
|
|
import RcMentions from 'rc-mentions';
|
|
import type {
|
|
MentionsProps as RcMentionsProps,
|
|
MentionsRef as RcMentionsRef,
|
|
DataDrivenOptionProps as MentionsOptionProps,
|
|
} from 'rc-mentions/lib/Mentions';
|
|
import { composeRef } from 'rc-util/lib/ref';
|
|
import * as React from 'react';
|
|
import { ConfigContext } from '../config-provider';
|
|
import defaultRenderEmpty from '../config-provider/defaultRenderEmpty';
|
|
import { FormItemInputContext } from '../form/context';
|
|
import Spin from '../spin';
|
|
import type { InputStatus } from '../_util/statusUtils';
|
|
import { getMergedStatus, getStatusClassNames } from '../_util/statusUtils';
|
|
import warning from '../_util/warning';
|
|
|
|
export const { Option } = RcMentions;
|
|
|
|
function loadingFilterOption() {
|
|
return true;
|
|
}
|
|
|
|
export type MentionPlacement = 'top' | 'bottom';
|
|
|
|
export type {
|
|
DataDrivenOptionProps as MentionsOptionProps,
|
|
} from 'rc-mentions/lib/Mentions';
|
|
|
|
export interface OptionProps {
|
|
value: string;
|
|
children: React.ReactNode;
|
|
[key: string]: any;
|
|
}
|
|
|
|
export interface MentionProps extends RcMentionsProps {
|
|
loading?: boolean;
|
|
status?: InputStatus;
|
|
options?: MentionsOptionProps[];
|
|
}
|
|
|
|
export interface MentionsRef extends RcMentionsRef {}
|
|
|
|
export interface MentionState {
|
|
focused: boolean;
|
|
}
|
|
|
|
interface MentionsConfig {
|
|
prefix?: string | string[];
|
|
split?: string;
|
|
}
|
|
|
|
interface MentionsEntity {
|
|
prefix: string;
|
|
value: string;
|
|
}
|
|
|
|
interface CompoundedComponent
|
|
extends React.ForwardRefExoticComponent<MentionProps & React.RefAttributes<MentionsRef>> {
|
|
Option: typeof Option;
|
|
getMentions: (value: string, config?: MentionsConfig) => MentionsEntity[];
|
|
}
|
|
|
|
const InternalMentions: React.ForwardRefRenderFunction<MentionsRef, MentionProps> = (
|
|
{
|
|
prefixCls: customizePrefixCls,
|
|
className,
|
|
disabled,
|
|
loading,
|
|
filterOption,
|
|
children,
|
|
notFoundContent,
|
|
options,
|
|
status: customStatus,
|
|
...restProps
|
|
},
|
|
ref,
|
|
) => {
|
|
const [focused, setFocused] = React.useState(false);
|
|
const innerRef = React.useRef<MentionsRef>();
|
|
const mergedRef = composeRef(ref, innerRef);
|
|
|
|
// =================== Warning =====================
|
|
if (process.env.NODE_ENV !== 'production') {
|
|
warning(
|
|
!children,
|
|
'Mentions',
|
|
'`Mentions.Option` is deprecated. Please use `options` instead.',
|
|
);
|
|
}
|
|
|
|
const { getPrefixCls, renderEmpty, direction } = React.useContext(ConfigContext);
|
|
const {
|
|
status: contextStatus,
|
|
hasFeedback,
|
|
feedbackIcon,
|
|
} = React.useContext(FormItemInputContext);
|
|
const mergedStatus = getMergedStatus(contextStatus, customStatus);
|
|
|
|
const onFocus: React.FocusEventHandler<HTMLTextAreaElement> = (...args) => {
|
|
if (restProps.onFocus) {
|
|
restProps.onFocus(...args);
|
|
}
|
|
setFocused(true);
|
|
};
|
|
|
|
const onBlur: React.FocusEventHandler<HTMLTextAreaElement> = (...args) => {
|
|
if (restProps.onBlur) {
|
|
restProps.onBlur(...args);
|
|
}
|
|
|
|
setFocused(false);
|
|
};
|
|
|
|
const getNotFoundContent = () => {
|
|
if (notFoundContent !== undefined) {
|
|
return notFoundContent;
|
|
}
|
|
|
|
return (renderEmpty || defaultRenderEmpty)('Select');
|
|
};
|
|
|
|
const getOptions = () => {
|
|
if (loading) {
|
|
return (
|
|
<Option value="ANTD_SEARCHING" disabled>
|
|
<Spin size="small" />
|
|
</Option>
|
|
);
|
|
}
|
|
|
|
return children;
|
|
};
|
|
|
|
const mergedOptions = loading
|
|
? [
|
|
{
|
|
value: 'ANTD_SEARCHING',
|
|
disabled: true,
|
|
label: <Spin size="small" />,
|
|
},
|
|
]
|
|
: options;
|
|
|
|
const getFilterOption = (): any => {
|
|
if (loading) {
|
|
return loadingFilterOption;
|
|
}
|
|
return filterOption;
|
|
};
|
|
|
|
const prefixCls = getPrefixCls('mentions', customizePrefixCls);
|
|
|
|
const mergedClassName = classNames(
|
|
{
|
|
[`${prefixCls}-disabled`]: disabled,
|
|
[`${prefixCls}-focused`]: focused,
|
|
[`${prefixCls}-rtl`]: direction === 'rtl',
|
|
},
|
|
getStatusClassNames(prefixCls, mergedStatus),
|
|
!hasFeedback && className,
|
|
);
|
|
|
|
const mentions = (
|
|
<RcMentions
|
|
prefixCls={prefixCls}
|
|
notFoundContent={getNotFoundContent()}
|
|
className={mergedClassName}
|
|
disabled={disabled}
|
|
direction={direction}
|
|
{...restProps}
|
|
filterOption={getFilterOption()}
|
|
onFocus={onFocus}
|
|
onBlur={onBlur}
|
|
ref={mergedRef as any}
|
|
options={mergedOptions}
|
|
>
|
|
{getOptions()}
|
|
</RcMentions>
|
|
);
|
|
|
|
if (hasFeedback) {
|
|
return (
|
|
<div
|
|
className={classNames(
|
|
`${prefixCls}-affix-wrapper`,
|
|
getStatusClassNames(`${prefixCls}-affix-wrapper`, mergedStatus, hasFeedback),
|
|
className,
|
|
)}
|
|
>
|
|
{mentions}
|
|
<span className={`${prefixCls}-suffix`}>{feedbackIcon}</span>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
return mentions;
|
|
};
|
|
|
|
const Mentions = React.forwardRef<MentionsRef, MentionProps>(
|
|
InternalMentions,
|
|
) as CompoundedComponent;
|
|
if (process.env.NODE_ENV !== 'production') {
|
|
Mentions.displayName = 'Mentions';
|
|
}
|
|
Mentions.Option = Option;
|
|
|
|
Mentions.getMentions = (value: string = '', config: MentionsConfig = {}): MentionsEntity[] => {
|
|
const { prefix = '@', split = ' ' } = config;
|
|
const prefixList: string[] = Array.isArray(prefix) ? prefix : [prefix];
|
|
|
|
return value
|
|
.split(split)
|
|
.map((str = ''): MentionsEntity | null => {
|
|
let hitPrefix: string | null = null;
|
|
|
|
prefixList.some((prefixStr) => {
|
|
const startStr = str.slice(0, prefixStr.length);
|
|
if (startStr === prefixStr) {
|
|
hitPrefix = prefixStr;
|
|
return true;
|
|
}
|
|
return false;
|
|
});
|
|
|
|
if (hitPrefix !== null) {
|
|
return {
|
|
prefix: hitPrefix,
|
|
value: str.slice((hitPrefix as string).length),
|
|
};
|
|
}
|
|
return null;
|
|
})
|
|
.filter((entity): entity is MentionsEntity => !!entity && !!entity.value);
|
|
};
|
|
|
|
export default Mentions;
|