ra-core
Version:
Core components of react-admin, a frontend Framework for building admin applications on top of REST services, using ES6, React
80 lines • 3.92 kB
TypeScript
import { UseMutationOptions, UseMutationResult, MutateOptions } from '@tanstack/react-query';
import { RaRecord, DeleteManyParams, MutationMode } from '../types';
/**
* Get a callback to call the dataProvider.delete() method, the result and the loading state.
*
* @param {string} resource
* @param {Params} params The delete parameters { ids }
* @param {Object} options Options object to pass to the queryClient.
* May include side effects to be executed upon success or failure, e.g. { onSuccess: () => { refresh(); } }
* May include a mutation mode (optimistic/pessimistic/undoable), e.g. { mutationMode: 'undoable' }
*
* @typedef Params
* @prop params.ids The resource identifiers, e.g. [123, 456]
*
* @returns The current mutation state. Destructure as [deleteMany, { data, error, isPending }].
*
* The return value updates according to the request state:
*
* - initial: [deleteMany, { isPending: false, isIdle: true }]
* - start: [deleteMany, { isPending: true }]
* - success: [deleteMany, { data: [data from response], isPending: false, isSuccess: true }]
* - error: [deleteMany, { error: [error from response], isPending: false, isError: true }]
*
* The deleteMany() function must be called with a resource and a parameter object: deleteMany(resource, { ids, meta }, options)
*
* This hook uses react-query useMutation under the hood.
* This means the state object contains mutate, isIdle, reset and other react-query methods.
*
* @see https://tanstack.com/query/v5/docs/react/reference/useMutation
*
* @example // set params when calling the deleteMany callback
*
* import { useDeleteMany } from 'react-admin';
*
* const BulkDeletePostsButton = ({ selectedIds }) => {
* const [deleteMany, { isPending, error }] = useDeleteMany();
* const handleClick = () => {
* deleteMany('posts', { ids: selectedIds })
* }
* if (error) { return <p>ERROR</p>; }
* return <button disabled={isPending} onClick={handleClick}>Delete selected posts</button>;
* };
*
* @example // set params when calling the hook
*
* import { useDeleteMany } from 'react-admin';
*
* const BulkDeletePostsButton = ({ selectedIds }) => {
* const [deleteMany, { isPending, error }] = useDeleteMany('posts', { ids: selectedIds });
* const handleClick = () => {
* deleteMany()
* }
* if (error) { return <p>ERROR</p>; }
* return <button disabled={isPending} onClick={handleClick}>Delete selected posts</button>;
* };
*
* @example // TypeScript
* const [deleteMany, { data }] = useDeleteMany<Product>('products', { ids });
* \-- data is Product
*/
export declare const useDeleteMany: <RecordType extends RaRecord<import("../types").Identifier> = any, MutationError = unknown>(resource?: string, params?: Partial<DeleteManyParams<RecordType>>, options?: UseDeleteManyOptions<RecordType, MutationError>) => UseDeleteManyResult<RecordType, MutationError>;
export interface UseDeleteManyMutateParams<RecordType extends RaRecord = any> {
resource?: string;
ids?: RecordType['id'][];
meta?: any;
}
export type UseDeleteManyOptions<RecordType extends RaRecord = any, MutationError = unknown> = UseMutationOptions<RecordType['id'][], MutationError, Partial<UseDeleteManyMutateParams<RecordType>>> & {
mutationMode?: MutationMode;
};
export type UseDeleteManyResult<RecordType extends RaRecord = any, MutationError = unknown> = [
(resource?: string, params?: Partial<DeleteManyParams<RecordType>>, options?: MutateOptions<RecordType['id'][], MutationError, Partial<UseDeleteManyMutateParams<RecordType>>, unknown> & {
mutationMode?: MutationMode;
}) => Promise<void>,
UseMutationResult<RecordType['id'][], MutationError, Partial<DeleteManyParams<RecordType> & {
resource?: string;
}>, unknown> & {
isLoading: boolean;
}
];
//# sourceMappingURL=useDeleteMany.d.ts.map