--- title: "Data Table" slug: data-table category: component type: examples version: 20.0.0 tokens: 3916 source: https://ovh.github.io/design-system/v20.0.0/llms/react-components-data-table--examples.txt --- # Data Table ## Default ```tsx { type Person = { firstName: string; lastName: string; age: number; email: string; role: string; uuid: string; } const sampleData: Person[] = useMemo(() => [ { firstName: 'John', lastName: 'Doe', age: 30, email: 'john.doe@example.com', role: 'Admin', uuid: '5ae49b94-9ceb-4612-a087-4079a812bb0b', }, { firstName: 'Jane', lastName: 'Smith', age: 25, email: 'jane.smith@example.com', role: 'User', uuid: 'fb1c391c-bd88-4b96-ba39-8ab2a95d50bd', }, { firstName: 'Bob', lastName: 'Johnson', age: 35, email: 'bob.johnson@example.com', role: 'Manager', uuid: 'a83a58a6-a007-47f0-b04b-83989e502171', }, ], []); const sampleColumns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName' }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'age', header: 'Age', accessorKey: 'age' }, { id: 'email', header: 'Email', accessorKey: 'email' }, { id: 'role', header: 'Role', accessorKey: 'role' }, ], []); return ( ); } ``` ## Empty ```tsx { type Person = { firstName: string; lastName: string; age: number; email: string; role: string; uuid: string; } const sampleData: Person[] = useMemo(() => [], []); const sampleColumns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName' }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'age', header: 'Age', accessorKey: 'age' }, { id: 'email', header: 'Email', accessorKey: 'email' }, { id: 'role', header: 'Role', accessorKey: 'role' }, ], []); return ( Empty table data ); } ``` ## Pagination Example ```tsx { type Person = { firstName: string; lastName: string; age: number; email: string; role: string; } const PAGE_LIMIT = PAGINATION_PER_PAGE.option_10; const sampleColumns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName' }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'age', header: 'Age', accessorKey: 'age' }, { id: 'email', header: 'Email', accessorKey: 'email' }, { id: 'role', header: 'Role', accessorKey: 'role' }, ], []); const [data, setData] = useState(Array(PAGE_LIMIT).fill({})); const [page, setPage] = useState(0); const [total, setTotal] = useState(0); const fetchData = useCallback(async (page: number) => { return fetch(`https://dummyjson.com/users?limit=${PAGE_LIMIT}&skip=${PAGE_LIMIT * (page - 1)}&select=firstName,lastName,age,email,role`) .then((res) => res.json()) .then(({ total, users }) => ({ total, users, })); }, []); useEffect(() => { fetchData(page).then(({ total, users }) => { setData(users); setTotal(total); }); }, [page]); return (
Paginated Table setPage(page) } page={ page } pageSize={ PAGE_LIMIT } totalItems={ total }>
); } ``` ## Pinned Columns ```tsx { type Person = { firstName: string; lastName: string; age: number; email: string; role: string; uuid: string; } const sampleData: Person[] = useMemo(() => [ { firstName: 'John', lastName: 'Doe', age: 30, email: 'john.doe@example.com', role: 'Admin', uuid: '5ae49b94-9ceb-4612-a087-4079a812bb0b', }, { firstName: 'Jane', lastName: 'Smith', age: 25, email: 'jane.smith@example.com', role: 'User', uuid: 'fb1c391c-bd88-4b96-ba39-8ab2a95d50bd', }, { firstName: 'Bob', lastName: 'Johnson', age: 35, email: 'bob.johnson@example.com', role: 'Manager', uuid: 'a83a58a6-a007-47f0-b04b-83989e502171', }, ], []); const sampleColumns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName' }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'age', header: 'Age', accessorKey: 'age' }, { id: 'email', header: 'Email', accessorKey: 'email' }, { id: 'role', header: 'Role', accessorKey: 'role' }, ], []); const pinningState = useMemo(() => ({ left: ['age'], right: ['email'], }), []); return ( Empty table data ); } ``` ## State Controlled ```tsx { type Person = { firstName: string; lastName: string; age: number; email: string; role: string; uuid: string; } const sampleData: Person[] = useMemo(() => [ { firstName: 'John', lastName: 'Doe', age: 30, email: 'john.doe@domain2.com', role: 'Admin', uuid: '5ae49b94-9ceb-4612-a087-4079a812bb0b', }, { firstName: 'Jane', lastName: 'Smith', age: 25, email: 'jane.smith@domain1.com', role: 'User', uuid: 'fb1c391c-bd88-4b96-ba39-8ab2a95d50bd', }, { firstName: 'Bob', lastName: 'Johnson', age: 35, email: 'bob.johnson@domain3.com', role: 'Manager', uuid: 'a83a58a6-a007-47f0-b04b-83989e502171', }, ], []); const sampleColumns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName' }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'age', header: 'Age', accessorKey: 'age' }, { id: 'email', header: 'Email', accessorKey: 'email' }, { id: 'role', header: 'Role', accessorKey: 'role' }, ], []); const [sortingState, setSortingState] = useState([{ id: 'role', desc: true, }]); return ( Controlled sorted table ); } ``` ## Sorting Custom Function ```tsx { type Person = { firstName: string; lastName: string; age: number; email: string; role: string; uuid: string; } const sampleData: Person[] = useMemo(() => [ { firstName: 'John', lastName: 'Doe', age: 30, email: 'john.doe@domain2.com', role: 'Admin', uuid: '5ae49b94-9ceb-4612-a087-4079a812bb0b', }, { firstName: 'Jane', lastName: 'Smith', age: 25, email: 'jane.smith@domain1.com', role: 'User', uuid: 'fb1c391c-bd88-4b96-ba39-8ab2a95d50bd', }, { firstName: 'Bob', lastName: 'Johnson', age: 35, email: 'bob.johnson@domain3.com', role: 'Manager', uuid: 'a83a58a6-a007-47f0-b04b-83989e502171', }, ], []); const sampleColumns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName' }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'age', header: 'Age', accessorKey: 'age' }, { id: 'email', header: 'Email', accessorKey: 'email', sortingFn: (rowA, rowB, columnId) => { const valueA = rowA.getValue(columnId).split('@')[1].split('.')[0]; const valueB = rowB.getValue(columnId).split('@')[1].split('.')[0]; return valueA.localeCompare(valueB); }, }, { id: 'role', header: 'Role', accessorKey: 'role' }, ], []); return ( Email sorted by domain ); } ``` ## Sorting Disabled Columns ```tsx { type Person = { firstName: string; lastName: string; age: number; email: string; role: string; uuid: string; } const sampleData: Person[] = useMemo(() => [ { firstName: 'John', lastName: 'Doe', age: 30, email: 'john.doe@domain2.com', role: 'Admin', uuid: '5ae49b94-9ceb-4612-a087-4079a812bb0b', }, { firstName: 'Jane', lastName: 'Smith', age: 25, email: 'jane.smith@domain1.com', role: 'User', uuid: 'fb1c391c-bd88-4b96-ba39-8ab2a95d50bd', }, { firstName: 'Bob', lastName: 'Johnson', age: 35, email: 'bob.johnson@domain3.com', role: 'Manager', uuid: 'a83a58a6-a007-47f0-b04b-83989e502171', }, ], []); const sampleColumns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName', enableSorting: false }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'age', header: 'Age', accessorKey: 'age' }, { id: 'email', header: 'Email', accessorKey: 'email' }, { id: 'role', header: 'Role', accessorKey: 'role', enableSorting: false }, ], []); return ( Sort disabled on some columns ); } ``` ## Sorting Controlled ```tsx { type Person = { firstName: string; lastName: string; age: number; email: string; role: string; uuid: string; } const sampleData: Person[] = useMemo(() => [ { firstName: 'John', lastName: 'Doe', age: 30, email: 'john.doe@domain2.com', role: 'Admin', uuid: '5ae49b94-9ceb-4612-a087-4079a812bb0b', }, { firstName: 'Jane', lastName: 'Smith', age: 25, email: 'jane.smith@domain1.com', role: 'User', uuid: 'fb1c391c-bd88-4b96-ba39-8ab2a95d50bd', }, { firstName: 'Bob', lastName: 'Johnson', age: 35, email: 'bob.johnson@domain3.com', role: 'Manager', uuid: 'a83a58a6-a007-47f0-b04b-83989e502171', }, ], []); const sampleColumns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName' }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'age', header: 'Age', accessorKey: 'age' }, { id: 'email', header: 'Email', accessorKey: 'email' }, { id: 'role', header: 'Role', accessorKey: 'role' }, ], []); const [sortingState, setSortingState] = useState([{ id: 'role', desc: true, }, { id: 'lastName', desc: true, }]); return ( Controlled sorting ); } ``` ## Visibility Example ```tsx { type Person = { firstName: string; lastName: string; age: number; email: string; role: string; uuid: string; } const sampleData: Person[] = useMemo(() => [ { firstName: 'John', lastName: 'Doe', age: 30, email: 'john.doe@domain2.com', role: 'Admin', uuid: '5ae49b94-9ceb-4612-a087-4079a812bb0b', }, { firstName: 'Jane', lastName: 'Smith', age: 25, email: 'jane.smith@domain1.com', role: 'User', uuid: 'fb1c391c-bd88-4b96-ba39-8ab2a95d50bd', }, { firstName: 'Bob', lastName: 'Johnson', age: 35, email: 'bob.johnson@domain3.com', role: 'Manager', uuid: 'a83a58a6-a007-47f0-b04b-83989e502171', }, ], []); const sampleColumns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName' }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'age', header: 'Age', accessorKey: 'age' }, { id: 'email', header: 'Email', accessorKey: 'email' }, { id: 'role', header: 'Role', accessorKey: 'role' }, ], []); const visibileColumn= useMemo(() => ({ age: false }), []); return ( Age column hidden ); } ``` ## Accessibility I18n ```tsx { type Member = { firstName: string; lastName: string; role: string; } const data: Member[] = useMemo(() => [ { firstName: 'John', lastName: 'Doe', role: 'Admin' }, { firstName: 'Jane', lastName: 'Smith', role: 'User' }, { firstName: 'Bob', lastName: 'Johnson', role: 'Manager' }, ], []); const columns: DataTableColumnDef[] = useMemo(() => [ { id: 'firstName', header: 'First Name', accessorKey: 'firstName' }, { id: 'lastName', header: 'Last Name', accessorKey: 'lastName' }, { id: 'role', header: 'Role', accessorKey: 'role' }, ], []); return ( ); } ```