@elementor/frontend-handlers 4.1.0-783 → 4.1.0-785

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 type Settings = Record<string, unknown>;
-type ChildRenderCallback = () => void;
+type ChildRenderCallback = (event: Event) => void;
 interface ListenToChildrenAPI {
     render: (callback: ChildRenderCallback) => void;
 }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 type Settings = Record<string, unknown>;
-type ChildRenderCallback = () => void;
+type ChildRenderCallback = (event: Event) => void;
 interface ListenToChildrenAPI {
     render: (callback: ChildRenderCallback) => void;
 }

package/dist/index.js

@@ -135,7 +135,7 @@ var onElementRender = ({
           if (!elementTypes.includes(childType)) {
             return;
           }
-          callback();
+          callback(event);
         };
         element.addEventListener(ELEMENT_RENDERED_EVENT_NAME, listener, { signal: controller.signal });
         element.addEventListener(ELEMENT_DESTROYED_EVENT_NAME, listener, { signal: controller.signal });

package/dist/index.mjs

@@ -105,7 +105,7 @@ var onElementRender = ({
           if (!elementTypes.includes(childType)) {
             return;
           }
-          callback();
+          callback(event);
         };
         element.addEventListener(ELEMENT_RENDERED_EVENT_NAME, listener, { signal: controller.signal });
         element.addEventListener(ELEMENT_DESTROYED_EVENT_NAME, listener, { signal: controller.signal });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elementor/frontend-handlers",
   "description": "Elementor Frontend Handlers",
-  "version": "4.1.0-783",
+  "version": "4.1.0-785",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",

package/src/__tests__/index.test.ts

@@ -623,6 +623,58 @@ describe( 'Frontend Handlers', () => {
 			// Assert
 			expect( childRenderCallback ).not.toHaveBeenCalled();
 		} );
+
+		it( 'should pass the event object to the render callback', () => {
+			// Arrange
+			const PARENT_ID = 'parent-1';
+			const CHILD_ID = 'child-1';
+			const childRenderCallback = jest.fn();
+
+			register( {
+				elementType: PARENT_ELEMENT_TYPE,
+				id: HANDLER_IDS.handler_1,
+				callback: ( { listenToChildren } ) => {
+					listenToChildren( [ CHILD_ELEMENT_TYPE ] ).render( childRenderCallback );
+					return undefined;
+				},
+			} );
+
+			const parent = document.createElement( 'div' );
+			parent.setAttribute( 'data-e-type', PARENT_ELEMENT_TYPE );
+			parent.setAttribute( 'data-id', PARENT_ID );
+			document.body.appendChild( parent );
+
+			const child = document.createElement( 'div' );
+			child.setAttribute( 'data-e-type', CHILD_ELEMENT_TYPE );
+			child.setAttribute( 'data-id', CHILD_ID );
+			parent.appendChild( child );
+
+			// Act
+			window.dispatchEvent(
+				new CustomEvent( 'elementor/element/render', {
+					detail: { id: PARENT_ID, type: PARENT_ELEMENT_TYPE, element: parent },
+				} )
+			);
+
+			window.dispatchEvent(
+				new CustomEvent( 'elementor/element/render', {
+					detail: { id: CHILD_ID, type: CHILD_ELEMENT_TYPE, element: child },
+				} )
+			);
+
+			// Assert
+			expect( childRenderCallback ).toHaveBeenCalledTimes( 1 );
+			expect( childRenderCallback ).toHaveBeenCalledWith(
+				expect.objectContaining( {
+					type: 'elementor/element/rendered',
+					detail: expect.objectContaining( {
+						element: child,
+						elementType: CHILD_ELEMENT_TYPE,
+						elementId: CHILD_ID,
+					} ),
+				} )
+			);
+		} );
 	} );
 
 	describe( 'Multiple Element Instances', () => {

package/src/handlers-registry.ts

@@ -1,6 +1,6 @@
 type Settings = Record< string, unknown >;
 
-type ChildRenderCallback = () => void;
+type ChildRenderCallback = ( event: Event ) => void;
 
 interface ListenToChildrenAPI {
 	render: ( callback: ChildRenderCallback ) => void;

package/src/lifecycle-events.ts

@@ -73,7 +73,7 @@ export const onElementRender = ( {
 		const settings = element.getAttribute( 'data-e-settings' );
 
 		const listenToChildren = ( elementTypes: string[] ) => ( {
-			render: ( callback: () => void ) => {
+			render: ( callback: ( event: Event ) => void ) => {
 				const listener = ( event: Event ) => {
 					const { elementType: childType } = ( event as CustomEvent ).detail;
 
@@ -81,7 +81,7 @@ export const onElementRender = ( {
 						return;
 					}
 
-					callback();
+					callback( event );
 				};
 
 				element.addEventListener( ELEMENT_RENDERED_EVENT_NAME, listener, { signal: controller.signal } );