Table Page

A page with a table is a common pattern in Grafana. This template shows how to use the Table component to display data in a table, combined with the filtering and sorting functionality.

Users

Manage users in Grafana

All users

Active last 30 days

New user

				Belongs to
john_doe	john_doe@example.com	John Doe	1/25/2024	Gamma Limited
alice_smith	alice_smith@example.com	Alice Smith	4/21/2024	Main Org.
bob_jones	bob_jones@example.com	Bob Jones	1/19/2024	Alpha
emma_watson	emma_watson@example.com	Emma Watson	2/3/2024	Beta Corporation
michael_jackson	michael_jackson@example.com	Michael Jackson	3/10/2024	Delta Group
lisa_simpson	lisa_simpson@example.com	Lisa Simpson	4/22/2024	Gamma Limited
peter_parker	peter_parker@example.com	Peter Parker	4/12/2024	Beta Corporation
tony_stark	tony_stark@example.com	Tony Stark	3/7/2024	Alpha
olivia_smith	olivia_smith@example.com	Olivia Smith	1/1/2024	Main Org.
charlie_brown	charlie_brown@example.com	Charlie Brown	4/17/2024	Gamma Limited

Source code

import React from 'react';
import { Stack, FilterInput, InteractiveTable, LinkButton, RadioButtonGroup } from '@grafana/ui';
import useColumns from '@site/src/components/templates/TablePage/useColumns';
import { Filter, User } from '@site/src/components/templates/TablePage/types';

interface TablePageProps {
  query: string;
  filter: Filter;
  data: User[];
  changeQuery: (query: string) => void;
  changeFilter: (value: string) => void;
}

export const TablePage = ({ changeQuery, query, changeFilter, filter, data }: TablePageProps) => {
  const columns = useColumns();

  return (
    <Stack grow={1} direction={'column'} gap={2}>
      <Stack gap={2}>
        <FilterInput
          placeholder="Search by login, email, or name"
          autoFocus={true}
          value={query}
          onChange={changeQuery}
        />
        <RadioButtonGroup
          options={[
            { label: 'All users', value: 'all' },
            { label: 'Active last 30 days', value: 'lastActive' },
          ]}
          onChange={(value) => changeFilter(value)}
          value={filter}
        />
        <LinkButton href="#" variant="primary">
          New user
        </LinkButton>
      </Stack>
      <InteractiveTable columns={columns} data={data} pageSize={10} getRowId={(user: User) => String(user.id)} />
    </Stack>
  );
};

export default TablePage;

Usage

• The page actions should be located at the top of the page, above the table.
• If filters are present, the primary action should be located after the filters, on the right side of the page.

Visual guidelines

• Lists of objects

Figma designs

• Table with filters