@wordpress/components
Version:
UI components for WordPress.
67 lines (66 loc) • 2.55 kB
JavaScript
import clsx from "clsx";
import { useContext } from "@wordpress/element";
import ToolbarButton from "../toolbar-button/index.mjs";
import ToolbarGroupContainer from "./toolbar-group-container.mjs";
import ToolbarGroupCollapsed from "./toolbar-group-collapsed.mjs";
import ToolbarContext from "../toolbar-context/index.mjs";
import { jsx, jsxs } from "react/jsx-runtime";
// packages/components/src/toolbar/toolbar-group/index.tsx
function isNestedArray(arr) {
return Array.isArray(arr) && Array.isArray(arr[0]);
}
/**
* Renders a collapsible group of controls
*
* The `controls` prop accepts an array of sets. A set is an array of controls.
* Controls have the following shape:
*
* ```
* {
* icon: string,
* title: string,
* subscript: string,
* onClick: Function,
* isActive: boolean,
* isDisabled: boolean
* }
* ```
*
* For convenience it is also possible to pass only an array of controls. It is
* then assumed this is the only set.
*
* Either `controls` or `children` is required, otherwise this components
* renders nothing.
*
* @param props Component props.
* @param [props.controls] The controls to render in this toolbar.
* @param [props.children] Any other things to render inside the toolbar besides the controls.
* @param [props.className] Class to set on the container div.
* @param [props.isCollapsed] Turns ToolbarGroup into a dropdown menu.
* @param [props.title] ARIA label for dropdown menu if is collapsed.
*/
function ToolbarGroup({ controls = [], children, className, isCollapsed, title, ...props }) {
const accessibleToolbarState = useContext(ToolbarContext);
if ((!controls || !controls.length) && !children) return null;
const finalClassName = clsx(accessibleToolbarState ? "components-toolbar-group" : "components-toolbar", className);
let controlSets;
if (isNestedArray(controls)) controlSets = controls;
else controlSets = [controls];
if (isCollapsed) return /* @__PURE__ */ jsx(ToolbarGroupCollapsed, {
label: title,
controls: controlSets,
className: finalClassName,
children,
...props
});
return /* @__PURE__ */ jsxs(ToolbarGroupContainer, {
className: finalClassName,
...props,
children: [controlSets?.flatMap((controlSet, indexOfSet) => controlSet.map((control, indexOfControl) => /* @__PURE__ */ jsx(ToolbarButton, {
containerClassName: indexOfSet > 0 && indexOfControl === 0 ? "has-left-divider" : void 0,
...control
}, [indexOfSet, indexOfControl].join()))), children]
});
}
export { ToolbarGroup as default };
//# sourceMappingURL=index.mjs.map