Mantine React Table

A fork of Mantine React Table - v2

About

Quickly Create React Data Tables with Mantine

Built with Mantine V8 and TanStack Table V8

Features

All features can easily be enabled/disabled

• [x] < 44kb gzipped - Bundlephobia
• [x] Advanced TypeScript Generics Support (TypeScript Optional)
• [x] Aggregation and Grouping (Sum, Average, Count, etc.)
• [x] Click To Copy Cell Values
• [x] Column Action Dropdown Menu
• [x] Column Hiding
• [x] Column Ordering via Drag'n'Drop
• [x] Column Pinning (Freeze Columns)
• [x] Column Resizing
• [x] Customize Icons
• [x] Customize Styling of internal Mantine Components
• [x] Data Editing (4 different editing modes)
• [x] Density Toggle
• [x] Detail Panels (Expansion)
• [x] Filtering (supports client-side and server-side)
• [x] Filter Match Highlighting
• [x] Full Screen Mode
• [x] Global Filtering (Search across all columns, rank by best match)
• [x] Header Groups & Footers
• [x] Localization (i18n) support
• [x] Manage your own state or let the table manage it internally for you
• [x] Pagination (supports client-side and server-side)
• [x] Row Actions (Your Custom Action Buttons)
• [x] Row Numbers
• [x] Row Ordering via Drag'n'Drop
• [x] Row Selection (Checkboxes)
• [x] SSR compatible
• [x] Sorting (supports client-side and server-side)
• [x] Theming (Respects your Mantine Theme)
• [x] Toolbars (Add your own action buttons)
• [x] Tree Data / Expanding Sub-rows
• [x] Virtualization (@tanstack/react-virtual)

Getting Started

Installation

1. Ensure that you have React 18 or later installed

2. Install Peer Dependencies (Mantine V8 and Tabler Icons)

npm install @mantine/core @mantine/hooks @mantine/dates @emotion/react @tabler/icons-react dayjs

3. Install mantine-react-table

npm install mantine-react-table-v3

@tanstack/react-table, @tanstack/react-virtual, @tanstack/match-sorter-utils, are internal dependencies, so you do NOT need to install them yourself.

Usage

Read the full usage docs here

import { useMemo, useState, useEffect } from 'react';
import { MantineReactTable, useMantineReactTable } from 'mantine-react-table';

const data = [
  {
    name: 'John',
    age: 30,
  },
  {
    name: 'Sara',
    age: 25,
  },
]

export default function App() {
  const columns = useMemo(
    () => [
      {
        accessorKey: 'name', //simple recommended way to define a column
        header: 'Name',
        mantineTableHeadCellProps: { style: { color: 'green' } }, //optional custom props
        Cell: ({ cell }) => <span>{cell.getValue()}</span>, //optional custom cell render
      },
      {
        accessorFn: (row) => row.age, //alternate way
        id: 'age', //id required if you use accessorFn instead of accessorKey
        header: 'Age',
        Header: () => <i>Age</i>, //optional custom header render
      },
    ],
    [],
  );

  //optionally, you can manage any/all of the table state yourself
  const [rowSelection, setRowSelection] = useState({});

  useEffect(() => {
    //do something when the row selection changes
  }, [rowSelection]);

  const table = useMantineReactTable({
    columns,
    data,
    enableColumnOrdering: true, //enable some features
    enableRowSelection: true,
    enablePagination: false, //disable a default feature
    onRowSelectionChange: setRowSelection, //hoist row selection state to your state
    state: { rowSelection },
  });
  
  return <MantineReactTable table={table} />;
}

Contributors

PRs are Welcome, but please discuss in GitHub Discussions