feat: support focusTrap

Author: zombieJ

src/Dialog/Content/Panel.tsx

@@ -46,14 +46,15 @@ const Panel = React.forwardRef<PanelRef, PanelProps>((props, ref) => {
     classNames: modalClassNames,
     styles: modalStyles,
     isFixedPos,
+    focusTrap,
   } = props;
 
   // ================================= Refs =================================
   const { panel: panelRef } = React.useContext(RefContext);
   const internalRef = useRef<HTMLDivElement>(null);
   const mergedRef = useComposeRef(holderRef, panelRef, internalRef);
 
-  useLockFocus(visible && isFixedPos, () => internalRef.current);
+  useLockFocus(visible && isFixedPos && focusTrap !== false, () => internalRef.current);
 
   React.useImperativeHandle(ref, () => ({
     focus: () => {

src/IDialogPropTypes.ts

@@ -58,6 +58,7 @@ export type IDialogPropTypes = {
   // https://github.com/ant-design/ant-design/issues/19771
   // https://github.com/react-component/dialog/issues/95
   focusTriggerAfterClose?: boolean;
+  focusTrap?: boolean;
 
   // Refs
   panelRef?: React.Ref<HTMLDivElement>;

tests/focus.spec.tsx

@@ -64,4 +64,22 @@ describe('Dialog.Focus', () => {
 
     expect(globalThis.__useLockFocusVisible).toBe(false);
   });
+
+  it('should not lock focus when focusTrap is false', () => {
+    render(
+      <Dialog
+        visible
+        focusTrap={false}
+        styles={{
+          wrapper: { position: 'fixed' },
+        }}
+      />,
+    );
+
+    act(() => {
+      jest.runAllTimers();
+    });
+
+    expect(globalThis.__useLockFocusVisible).toBe(false);
+  });
 });