import * as React from 'react'; import RcCascader from 'rc-cascader'; import arrayTreeFilter from 'array-tree-filter'; import classNames from 'classnames'; import omit from 'rc-util/lib/omit'; import KeyCode from 'rc-util/lib/KeyCode'; import CloseCircleFilled from '@ant-design/icons/CloseCircleFilled'; import DownOutlined from '@ant-design/icons/DownOutlined'; import RightOutlined from '@ant-design/icons/RightOutlined'; import RedoOutlined from '@ant-design/icons/RedoOutlined'; import LeftOutlined from '@ant-design/icons/LeftOutlined'; import Input from '../input'; import { ConfigConsumer, ConfigConsumerProps, RenderEmptyHandler, DirectionType, } from '../config-provider'; import LocaleReceiver from '../locale-provider/LocaleReceiver'; import devWarning from '../_util/devWarning'; import SizeContext, { SizeType } from '../config-provider/SizeContext'; import { replaceElement } from '../_util/reactNode'; import { getTransitionName } from '../_util/motion'; export interface CascaderOptionType { value?: string | number; label?: React.ReactNode; disabled?: boolean; isLeaf?: boolean; loading?: boolean; children?: Array; [key: string]: any; } export interface FieldNamesType { value?: string | number; label?: string; children?: string; } export interface FilledFieldNamesType { value: string | number; label: string; children: string; } export type CascaderExpandTrigger = 'click' | 'hover'; export type CascaderValueType = (string | number)[]; export interface ShowSearchType { filter?: (inputValue: string, path: CascaderOptionType[], names: FilledFieldNamesType) => boolean; render?: ( inputValue: string, path: CascaderOptionType[], prefixCls: string | undefined, names: FilledFieldNamesType, ) => React.ReactNode; sort?: ( a: CascaderOptionType[], b: CascaderOptionType[], inputValue: string, names: FilledFieldNamesType, ) => number; matchInputWidth?: boolean; limit?: number | false; } export interface CascaderProps { /** 可选项数据源 */ options: CascaderOptionType[]; /** 默认的选中项 */ defaultValue?: CascaderValueType; /** 指定选中项 */ value?: CascaderValueType; /** 选择完成后的回调 */ onChange?: (value: CascaderValueType, selectedOptions?: CascaderOptionType[]) => void; /** 选择后展示的渲染函数 */ displayRender?: (label: string[], selectedOptions?: CascaderOptionType[]) => React.ReactNode; /** 自定义样式 */ style?: React.CSSProperties; /** 自定义类名 */ className?: string; /** 自定义浮层类名 */ popupClassName?: string; /** 浮层预设位置:`bottomLeft` `bottomRight` `topLeft` `topRight` */ popupPlacement?: string; /** 输入框占位文本 */ placeholder?: string; /** 输入框大小,可选 `large` `default` `small` */ size?: SizeType; /** 输入框 name */ name?: string; /** 输入框 id */ id?: string; /** Whether has border style */ bordered?: boolean; /** 禁用 */ disabled?: boolean; /** 是否支持清除 */ allowClear?: boolean; /** 自动获取焦点 */ autoFocus?: boolean; showSearch?: boolean | ShowSearchType; notFoundContent?: React.ReactNode; loadData?: (selectedOptions?: CascaderOptionType[]) => void; /** 次级菜单的展开方式,可选 'click' 和 'hover' */ expandTrigger?: CascaderExpandTrigger; expandIcon?: React.ReactNode; /** 当此项为 true 时,点选每级菜单选项值都会发生变化 */ changeOnSelect?: boolean; /** 浮层可见变化时回调 */ onPopupVisibleChange?: (popupVisible: boolean) => void; prefixCls?: string; inputPrefixCls?: string; getPopupContainer?: (triggerNode: HTMLElement) => HTMLElement; popupVisible?: boolean; /** Use this after antd@3.7.0 */ fieldNames?: FieldNamesType; suffixIcon?: React.ReactNode; dropdownRender?: (menus: React.ReactNode) => React.ReactNode; // Miss prop defines. autoComplete?: string; transitionName?: string; children?: React.ReactElement; } export interface CascaderState { inputFocused: boolean; inputValue: string; value: CascaderValueType; popupVisible: boolean | undefined; flattenOptions: CascaderOptionType[][] | undefined; prevProps: CascaderProps; } interface CascaderLocale { placeholder?: string; } // We limit the filtered item count by default const defaultLimit = 50; // keep value when filtering const keepFilteredValueField = '__KEEP_FILTERED_OPTION_VALUE'; function highlightKeyword(str: string, keyword: string, prefixCls: string | undefined) { return str.split(keyword).map((node: string, index: number) => index === 0 ? node : [ {keyword} , node, ], ); } function defaultFilterOption( inputValue: string, path: CascaderOptionType[], names: FilledFieldNamesType, ) { return path.some(option => (option[names.label] as string).indexOf(inputValue) > -1); } function defaultRenderFilteredOption( inputValue: string, path: CascaderOptionType[], prefixCls: string | undefined, names: FilledFieldNamesType, ) { return path.map((option, index) => { const label = option[names.label]; const node = (label as string).indexOf(inputValue) > -1 ? highlightKeyword(label as string, inputValue, prefixCls) : label; return index === 0 ? node : [' / ', node]; }); } function defaultSortFilteredOption( a: CascaderOptionType[], b: CascaderOptionType[], inputValue: string, names: FilledFieldNamesType, ) { function callback(elem: CascaderOptionType) { return (elem[names.label] as string).indexOf(inputValue) > -1; } return a.findIndex(callback) - b.findIndex(callback); } function getFieldNames({ fieldNames }: CascaderProps) { return fieldNames; } function getFilledFieldNames(props: CascaderProps) { const fieldNames = getFieldNames(props) || {}; const names: FilledFieldNamesType = { children: fieldNames.children || 'children', label: fieldNames.label || 'label', value: fieldNames.value || 'value', }; return names; } function flattenTree( options: CascaderOptionType[], props: CascaderProps, ancestor: CascaderOptionType[] = [], ) { const names: FilledFieldNamesType = getFilledFieldNames(props); let flattenOptions: CascaderOptionType[][] = []; const childrenName = names.children; options.forEach(option => { const path = ancestor.concat(option); if (props.changeOnSelect || !option[childrenName] || !option[childrenName].length) { flattenOptions.push(path); } if (option[childrenName]) { flattenOptions = flattenOptions.concat(flattenTree(option[childrenName], props, path)); } }); return flattenOptions; } const defaultDisplayRender = (label: string[]) => label.join(' / '); function warningValueNotExist(list: CascaderOptionType[], fieldNames: FieldNamesType = {}) { (list || []).forEach(item => { const valueFieldName = fieldNames.value || 'value'; devWarning(valueFieldName in item, 'Cascader', 'Not found `value` in `options`.'); warningValueNotExist(item[fieldNames.children || 'children'], fieldNames); }); } function getEmptyNode( renderEmpty: RenderEmptyHandler, names: FilledFieldNamesType, notFoundContent?: React.ReactNode, ) { return { [names.value]: 'ANT_CASCADER_NOT_FOUND', [names.label]: notFoundContent || renderEmpty('Cascader'), disabled: true, isEmptyNode: true, }; } class Cascader extends React.Component { static defaultProps = { options: [], disabled: false, allowClear: true, bordered: true, }; static getDerivedStateFromProps(nextProps: CascaderProps, { prevProps }: CascaderState) { const newState: Partial = { prevProps: nextProps, }; if ('value' in nextProps) { newState.value = nextProps.value || []; } if ('popupVisible' in nextProps) { newState.popupVisible = nextProps.popupVisible; } if (nextProps.showSearch && prevProps.options !== nextProps.options) { newState.flattenOptions = flattenTree(nextProps.options, nextProps); } if (process.env.NODE_ENV !== 'production' && nextProps.options) { warningValueNotExist(nextProps.options, getFieldNames(nextProps)); } return newState; } cachedOptions: CascaderOptionType[] = []; clearSelectionTimeout: any; private input: Input; constructor(props: CascaderProps) { super(props); this.state = { value: props.value || props.defaultValue || [], inputValue: '', inputFocused: false, popupVisible: props.popupVisible, flattenOptions: props.showSearch ? flattenTree(props.options, props) : undefined, prevProps: props, }; } componentWillUnmount() { if (this.clearSelectionTimeout) { clearTimeout(this.clearSelectionTimeout); } } setValue = (value: CascaderValueType, selectedOptions: CascaderOptionType[] = []) => { if (!('value' in this.props)) { this.setState({ value }); } const { onChange } = this.props; onChange?.(value, selectedOptions); }; getLabel() { const { options, displayRender = defaultDisplayRender as Function } = this.props; const names = getFilledFieldNames(this.props); const { value } = this.state; const unwrappedValue = Array.isArray(value[0]) ? value[0] : value; const selectedOptions: CascaderOptionType[] = arrayTreeFilter( options, (o: CascaderOptionType, level: number) => o[names.value] === unwrappedValue[level], { childrenKeyName: names.children }, ); const label = selectedOptions.length ? selectedOptions.map(o => o[names.label]) : value; return displayRender(label, selectedOptions); } saveInput = (node: Input) => { this.input = node; }; handleChange = (value: any, selectedOptions: CascaderOptionType[]) => { this.setState({ inputValue: '' }); if (selectedOptions[0].__IS_FILTERED_OPTION) { const unwrappedValue = selectedOptions[0][keepFilteredValueField] === undefined ? value[0] : selectedOptions[0][keepFilteredValueField]; const unwrappedSelectedOptions = selectedOptions[0].path; this.setValue(unwrappedValue, unwrappedSelectedOptions); return; } this.setValue(value, selectedOptions); }; handlePopupVisibleChange = (popupVisible: boolean) => { if (!('popupVisible' in this.props)) { this.setState(state => ({ popupVisible, inputFocused: popupVisible, inputValue: popupVisible ? state.inputValue : '', })); } const { onPopupVisibleChange } = this.props; onPopupVisibleChange?.(popupVisible); }; handleInputBlur = () => { this.setState({ inputFocused: false, }); }; handleInputClick = (e: React.MouseEvent) => { const { inputFocused, popupVisible } = this.state; // Prevent `Trigger` behaviour. if (inputFocused || popupVisible) { e.stopPropagation(); } }; handleKeyDown = (e: React.KeyboardEvent) => { // SPACE => https://github.com/ant-design/ant-design/issues/16871 if (e.keyCode === KeyCode.BACKSPACE || e.keyCode === KeyCode.SPACE) { e.stopPropagation(); } }; handleInputChange = (e: React.ChangeEvent) => { const { popupVisible } = this.state; const inputValue = e.target.value; if (!popupVisible) { this.handlePopupVisibleChange(true); } this.setState({ inputValue }); }; clearSelection = (e: React.MouseEvent) => { const { inputValue } = this.state; e.preventDefault(); e.stopPropagation(); if (!inputValue) { this.handlePopupVisibleChange(false); this.clearSelectionTimeout = setTimeout(() => { this.setValue([]); }, 200); } else { this.setState({ inputValue: '' }); } }; generateFilteredOptions(prefixCls: string | undefined, renderEmpty: RenderEmptyHandler) { const { showSearch, notFoundContent } = this.props; const names: FilledFieldNamesType = getFilledFieldNames(this.props); const { filter = defaultFilterOption, render = defaultRenderFilteredOption, sort = defaultSortFilteredOption, limit = defaultLimit, } = showSearch as ShowSearchType; const { flattenOptions = [], inputValue } = this.state; // Limit the filter if needed let filtered: Array; if (limit > 0) { filtered = []; let matchCount = 0; // Perf optimization to filter items only below the limit flattenOptions.some(path => { const match = filter(this.state.inputValue, path, names); if (match) { filtered.push(path); matchCount += 1; } return matchCount >= limit; }); } else { devWarning( typeof limit !== 'number', 'Cascader', "'limit' of showSearch should be positive number or false.", ); filtered = flattenOptions.filter(path => filter(this.state.inputValue, path, names)); } filtered = filtered.sort((a, b) => sort(a, b, inputValue, names)); if (filtered.length > 0) { // Fix issue: https://github.com/ant-design/ant-design/issues/26554 const field = names.value === names.label ? keepFilteredValueField : names.value; return filtered.map( (path: CascaderOptionType[]) => ({ __IS_FILTERED_OPTION: true, path, [field]: path.map((o: CascaderOptionType) => o[names.value]), [names.label]: render(inputValue, path, prefixCls, names), disabled: path.some((o: CascaderOptionType) => !!o.disabled), isEmptyNode: true, } as CascaderOptionType), ); } return [getEmptyNode(renderEmpty, names, notFoundContent)]; } focus() { this.input.focus(); } blur() { this.input.blur(); } getPopupPlacement(direction: DirectionType = 'ltr') { const { popupPlacement } = this.props; if (popupPlacement !== undefined) { return popupPlacement; } return direction === 'rtl' ? 'bottomRight' : 'bottomLeft'; } renderCascader = ( { getPopupContainer: getContextPopupContainer, getPrefixCls, renderEmpty, direction, }: ConfigConsumerProps, locale: CascaderLocale, ) => ( {size => { const { props, state } = this; const { prefixCls: customizePrefixCls, inputPrefixCls: customizeInputPrefixCls, children, placeholder = locale.placeholder || 'Please select', size: customizeSize, disabled, className, style, allowClear, showSearch = false, suffixIcon, expandIcon, notFoundContent, popupClassName, bordered, dropdownRender, ...otherProps } = props; const mergedSize = customizeSize || size; const { value, inputFocused } = state; const isRtlLayout = direction === 'rtl'; const prefixCls = getPrefixCls('cascader', customizePrefixCls); const inputPrefixCls = getPrefixCls('input', customizeInputPrefixCls); const sizeCls = classNames({ [`${inputPrefixCls}-lg`]: mergedSize === 'large', [`${inputPrefixCls}-sm`]: mergedSize === 'small', }); const clearIcon = (allowClear && !disabled && value.length > 0) || state.inputValue ? ( ) : null; const arrowCls = classNames({ [`${prefixCls}-picker-arrow`]: true, [`${prefixCls}-picker-arrow-expand`]: state.popupVisible, }); const pickerCls = classNames( `${prefixCls}-picker`, { [`${prefixCls}-picker-rtl`]: isRtlLayout, [`${prefixCls}-picker-with-value`]: state.inputValue, [`${prefixCls}-picker-disabled`]: disabled, [`${prefixCls}-picker-${mergedSize}`]: !!mergedSize, [`${prefixCls}-picker-show-search`]: !!showSearch, [`${prefixCls}-picker-focused`]: inputFocused, [`${prefixCls}-picker-borderless`]: !bordered, }, className, ); // Fix bug of https://github.com/facebook/react/pull/5004 // and https://fb.me/react-unknown-prop const inputProps = omit( // Not know why these props left otherProps as typeof otherProps & { filterOption: any; renderFilteredOption: any; sortFilteredOption: any; defaultValue: any; }, [ 'onChange', 'options', 'popupPlacement', 'transitionName', 'displayRender', 'onPopupVisibleChange', 'changeOnSelect', 'expandTrigger', 'popupVisible', 'getPopupContainer', 'loadData', 'filterOption', 'renderFilteredOption', 'sortFilteredOption', 'fieldNames', ], ); let { options } = props; const names: FilledFieldNamesType = getFilledFieldNames(this.props); if (options && options.length > 0) { if (state.inputValue) { options = this.generateFilteredOptions(prefixCls, renderEmpty); } } else { options = [getEmptyNode(renderEmpty, names, notFoundContent)]; } // Dropdown menu should keep previous status until it is fully closed. if (!state.popupVisible) { options = this.cachedOptions; } else { this.cachedOptions = options; } const dropdownMenuColumnStyle: { width?: number; height?: string } = {}; const isNotFound = (options || []).length === 1 && options[0].isEmptyNode; if (isNotFound) { dropdownMenuColumnStyle.height = 'auto'; // Height of one row. } // The default value of `matchInputWidth` is `true` const resultListMatchInputWidth = (showSearch as ShowSearchType).matchInputWidth !== false; if (resultListMatchInputWidth && (state.inputValue || isNotFound) && this.input) { dropdownMenuColumnStyle.width = this.input.input.offsetWidth; } let inputIcon: React.ReactNode; if (suffixIcon) { inputIcon = replaceElement( suffixIcon, {suffixIcon}, () => ({ className: classNames({ [(suffixIcon as any).props.className!]: (suffixIcon as any).props.className, [`${prefixCls}-picker-arrow`]: true, }), }), ); } else { inputIcon = ; } const input: React.ReactElement = children || ( {this.getLabel()} 0 ? undefined : placeholder} className={`${prefixCls}-input ${sizeCls}`} value={state.inputValue} disabled={disabled} readOnly={!showSearch} autoComplete={inputProps.autoComplete || 'off'} onClick={showSearch ? this.handleInputClick : undefined} onBlur={showSearch ? this.handleInputBlur : undefined} onKeyDown={this.handleKeyDown} onChange={showSearch ? this.handleInputChange : undefined} /> {clearIcon} {inputIcon} ); let expandIconNode; if (expandIcon) { expandIconNode = expandIcon; } else { expandIconNode = isRtlLayout ? : ; } const loadingIcon = ( ); const getPopupContainer = props.getPopupContainer || getContextPopupContainer; const rest = omit(props as typeof props & { inputIcon: any; loadingIcon: any }, [ 'inputIcon', 'expandIcon', 'loadingIcon', 'bordered', 'className', ]); const rcCascaderPopupClassName = classNames(popupClassName, { [`${prefixCls}-menu-${direction}`]: direction === 'rtl', [`${prefixCls}-menu-empty`]: options.length === 1 && options[0].value === 'ANT_CASCADER_NOT_FOUND', }); const rootPrefixCls = getPrefixCls(); return ( {input} ); }} ); render() { return ( {(configArgument: ConfigConsumerProps) => ( {locale => this.renderCascader(configArgument, locale)} )} ); } } export default Cascader;