@navikt/ds-react
Version:
React components from the Norwegian Labour and Welfare Administration.
50 lines (49 loc) • 2.03 kB
TypeScript
import React from "react";
import { AsChild } from "../../util/types/AsChild.js";
import { CustomFocusEvent, CustomPointerDownEvent } from "./util/dispatchCustomEvent.js";
interface DismissableLayerBaseProps extends React.HTMLAttributes<HTMLDivElement> {
/**
* When `true`, hover/focus/click interactions will be disabled on elements outside
* the `DismissableLayer`. Users will need to click twice on outside elements to
* interact with them: once to close the `DismissableLayer`, and again to trigger the element.
*/
disableOutsidePointerEvents?: boolean;
/**
* Event handler called when the escape key is down.
* Can be prevented.
*/
onEscapeKeyDown?: (event: KeyboardEvent) => void;
/**
* Event handler called when the a `pointerdown` event happens outside of the `DismissableLayer`.
* Can be prevented.
*/
onPointerDownOutside?: (event: CustomPointerDownEvent) => void;
/**
* Event handler called when the focus moves outside of the `DismissableLayer`.
* Can be prevented.
*/
onFocusOutside?: (event: CustomFocusEvent) => void;
/**
* Event handler called when an interaction happens outside the `DismissableLayer`.
* Specifically, when a `pointerdown` event happens outside or focus moves outside of it.
* Can be prevented.
*/
onInteractOutside?: (event: CustomPointerDownEvent | CustomFocusEvent) => void;
/**
* Handler called when the `DismissableLayer` should be dismissed
*/
onDismiss?: () => void;
/**
* Stops `onDismiss` from beeing called when interacting with the `safeZone` elements.
*/
safeZone?: {
anchor?: Element | null;
};
/**
* @default true
*/
enabled?: boolean;
}
type DismissableLayerProps = DismissableLayerBaseProps & AsChild;
declare const DismissableLayer: React.ForwardRefExoticComponent<DismissableLayerProps & React.RefAttributes<HTMLDivElement>>;
export { DismissableLayer, type DismissableLayerProps };