@wordpress/block-editor/src/hooks/use-content-only-section-edit.js

Generic block editor.

/**
 * WordPress dependencies
 */
import { useDispatch, useSelect } from '@wordpress/data';

/**
 * Internal dependencies
 */
import { store as blockEditorStore } from '../store';
import { unlock } from '../lock-unlock';

/**
 * Hook that provides section block editing state and actions.
 *
 * @param {string} clientId Block client ID.
 * @return {Object} Object containing section block state and actions.
 */
export default function useContentOnlySectionEdit( clientId ) {
	const {
		isSectionBlock,
		isWithinSection,
		isWithinEditedSection,
		isEditingContentOnlySection,
		editedContentOnlySection,
	} = useSelect(
		( select ) => {
			const {
				isSectionBlock: _isSectionBlock,
				getParentSectionBlock,
				getEditedContentOnlySection,
				isWithinEditedContentOnlySection,
			} = unlock( select( blockEditorStore ) );

			const editedSection = getEditedContentOnlySection();

			return {
				isSectionBlock: _isSectionBlock( clientId ),
				isWithinSection:
					_isSectionBlock( clientId ) ||
					!! getParentSectionBlock( clientId ),
				isWithinEditedSection:
					isWithinEditedContentOnlySection( clientId ),
				isEditingContentOnlySection: editedSection === clientId,
				editedContentOnlySection: editedSection,
			};
		},
		[ clientId ]
	);

	const blockEditorActions = useDispatch( blockEditorStore );
	const { editContentOnlySection, stopEditingContentOnlySection } =
		unlock( blockEditorActions );

	return {
		isSectionBlock,
		isWithinSection,
		isWithinEditedSection,
		isEditingContentOnlySection,
		editedContentOnlySection,
		editContentOnlySection,
		stopEditingContentOnlySection,
	};
}