@wordpress/components
Version:
UI components for WordPress.
49 lines (48 loc) • 1.52 kB
JavaScript
import { useEffect, useRef } from "@wordpress/element";
import { useItem } from "./hook.mjs";
import { contextConnect } from "../../context/index.mjs";
import { View } from "../../view/index.mjs";
import { useItemGroupContext } from "../context.mjs";
import { jsx } from "react/jsx-runtime";
// packages/components/src/item-group/item/component.tsx
function UnconnectedItem(props, forwardedRef) {
const { role, wrapperClassName, ...otherProps } = useItem(props);
const itemRef = useRef(null);
const { isList } = useItemGroupContext();
useEffect(() => {
if (isList && role === "listitem" && !itemRef.current?.closest("ol, ul, menu, [role=\"list\"], [role=\"directory\"]")) throw new Error("Item with list semantics must be rendered inside an element with role=\"list\".");
}, [isList, role]);
return /* @__PURE__ */ jsx("div", {
ref: itemRef,
role,
className: wrapperClassName,
children: /* @__PURE__ */ jsx(View, {
...otherProps,
ref: forwardedRef
})
});
}
/**
* `Item` is used in combination with `ItemGroup` to display a list of items
* grouped and styled together.
*
* ```jsx
* import {
* __experimentalItemGroup as ItemGroup,
* __experimentalItem as Item,
* } from '@wordpress/components';
*
* function Example() {
* return (
* <ItemGroup>
* <Item>Code</Item>
* <Item>is</Item>
* <Item>Poetry</Item>
* </ItemGroup>
* );
* }
* ```
*/
const Item = contextConnect(UnconnectedItem, "Item");
export { Item, Item as default };
//# sourceMappingURL=component.mjs.map