MRT logoMaterial React Table

Legacy V2 Docs
On This Page

    MRT Hooks


    MRT has been adopting more and more of a hooks based approach for its internal logic. Its API is becoming more standardized so that you can use the same hooks that the MRT components use internally to build your own custom headless table if you want to.

    useMaterialReactTable

    Source Code

    This is probably the only MRT hook you will need to use, unless you are writing a custom headless table.

    This is the main hook from Material React Table. It creates a TanStack Table instance with all of the features that MRT provides and that you enable, and uses the proper default table options.

    import { useMaterialReactTable } from 'material-react-table';
    const table = useMaterialReactTable({
    ...options,
    });

    This hook is the combination of 2 other internal MRT hooks: useMRT_TableOptions, and useMRT_TableInstance.

    useMRT_TableOptions

    Source Code

    This hook simply takes in your custom table options and merges them with the default table options. It also does some extra logic to make sure that some default table options are set correctly based on other enabled features. For example, if you enable row virtualization features, the sticky header will also be enabled by default, and the layoutMode will adjust accordingly.

    import { useMRT_TableOptions } from 'material-react-table';
    const transformedTableOptions = useMRT_TableOptions({
    ...options,
    });

    useMRT_TableInstance

    Source Code

    This is where most of the magic happens. This hook is responsible for creating the TanStack Table instance, and adding all of the MRT features to it. It needs table options to be passed in to it correctly, with good defaults, and it will return the table instance.

    import { useMRT_TableInstance } from 'material-react-table';
    const table = useMRT_TableInstance({
    ...transformedTableOptions, //usually from useMRT_TableOptions
    });

    This hook also uses the useMRT_Effects

    useMRT_Effects

    Source Code

    This hook is responsible for adding some extra useEffect hooks to the table instance. These hooks are needed by some MRT features on a table wide level.

    useMRT_Rows

    New in v2.2.0

    Source Code

    This hook is mostly a wrapper around table.getRowModel, but with a bit more custom logic for fuzzy ranking, row pinning, and more. It consumes a table instance and returns the rows that should be rendered in the main table body. This can be a useful hook if you are writing a custom headless table, but still want all of the extra MRT enhanced behavior for fuzzy ranking, row pinning, etc. Alternatively, you can just use table.getRowModel() for a more vanilla TanStack Table experience.

    import { useMaterialReactTable, useMRT_Rows } from 'material-react-table';
    const table = useMaterialReactTable({
    ...options,
    });
    const rows = useMRT_Rows(table);
    return rows.map((row) => {
    //render row
    });

    useMRT_ColumnVirtualizer

    New in v2.2.0

    Source Code

    This hook is a wrapper around the useVirtualizer hook from TanStack Virtual. It consumes a table instance and returns a Column Virtualizer instance that is optimized for MRT table columns, with considerations for other MRT features like column pinning, column resizing, column hiding, and more.

    import {
    useMaterialReactTable,
    useMRT_ColumnVirtualizer,
    } from 'material-react-table';
    const table = useMaterialReactTable({
    ...options,
    });
    const columnVirtualizer = useMRT_ColumnVirtualizer(table);

    You would only need to use this hook if you are writing a custom headless table and want the same default column virtualization behavior that MRT provides. If you are using the MRT components, this hook is already used internally by the MRT_Table component.

    useMRT_RowVirtualizer

    New in v2.2.0

    Source Code

    This hook is a wrapper around the useVirtualizer hook from TanStack Virtual. It consumes a table instance and returns a Row Virtualizer instance that is optimized for MRT table rows, with considerations for other MRT features like row pinning, row dragging, and more.

    import {
    useMaterialReactTable,
    useMRT_RowVirtualizer,
    } from 'material-react-table';
    const table = useMaterialReactTable({
    ...options,
    });
    const rowVirtualizer = useMRT_RowVirtualizer(table);

    You would only need to use this hook if you are writing a custom headless table and want the same default row virtualization behavior that MRT provides. If you are using the MRT components, this hook is already used internally by the MRT_Table component.