/** * External dependencies */ import { Slot, Fill } from '@wordpress/components'; import { cloneElement } from '@wordpress/element'; /** * Ordered header item. * * @param {Node} children - Node children. * @param {number} order - Node order. * @param {Array} props - Fill props. * @return {Node} Node. */ const createOrderedChildren = ( children, order, props ) => { return typeof children === 'function' ? cloneElement( children( props ), { order } ) : cloneElement( children, { ...props, order } ); }; /** * Create a Fill for extensions to add items to the WooCommerce Admin header. * * @slotFill WooHeaderItem * @example * const MyHeaderItem = () => ( * My header item * ); * * registerPlugin( 'my-extension', { * render: MyHeaderItem, * scope: 'woocommerce-admin', * } ); * @param {Object} param0 * @param {Array} param0.children - Node children. * @param {Array} param0.order - Node order. */ export const WooHeaderItem = ( { children, order = 1 } ) => { return ( { ( fillProps ) => { return createOrderedChildren( children, order, fillProps ); } } ); }; WooHeaderItem.Slot = ( { fillProps } ) => ( { ( fills ) => { return fills.sort( ( a, b ) => { return a[ 0 ].props.order - b[ 0 ].props.order; } ); } } ); /** * Create a Fill for extensions to add items to the WooCommerce Admin * navigation area left of the page title. * * @slotFill WooHeaderNavigationItem * @example * const MyNavigationItem = () => ( * My nav item * ); * * registerPlugin( 'my-extension', { * render: MyNavigationItem, * scope: 'woocommerce-admin', * } ); * @param {Object} param0 * @param {Array} param0.children - Node children. * @param {Array} param0.order - Node order. */ export const WooHeaderNavigationItem = ( { children, order = 1 } ) => { return ( { ( fillProps ) => { return createOrderedChildren( children, order, fillProps ); } } ); }; WooHeaderNavigationItem.Slot = ( { fillProps } ) => ( { ( fills ) => { return fills.sort( ( a, b ) => { return a[ 0 ].props.order - b[ 0 ].props.order; } ); } } ); /** * Create a Fill for extensions to add custom page titles. * * @slotFill WooHeaderPageTitle * @example * const MyPageTitle = () => ( * My page title * ); * * registerPlugin( 'my-page-title', { * render: MyPageTitle, * scope: 'woocommerce-admin', * } ); * @param {Object} param0 * @param {Array} param0.children - Node children. */ export const WooHeaderPageTitle = ( { children } ) => { return { children }; }; WooHeaderPageTitle.Slot = ( { fillProps } ) => ( { ( fills ) => { const last = fills.pop(); return [ last ]; } } );