import React from 'react'; import type { MenuTheme, OtherHTMLAttributes } from '@instructure/shared-types'; import type { WithStyleProps, ComponentStyle } from '@instructure/emotion'; import type { PlacementPropValues, PositionConstraint, PositionMountNode } from '@instructure/ui-position'; import type { Popover } from '@instructure/ui-popover/v11_6'; import type { WithDeterministicIdProps } from '@instructure/ui-react-utils'; import { MenuItem } from './MenuItem'; import type { Menu } from './index'; import type { MenuItemProps } from './MenuItem/props'; type MenuOwnProps = { /** * Children of type `Menu.Item`, `Menu.Group`, `Menu.Separator`, or `Menu` */ children?: React.ReactNode; /** * Description of the ``. The component uses it to add its value to * the `aria-label` attribute. */ label?: string; /** * Is the `` disabled */ disabled?: boolean; /** * The trigger element, if the `` is to render as a popover */ trigger?: React.ReactNode; /** * If a trigger is supplied, where should the `` be placed (relative to the trigger) */ placement?: PlacementPropValues; /** * Should the `` be open for the initial render */ defaultShow?: boolean; /** * Is the `` open (should be accompanied by `onToggle`) */ show?: boolean; /** * Callback fired when the `` is toggled open/closed. When used with `show`, * the component will not control its own state. */ onToggle?: (show: boolean, menu: Menu) => void; /** * Callback fired when an item within the `` is selected */ onSelect?: (e: React.MouseEvent, value: MenuItemProps['value'] | MenuItemProps['value'][], selected: MenuItemProps['selected'], args: MenuItem) => void; /** * If a trigger is supplied, callback fired when the `` is closed */ onDismiss?: (event: React.UIEvent | React.FocusEvent, documentClick: boolean) => void; /** * If a trigger is supplied, callback fired when the `` trigger is focused */ onFocus?: (event: React.FocusEvent) => void; /** * If a trigger is supplied, callback fired onMouseOver for the `` trigger */ onMouseOver?: (event: React.MouseEvent) => void; /** * Callback fired on the onKeyDown of the `` */ onKeyDown?: (event: React.KeyboardEvent) => void; /** * Callback fired on the onKeyUp of the `` */ onKeyUp?: (event: React.KeyboardEvent) => void; /** * A function that returns a reference to the `` */ menuRef?: (el: HTMLElement | null) => void; /** * A function that returns a reference to the `` */ popoverRef?: (el: Popover | null) => void; /** * If a trigger is supplied, an element or a function returning an element to use as the mount node * for the `` (defaults to `document.body`) */ mountNode?: PositionMountNode; /** * The parent in which to constrain the menu. * One of: 'window', 'scroll-parent', 'parent', 'none', an element, * or a function returning an element */ constrain?: PositionConstraint; /** * If a trigger is supplied, should the `` hide when an item is selected */ shouldHideOnSelect?: boolean; /** * If a trigger is supplied, should the `` focus the trigger on after closing */ shouldFocusTriggerOnClose?: boolean; /** * If a trigger is supplied, this prop can set the CSS `display` property on the `` container element of the underlying Position component */ positionContainerDisplay?: 'inline-block' | 'block'; /** * The type of `` */ type?: 'flyout'; id?: string; /** * Whether or not an arrow pointing to the trigger should be rendered */ withArrow?: boolean; /** * The horizontal offset for the positioned content. * Works only if `trigger` is provided. */ offsetX?: string | number; /** * The vertical offset for the positioned content. * Works only if `trigger` is provided. */ offsetY?: string | number; /** * The maximum height the menu can be. If not set, the menu won't * scroll and will be as tall as the content requires */ maxHeight?: string | number; /** * Content to render in the label's info region. It is only visible on nested Menus. */ renderLabelInfo?: React.ReactNode | (() => React.ReactNode); }; type PropKeys = keyof MenuOwnProps; type AllowedPropKeys = Readonly>; type MenuProps = MenuOwnProps & WithStyleProps & Omit, 'controls'> & { controls?: React.AriaAttributes['aria-controls']; } & WithDeterministicIdProps; type MenuStyle = ComponentStyle<'menu'>; declare const allowedProps: AllowedPropKeys; export type { MenuProps, MenuStyle }; export { allowedProps }; //# sourceMappingURL=props.d.ts.map