@gechiui/block-editor
Version:
68 lines (64 loc) • 2.3 kB
JavaScript
/**
* GeChiUI dependencies
*/
import { useSelect } from '@gechiui/data';
import { store as blocksStore } from '@gechiui/blocks';
/**
* Internal dependencies
*/
import { store as blockEditorStore } from '../../store';
/** @typedef {import('@gechiui/blocks').GCIcon} GCIcon */
/**
* Contains basic block's information for display reasons.
*
* @typedef {Object} GCBlockDisplayInformation
*
* @property {string} title Human-readable block type label.
* @property {GCIcon} icon Block type icon.
* @property {string} description A detailed block type description.
*/
/**
* Hook used to try to find a matching block variation and return
* the appropriate information for display reasons. In order to
* to try to find a match we need to things:
* 1. Block's client id to extract it's current attributes.
* 2. A block variation should have set `isActive` prop to a proper function.
*
* If for any reason a block variaton match cannot be found,
* the returned information come from the Block Type.
* If no blockType is found with the provided clientId, returns null.
*
* @param {string} clientId Block's client id.
* @return {?GCBlockDisplayInformation} Block's display information, or `null` when the block or its type not found.
*/
export default function useBlockDisplayInformation(clientId) {
return useSelect(select => {
if (!clientId) return null;
const {
getBlockName,
getBlockAttributes
} = select(blockEditorStore);
const {
getBlockType,
getActiveBlockVariation
} = select(blocksStore);
const blockName = getBlockName(clientId);
const blockType = getBlockType(blockName);
if (!blockType) return null;
const attributes = getBlockAttributes(clientId);
const match = getActiveBlockVariation(blockName, attributes);
const blockTypeInfo = {
title: blockType.title,
icon: blockType.icon,
description: blockType.description,
anchor: attributes === null || attributes === void 0 ? void 0 : attributes.anchor
};
if (!match) return blockTypeInfo;
return {
title: match.title || blockType.title,
icon: match.icon || blockType.icon,
description: match.description || blockType.description
};
}, [clientId]);
}
//# sourceMappingURL=index.js.map