packages/block-editor/src/utils/native-undo.js - trunk - githubmirror/gutenberg

packages/block-editor/src/utils/native-undo.js

53 строки1 KB

Marco Ciampini

ESLint: Replace strict config with bulk suppressions (#81248)

07 авг 2026, 14:34

07 авг 2026, 14:347f43eaf

import { useRefEffect } from '@wordpress/compose';

/**
 * Elements whose content the browser's own undo acts on (a dialog input, an
 * HTML editing field, a search field), registered through `useNativeUndo`.
 * The editor history must not act on events originating within them.
 */
const nativeUndoNodes = new WeakSet();

/**
 * Returns a ref that marks an element (and its descendants) as relying on
 * the browser's own undo, so the editor history leaves the undo and redo
 * shortcuts alone within it.
 *
 * @return {Function} Ref callback.
 */
export function useNativeUndo() {
	return useRefEffect( ( node ) => {
		nativeUndoNodes.add( node );
		return () => {
			nativeUndoNodes.delete( node );
		};
	}, [] );
}

/**
 * Returns true when the event originates from an element registered through
 * `useNativeUndo`.
 *
 * Events coming from the editor canvas are re-dispatched on the iframe
 * element, so the real target is resolved through the frame's focused
 * element.
 *
 * @param {KeyboardEvent} event Keyboard event.
 *
 * @return {boolean} Whether the element relies on the browser's own undo.
 */
export function usesNativeUndo( event ) {
	let { target } = event;

	if ( target?.nodeName === 'IFRAME' ) {
		target = target.contentDocument?.activeElement;
	}

	while ( target ) {
		if ( nativeUndoNodes.has( target ) ) {
			return true;
		}
		target = target.parentElement;
	}

	return false;
}