Feature/panel default expand keys

examples/panel.tsx

@@ -99,6 +99,7 @@ export default () => {
           setValue2(nextValue);
         }}
         disabled={disabled}
+        defaultActiveKey={['bj', 'haidian']}
       />
 
       <Cascader.Panel options={addressOptions} disabled={disabled} direction="rtl" />

src/Cascader.tsx

@@ -159,6 +159,7 @@ export interface CascaderProps<
     value: GetValueType<OptionType, ValueField, Multiple>,
     selectOptions: OptionType[],
   ) => void;
+  defaultActiveKey?: React.Key[];
 }
 
 export type SingleValueType = (string | number)[];
@@ -175,6 +176,7 @@ export type InternalCascaderProps = Omit<CascaderProps, 'onChange' | 'value' | '
     value: InternalValueType,
     selectOptions: BaseOptionType[] | BaseOptionType[][],
   ) => void;
+  defaultActiveKey?: React.Key[];
 };
 
 export type CascaderRef = Omit<BaseSelectRef, 'scrollTo'>;

src/OptionList/List.tsx

@@ -29,7 +29,7 @@ export type RawOptionListProps = Pick<
   | 'direction'
   | 'open'
   | 'disabled'
->;
+> & { defaultActiveKey?: React.Key[]; };
 
 const RawOptionList = React.forwardRef<RefOptionListProps, RawOptionListProps>((props, ref) => {
   const {
@@ -41,6 +41,7 @@ const RawOptionList = React.forwardRef<RefOptionListProps, RawOptionListProps>((
     direction,
     open,
     disabled,
+    defaultActiveKey,
   } = props;
 
   const containerRef = React.useRef<HTMLDivElement>(null);
@@ -105,7 +106,7 @@ const RawOptionList = React.forwardRef<RefOptionListProps, RawOptionListProps>((
   const halfCheckedSet = React.useMemo(() => new Set(toPathKeys(halfValues)), [halfValues]);
 
   // ====================== Accessibility =======================
-  const [activeValueCells, setActiveValueCells] = useActive(multiple, open);
+  const [activeValueCells, setActiveValueCells] = useActive(multiple, open, defaultActiveKey);
 
   // =========================== Path ===========================
   const onPathOpen = (nextValueCells: React.Key[]) => {

src/OptionList/useActive.ts

@@ -7,14 +7,15 @@ import CascaderContext from '../context';
 const useActive = (
   multiple?: boolean,
   open?: boolean,
+  defaultActiveKey?: React.Key[],
 ): [React.Key[], (activeValueCells: React.Key[]) => void] => {
   const { values } = React.useContext(CascaderContext);
 
   const firstValueCells = values[0];
 
   // Record current dropdown active options
   // This also control the open status
-  const [activeValueCells, setActiveValueCells] = React.useState<React.Key[]>([]);
+  const [activeValueCells, setActiveValueCells] = React.useState<React.Key[]>(defaultActiveKey ?? []);
 
   React.useEffect(
     () => {

src/Panel.tsx

@@ -36,7 +36,8 @@ export type PickType =
   | 'style'
   | 'direction'
   | 'notFoundContent'
-  | 'disabled';
+  | 'disabled'
+  | 'defaultActiveKey';
 
 export type PanelProps<
   OptionType extends DefaultOptionType = DefaultOptionType,
@@ -70,6 +71,7 @@ export default function Panel<
     direction,
     notFoundContent = 'Not Found',
     disabled,
+    defaultActiveKey,
   } = props as Pick<InternalCascaderProps, PickType>;
 
   // ======================== Multiple ========================
@@ -203,6 +205,7 @@ export default function Panel<
             open
             direction={direction}
             disabled={disabled}
+            defaultActiveKey={defaultActiveKey}
           />
         )}
       </div>

tests/Panel.spec.tsx

@@ -79,6 +79,19 @@ describe('Cascader.Panel', () => {
     expect(onChange).toHaveBeenCalledWith([['bamboo', 'little']], expect.anything());
   });
 
+  it('multiple with defaultActiveKey', () => {
+    const onChange = jest.fn();
+    const { container } = render(
+      <Cascader.Panel
+        checkable
+        options={options}
+        onChange={onChange}
+        defaultActiveKey={['bamboo', 'little']}
+      />,
+    );
+    expect(container.querySelectorAll('.rc-cascader-menu')).toHaveLength(2);
+  });
+
   it('rtl', () => {
     const { container } = render(<Cascader.Panel options={options} direction="rtl" />);
 

tests/selector.spec.tsx

@@ -5,10 +5,10 @@ import Cascader from '../src';
 import { addressOptions } from './demoOptions';
 
 // Mock `useActive` hook
-jest.mock('../src/OptionList/useActive', () => (multiple: boolean, open: boolean) => {
+jest.mock('../src/OptionList/useActive', () => (multiple: boolean, open: boolean, defaultActiveKey: React.Key[]) => {
   // Pass to origin hooks
   const originHook = jest.requireActual('../src/OptionList/useActive').default;
-  const [activeValueCells, setActiveValueCells] = originHook(multiple, open);
+  const [activeValueCells, setActiveValueCells] = originHook(multiple, open, defaultActiveKey);
 
   (global as any).activeValueCells = activeValueCells;