UNPKG

@wordpress/components

Version:
248 lines (224 loc) 7.04 kB
import _extends from "@babel/runtime/helpers/esm/extends"; import { createElement } from "@wordpress/element"; /** * External dependencies */ import classnames from 'classnames'; /** * WordPress dependencies */ import { menu } from '@wordpress/icons'; /** * Internal dependencies */ import Button from '../button'; import Dropdown from '../dropdown'; import { NavigableMenu } from '../navigable-container'; function mergeProps() { let defaultProps = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {}; let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {}; const mergedProps = { ...defaultProps, ...props }; if (props.className && defaultProps.className) { mergedProps.className = classnames(props.className, defaultProps.className); } return mergedProps; } function isFunction(maybeFunc) { return typeof maybeFunc === 'function'; } /** * * The DropdownMenu displays a list of actions (each contained in a MenuItem, * MenuItemsChoice, or MenuGroup) in a compact way. It appears in a Popover * after the user has interacted with an element (a button or icon) or when * they perform a specific action. * * Render a Dropdown Menu with a set of controls: * * ```jsx * import { DropdownMenu } from '@wordpress/components'; * import { * more, * arrowLeft, * arrowRight, * arrowUp, * arrowDown, * } from '@wordpress/icons'; * * const MyDropdownMenu = () => ( * <DropdownMenu * icon={ more } * label="Select a direction" * controls={ [ * { * title: 'Up', * icon: arrowUp, * onClick: () => console.log( 'up' ), * }, * { * title: 'Right', * icon: arrowRight, * onClick: () => console.log( 'right' ), * }, * { * title: 'Down', * icon: arrowDown, * onClick: () => console.log( 'down' ), * }, * { * title: 'Left', * icon: arrowLeft, * onClick: () => console.log( 'left' ), * }, * ] } * /> * ); * ``` * * Alternatively, specify a `children` function which returns elements valid for * use in a DropdownMenu: `MenuItem`, `MenuItemsChoice`, or `MenuGroup`. * * ```jsx * import { DropdownMenu, MenuGroup, MenuItem } from '@wordpress/components'; * import { more, arrowUp, arrowDown, trash } from '@wordpress/icons'; * * const MyDropdownMenu = () => ( * <DropdownMenu icon={ more } label="Select a direction"> * { ( { onClose } ) => ( * <> * <MenuGroup> * <MenuItem icon={ arrowUp } onClick={ onClose }> * Move Up * </MenuItem> * <MenuItem icon={ arrowDown } onClick={ onClose }> * Move Down * </MenuItem> * </MenuGroup> * <MenuGroup> * <MenuItem icon={ trash } onClick={ onClose }> * Remove * </MenuItem> * </MenuGroup> * </> * ) } * </DropdownMenu> * ); * ``` * */ function DropdownMenu(dropdownMenuProps) { const { children, className, controls, icon = menu, label, popoverProps, toggleProps, menuProps, disableOpenOnArrowDown = false, text, noIcons } = dropdownMenuProps; if (!(controls !== null && controls !== void 0 && controls.length) && !isFunction(children)) { return null; } // Normalize controls to nested array of objects (sets of controls) let controlSets; if (controls !== null && controls !== void 0 && controls.length) { // @ts-expect-error The check below is needed because `DropdownMenus` // rendered by `ToolBarGroup` receive controls as a nested array. controlSets = controls; if (!Array.isArray(controlSets[0])) { // This is not ideal, but at this point we know that `controls` is // not a nested array, even if TypeScript doesn't. controlSets = [controls]; } } const mergedPopoverProps = mergeProps({ className: 'components-dropdown-menu__popover' }, popoverProps); return createElement(Dropdown, { className: classnames('components-dropdown-menu', className), popoverProps: mergedPopoverProps, renderToggle: _ref => { var _toggleProps$showTool; let { isOpen, onToggle } = _ref; const openOnArrowDown = event => { if (disableOpenOnArrowDown) { return; } if (!isOpen && event.code === 'ArrowDown') { event.preventDefault(); onToggle(); } }; const { as: Toggle = Button, ...restToggleProps } = toggleProps !== null && toggleProps !== void 0 ? toggleProps : {}; const mergedToggleProps = mergeProps({ className: classnames('components-dropdown-menu__toggle', { 'is-opened': isOpen }) }, restToggleProps); return createElement(Toggle, _extends({}, mergedToggleProps, { icon: icon, onClick: event => { onToggle(); if (mergedToggleProps.onClick) { mergedToggleProps.onClick(event); } }, onKeyDown: event => { openOnArrowDown(event); if (mergedToggleProps.onKeyDown) { mergedToggleProps.onKeyDown(event); } }, "aria-haspopup": "true", "aria-expanded": isOpen, label: label, text: text, showTooltip: (_toggleProps$showTool = toggleProps === null || toggleProps === void 0 ? void 0 : toggleProps.showTooltip) !== null && _toggleProps$showTool !== void 0 ? _toggleProps$showTool : true }), mergedToggleProps.children); }, renderContent: props => { var _controlSets; const mergedMenuProps = mergeProps({ 'aria-label': label, className: classnames('components-dropdown-menu__menu', { 'no-icons': noIcons }) }, menuProps); return createElement(NavigableMenu, _extends({}, mergedMenuProps, { role: "menu" }), isFunction(children) ? children(props) : null, (_controlSets = controlSets) === null || _controlSets === void 0 ? void 0 : _controlSets.flatMap((controlSet, indexOfSet) => controlSet.map((control, indexOfControl) => createElement(Button, { key: [indexOfSet, indexOfControl].join(), onClick: event => { event.stopPropagation(); props.onClose(); if (control.onClick) { control.onClick(); } }, className: classnames('components-dropdown-menu__menu-item', { 'has-separator': indexOfSet > 0 && indexOfControl === 0, 'is-active': control.isActive, 'is-icon-only': !control.title }), icon: control.icon, label: control.label, "aria-checked": control.role === 'menuitemcheckbox' || control.role === 'menuitemradio' ? control.isActive : undefined, role: control.role === 'menuitemcheckbox' || control.role === 'menuitemradio' ? control.role : 'menuitem', disabled: control.isDisabled }, control.title)))); } }); } export default DropdownMenu; //# sourceMappingURL=index.js.map