feat(cascader): cascader

site/mobile/mobile.config.js

@@ -117,6 +117,11 @@ export default {
       name: 'back-top',
       component: () => import('tdesign-mobile-react/back-top/_example/index.tsx'),
     },
+    {
+      title: 'Cascader 级联选择器',
+      name: 'cascader',
+      component: () => import('tdesign-mobile-react/cascader/_example/index.tsx'),
+    },
     {
       title: 'Checkbox 多选框',
       name: 'checkbox',

site/web/site.config.js

@@ -131,6 +131,12 @@ export default {
       title: '输入',
       type: 'component',
       children: [
+        {
+          title: 'Cascader 级联选择器',
+          name: 'cascader',
+          path: '/mobile-react/components/cascader',
+          component: () => import('tdesign-mobile-react/cascader/cascader.md'),
+        },
         {
           title: 'CheckBox 多选框',
           name: 'checkbox',

src/cascader/Cascader.tsx

@@ -0,0 +1,307 @@
+import { useDeepCompareEffect } from 'ahooks';
+import classNames from 'classnames';
+import last from 'lodash/last';
+import React, { forwardRef, useCallback, useContext, useEffect, useMemo, useState } from 'react';
+import { CheckIcon, Icon } from 'tdesign-icons-react';
+import useDefault from 'tdesign-mobile-react/_util/useDefault';
+import { Popup } from 'tdesign-mobile-react/popup';
+import { Radio, RadioGroup } from 'tdesign-mobile-react/radio';
+import Tabs from 'tdesign-mobile-react/tabs';
+import TabContext from 'tdesign-mobile-react/tabs/context';
+import { StyledProps, TNode, TreeOptionData } from '../common';
+import { usePrefixClass } from '../hooks/useClass';
+import useDefaultProps from '../hooks/useDefaultProps';
+import { cascaderDefaultProps } from './defaultProps';
+import { TdCascaderProps } from './type';
+
+export interface CascaderProps extends TdCascaderProps, StyledProps {}
+
+const FixedTabs = ({ value }: { value: number }) => {
+  const { onChange } = useContext(TabContext);
+
+  useEffect(() => {
+    onChange(value);
+  }, [value, onChange]);
+
+  return null;
+};
+
+const Cascader = forwardRef<HTMLDivElement, CascaderProps>((props) => {
+  const cascaderClass = usePrefixClass('cascader');
+
+  const {
+    className,
+    style,
+    value,
+    defaultValue,
+    visible,
+    title,
+    placeholder,
+    theme,
+    subTitles,
+    options: inputOptions,
+    keys,
+    checkStrictly,
+    closeBtn,
+    onChange,
+    onClose,
+    onPick,
+  } = useDefaultProps<CascaderProps>(props, cascaderDefaultProps);
+
+  const [internalValue, setInternalValue] = useDefault(value, defaultValue, onChange);
+  const [internalVisible, setInternalVisible] = useDefault(visible, false, () => ({}));
+
+  const [internalSelectedValues, setInternalSelectedValues] = useState<CascaderProps['value'][]>([]);
+
+  // 根据 inputOptions 和 key 重新构建 options
+  const options = useMemo(() => {
+    const { label = 'label', value = 'value', children = 'children' } = keys || {};
+
+    const convert = (options: TreeOptionData[]) =>
+      options.map((item) => ({
+        label: item[label],
+        value: item[value],
+        children: Array.isArray(item[children]) ? convert(item[children]) : false,
+      }));
+
+    return convert(inputOptions);
+  }, [inputOptions, keys]);
+
+  const getOptionsList = useCallback((options: TreeOptionData[], internalSelectedValues: CascaderProps['value'][]) => {
+    const optionsList: TreeOptionData[][] = [options];
+
+    for (const value of internalSelectedValues) {
+      const lastOptions = last(optionsList);
+      const next = lastOptions.find((item) => item.value === value);
+      if (!next || !Array.isArray(next.children)) {
+        break;
+      }
+      optionsList.push(next.children);
+    }
+
+    return optionsList;
+  }, []);
+
+  const optionsList = useMemo(
+    () => getOptionsList(options, internalSelectedValues),
+    [getOptionsList, options, internalSelectedValues],
+  );
+
+  const [stepIndex, setStepIndex] = useState(0);
+
+  const labelList = useMemo(() => {
+    const labelList: {
+      label: TNode;
+      isPlaceholder: boolean;
+    }[] = [];
+
+    optionsList.forEach((options, index) => {
+      const value = internalSelectedValues[index];
+      const target = options.find((item) => item.value === value);
+      if (target) {
+        labelList.push({
+          label: target.label,
+          isPlaceholder: false,
+        });
+        return;
+      }
+
+      labelList.push({
+        label: placeholder,
+        isPlaceholder: true,
+      });
+    });
+
+    return labelList;
+  }, [optionsList, internalSelectedValues, placeholder]);
+
+  const selectedValuesByInterValue = useMemo(() => {
+    /**
+     * checkStrictly true 从外到内 匹配上就挺 返回整个链路上的value
+     * checkStrictly false 最后一级的 value 匹配时，返回整个链路上的value
+     */
+    const findValues = (options: TreeOptionData[]): CascaderProps['value'][] => {
+      for (const item of options) {
+        if (checkStrictly && item.value === internalValue) {
+          return [item.value];
+        }
+
+        const isLast = !(Array.isArray(item.children) && item.children.length);
+        if (isLast) {
+          if (item.value === internalValue) {
+            return [item.value];
+          }
+          continue;
+        }
+        const targetValue = findValues(item.children as TreeOptionData[]);
+        if (targetValue.length) {
+          return [item.value, ...targetValue];
+        }
+      }
+      return [];
+    };
+
+    return findValues(options);
+  }, [options, internalValue, checkStrictly]);
+
+  // 当 selectedValuesByInterValue 深度变化 的时候再控制 selectedValues
+  useDeepCompareEffect(() => {
+    setInternalSelectedValues(selectedValuesByInterValue);
+    setStepIndex(selectedValuesByInterValue.length);
+  }, [selectedValuesByInterValue]);
+
+  useEffect(() => {
+    const reviseStepIndex = Math.max(Math.min(stepIndex, optionsList.length - 1), 0);
+    if (reviseStepIndex !== stepIndex) {
+      setStepIndex(reviseStepIndex);
+    }
+  }, [optionsList, stepIndex]);
+
+  // 结束了
+  const onFinish = useCallback(
+    (selectedValues: CascaderProps['value'][]) => {
+      const selectedOptions = [...optionsList].slice(0, selectedValues.length).map((options, index) => {
+        const target = options.find((item) => item.value === selectedValues[index]);
+        const { label = 'label', value = 'value' } = keys || {};
+        return {
+          [label]: target?.label || '',
+          [value]: target?.value || '',
+        };
+      });
+      setInternalValue(last(selectedValues), selectedOptions as any);
+      onClose?.('finish');
+    },
+    [onClose, optionsList, setInternalValue, keys],
+  );
+
+  return (
+    <Popup
+      visible={internalVisible}
+      placement="bottom"
+      onVisibleChange={(visible, trigger) => {
+        setInternalVisible(visible);
+        onClose?.(trigger);
+      }}
+    >
+      <div className={classNames(cascaderClass, className)} style={style}>
+        <div className={`${cascaderClass}__title`}>{title}</div>
+        <div
+          className={`${cascaderClass}__close-btn`}
+          onClick={() => {
+            if (checkStrictly) {
+              onFinish(internalSelectedValues);
+              return;
+            }
+
+            setInternalVisible(false);
+            onClose?.('close-btn');
+          }}
+        >
+          {closeBtn === true ? <Icon name="close" size={24} /> : closeBtn}
+        </div>
+        <div className={`${cascaderClass}__content`}>
+          {labelList.length ? (
+            <div>
+              {theme === 'step' ? (
+                <div className={`${cascaderClass}__steps`}>
+                  {labelList.map((labeItem, index) => (
+                    <div
+                      key={index}
+                      className={`${cascaderClass}__step`}
+                      onClick={() => {
+                        setStepIndex(index);
+                      }}
+                    >
+                      <div
+                        className={classNames(`${cascaderClass}__step-dot`, {
+                          [`${cascaderClass}__step-dot--active`]: !labeItem.isPlaceholder,
+                          [`${cascaderClass}__step-dot--last`]: index === labelList.length - 1,
+                        })}
+                      />
+                      <div
+                        className={classNames(`${cascaderClass}__step-label`, {
+                          [`${cascaderClass}__step-label--active`]: index === stepIndex,
+                        })}
+                      >
+                        {labeItem.label}
+                      </div>
+                      <Icon name="chevron-right" size={22} className={`${cascaderClass}__step-arrow`} />
+                    </div>
+                  ))}
+                </div>
+              ) : null}
+              {theme === 'tab' ? (
+                <div>
+                  <Tabs
+                    list={labelList.map((item, index) => ({
+                      label: item.label as string,
+                      value: index,
+                    }))}
+                    defaultValue={stepIndex}
+                    change={(value) => {
+                      setStepIndex(value);
+                    }}
+                  >
+                    {/* TODO: Tabs 组加接收外部控制 通过子组件 调用 TabContext 中的 onChange 实现 */}
+                    <FixedTabs value={stepIndex} />
+                  </Tabs>
+                </div>
+              ) : null}
+            </div>
+          ) : null}
+          {subTitles[stepIndex] ? (
+            <div className={`${cascaderClass}__options-title`}>{subTitles[stepIndex]}</div>
+          ) : null}
+          <div
+            className={`${cascaderClass}__options-container`}
+            style={{
+              width: `${optionsList.length}00vw`,
+              transform: `translateX(-${stepIndex}00vw)`,
+            }}
+          >
+            {optionsList.map((curOptions, index) => (
+              <div className={`${cascaderClass}__options`} key={index}>
+                <div>
+                  <RadioGroup
+                    value={internalSelectedValues[index]}
+                    onChange={(value: string | number) => {
+                      const selectedValues = [...internalSelectedValues].slice(0, index);
+                      selectedValues.push(value);
+                      setInternalSelectedValues(selectedValues);
+
+                      setStepIndex(index + 1);
+
+                      onPick?.(value, index);
+
+                      const next = curOptions.find((item) => item.value === value);
+                      if (Array.isArray(next?.children)) {
+                        return;
+                      }
+
+                      onFinish(selectedValues);
+                    }}
+                  >
+                    {curOptions.map((item) => (
+                      <Radio
+                        allowUncheck={true}
+                        align="right"
+                        key={item.value}
+                        value={item.value}
+                        label={item.label}
+                        icon={[<CheckIcon key="1" color="#0052d9" />]}
+                      />
+                    ))}
+                  </RadioGroup>
+                </div>
+              </div>
+            ))}
+          </div>
+        </div>
+      </div>
+    </Popup>
+  );
+});
+
+Cascader.displayName = 'Cascader';
+
+export default Cascader;