useUnselectAll

This hook returns a function that unselects all lines in a data table (see <DataTableBase>).

Usage

import { useListContext, useUnselectAll } from 'ra-core';

const UnselectAllButton = () => {
    const { resource } = useListContext();
    const unselectAll = useUnselectAll(resource);

    const handleClick = () => {
        unselectAll();
    };

    return <button onClick={handleClick}>Unselect all</button>;
};

Parameters

useUnselectAll accepts two parameters. Both are optional:

• resource: The resource name. If not specified, the hook will only update the locally stored selection state (changes are not persisted in the Store).
• storeKey: The store key to use. If not specified, the hook will derive the store key from the resource. It should match the storeKey used by the parent controller (e.g. useListController or <ListBase>).

resource

Use resource to specify the resource name.

import { useListContext, useUnselectAll } from 'ra-core';

const UnselectAllButton = () => {
    const { resource } = useListContext();
    const unselectAll = useUnselectAll(resource);

    const handleClick = () => {
        unselectAll();
    };

    return <button onClick={handleClick}>Unselect all</button>;
};

If not specified, the hook will only update the locally stored selection state (changes are not persisted in the Store). This is notably useful when the parent list has the storeKey prop set to false.

import { useUnselectAll } from 'ra-core';

const UnselectAllButton = () => {
    // Call useUnselectAll without arguments - local selection only
    const unselectAll = useUnselectAll();

    const handleClick = () => {
        unselectAll();
    };

    return <button onClick={handleClick}>Unselect all</button>;
};

storeKey

The default store key is derived from the resource name: ${resource}.selectedIds.

You can customize the store key used by passing a storeKey parameter to the hook. Make sure it matches the storeKey used in the parent controller (e.g. useListController or <ListBase>).

The final store key used will be ${storeKey}.selectedIds.

import { useListContext, useUnselectAll } from 'ra-core';

const UnselectAllButton = () => {
    const { resource } = useListContext();
    const unselectAll = useUnselectAll(resource, 'customStoreKey');

    const handleClick = () => {
        unselectAll();
    };

    return <button onClick={handleClick}>Unselect all</button>;
};

Return value

useUnselectAll returns a function taking one optional parameter:

• fromAllStoreKeys: A boolean indicating whether to unselect the records across all storeKeys used with this resource. Defaults to false. Set this to true for instance when the records are deleted, to ensure they don’t remain selected in other lists.

import { useListContext, useUnselectAll } from 'ra-core';

const UnselectAllButton = () => {
    const { resource } = useListContext();
    const unselectAll = useUnselectAll(resource);

    const handleClick = () => {
        // Unselect across all store keys
        unselectAll(true);
    };

    return <button onClick={handleClick}>Unselect all</button>;
};