Rename useIsFormValid to useFormValidity

WordPress · oandregal · Oct 16, 2025 · Aug 29, 2025 · Oct 15, 2025 · Oct 15, 2025
commit 16676bb0f3af2f6d20ebf31bf5018d3eb49ffae6
@@ -716,7 +716,7 @@ Returns an object containing:
     -   `totalItems`: total number of items for the current view config.
     -   `totalPages`: total number of pages for the current view config.
 
-### `useIsFormValid`
+### `useFormValidity`
 
 Hook to determine if a form is valid.
 

@@ -1,4 +1,4 @@
 /**
  * Internal dependencies
  */
-export { default as useIsFormValid } from './use-is-form-valid';
+export { default as useFormValidity } from './use-form-validity';
diff --git a/.../src/hooks/test/use-is-form-valid.test.ts → ...views/src/hooks/test/use-form-validity.ts b/.../src/hooks/test/use-is-form-valid.test.ts → ...views/src/hooks/test/use-form-validity.ts
@@ -6,10 +6,10 @@ import { renderHook } from '@testing-library/react';
 /**
  * Internal dependencies
  */
-import { useIsFormValid } from '../';
+import { useFormValidity } from '..';
 import type { Field } from '../../types';
 
-describe( 'useIsFormValid', () => {
+describe( 'useFormValidity', () => {
 	it( 'operates on form fields and ignores the rest', () => {
 		const item = { id: 1, valid_order: 2, invalid_order: 'd' };
 		const fields: Field< {} >[] = [
@@ -24,7 +24,7 @@ describe( 'useIsFormValid', () => {
 		];
 		const form = { fields: [ 'valid_order' ] };
 		const { result } = renderHook( () =>
-			useIsFormValid( item, fields, form )
+			useFormValidity( item, fields, form )
 		);
 		expect( result.current ).toEqual( undefined );
 	} );
@@ -47,7 +47,7 @@ describe( 'useIsFormValid', () => {
 		];
 		const form = { fields: [ 'order' ] };
 		const { result } = renderHook( () =>
-			useIsFormValid( item, fields, form )
+			useFormValidity( item, fields, form )
 		);
 		expect( result.current ).toEqual( undefined );
 	} );
@@ -69,7 +69,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'tags' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.tags ).toEqual( REQUIRED_MESSAGE );
 		} );
@@ -87,7 +87,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'tags' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.tags ).toEqual( REQUIRED_MESSAGE );
 		} );
@@ -105,7 +105,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'tags' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current ).toEqual( undefined );
 		} );
@@ -131,7 +131,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'author' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.author ).toEqual( ELEMENTS_MESSAGE );
 		} );
@@ -153,7 +153,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'status' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current ).toEqual( undefined );
 		} );
@@ -175,7 +175,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'status' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.status ).toEqual( ELEMENTS_MESSAGE );
 		} );
@@ -198,7 +198,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'priority' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current ).toEqual( undefined );
 		} );
@@ -221,7 +221,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'priority' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.priority ).toEqual( ELEMENTS_MESSAGE );
 		} );
@@ -240,7 +240,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'price' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.price ).toEqual( ELEMENTS_MESSAGE );
 		} );
@@ -260,7 +260,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'tags' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current ).toEqual( undefined );
 		} );
@@ -280,7 +280,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'tags' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.tags ).toEqual( ELEMENTS_MESSAGE );
 		} );
@@ -302,7 +302,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'tags' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.tags ).toEqual( ELEMENTS_MESSAGE );
 		} );
@@ -319,7 +319,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'order' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current ).toEqual( undefined );
 		} );
@@ -334,7 +334,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'order' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.order ).toEqual( {
 				custom: {
@@ -354,7 +354,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'price' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current ).toEqual( undefined );
 		} );
@@ -369,7 +369,7 @@ describe( 'useIsFormValid', () => {
 			];
 			const form = { fields: [ 'price' ] };
 			const { result } = renderHook( () =>
-				useIsFormValid( item, fields, form )
+				useFormValidity( item, fields, form )
 			);
 			expect( result.current?.price ).toEqual( {
 				custom: {

@@ -54,7 +54,7 @@ function isInvalidForRequired( fieldType: string | undefined, value: any ) {
  *
  * @return Record of field IDs to error messages (undefined means no error).
  */
-export function useIsFormValid< Item >(
+export function useFormValidity< Item >(
 	item: Item,
 	fields: Field< Item >[],
 	form: Form
@@ -290,4 +290,4 @@ export function useIsFormValid< Item >(
 	return formValidity;
 }
 
-export default useIsFormValid;
+export default useFormValidity;
@@ -2,6 +2,6 @@ export { default as DataViews } from './components/dataviews';
 export { default as DataViewsPicker } from './components/dataviews-picker';
 export { default as DataForm } from './components/dataform';
 export { default as filterSortAndPaginate } from './utils/filter-sort-and-paginate';
-export { useIsFormValid } from './hooks';
+export { useFormValidity } from './hooks';
 export { VIEW_LAYOUTS } from './dataviews-layouts';
 export type * from './types';
@@ -17,7 +17,7 @@ import {
  * Internal dependencies
  */
 import DataForm from '../components/dataform';
-import useIsFormValid from '../hooks/use-is-form-valid';
+import useFormValidity from '../hooks/use-form-validity';
 
 import type {
 	Field,
@@ -1012,7 +1012,7 @@ const ValidationComponent = ( {
 		],
 	};
 
-	const validity = useIsFormValid( post, _fields, form );
+	const validity = useFormValidity( post, _fields, form );
 
 	return (
 		<form>

diff --git a/packages/fields/src/actions/reorder-page.tsx b/packages/fields/src/actions/reorder-page.tsx
@@ -6,7 +6,7 @@ import { store as coreStore } from '@wordpress/core-data';
 import { __ } from '@wordpress/i18n';
 import { store as noticesStore } from '@wordpress/notices';
 import { useState } from '@wordpress/element';
-import { DataForm, useIsFormValid } from '@wordpress/dataviews';
+import { DataForm, useFormValidity } from '@wordpress/dataviews';
 import {
 	Button,
 	__experimentalHStack as HStack,
@@ -37,7 +37,7 @@ function ReorderModal( {
 	const { createSuccessNotice, createErrorNotice } =
 		useDispatch( noticesStore );
 
-	const validity = useIsFormValid( item, fields, formOrderAction );
+	const validity = useFormValidity( item, fields, formOrderAction );
 
 	async function onOrder( event: React.FormEvent ) {
 		event.preventDefault();