tanstack-table

ドキュメント

最新のドキュメントには context7 を使用してください。ライブラリの実装について質問するには deepwiki を使用してください。

• GitHub リポジトリ：https://github.com/TanStack/table
• DeepWiki リポジトリ：TanStack/table
• Context7 ライブラリ ID：/tanstack/table

TanStack Table のパターン

このスキルでは、セルに動作を渡すための meta フィールドを使った TanStack Table ライブラリのパターンを扱います。

基本パターン：meta を使った列の外部定義

// 1. Extend TableMeta for type safety
declare module '@tanstack/react-table' {
	interface TableMeta<TData extends RowData> {
		onEdit?: (id: string) => void;
		onDelete?: (id: string) => void;
	}
}

// 2. Hoist column definitions outside component
const columnHelper = createColumnHelper<Job>();

const columns = [
	columnHelper.accessor('name', {
		header: 'Name',
		cell: info => info.getValue(),
	}),
	columnHelper.display({
		id: 'actions',
		cell: ({ row, table }) => (
			<Button onClick={() => table.options.meta?.onEdit?.(row.original.id)}>Edit</Button>
		),
	}),
];

// 3. Pass callbacks via meta
function DataTable({ data, onEdit, onDelete }: Props) {
	const table = useReactTable({
		data,
		columns,
		getCoreRowModel: getCoreRowModel(),
		meta: { onEdit, onDelete },
	});

	return <Table>...</Table>;
}

なぜクロージャーではなく meta を使うのか？

列定義でクロージャーを使うと、再レンダリングが発生します。

// Bad - new column array every render
const columns = useMemo(() => [
  {
    cell: ({ row }) => (
      <Button onClick={() => onEdit(row.original.id)}>Edit</Button>
    ),
  },
], [onEdit]); // Invalidates when onEdit changes

// Good - stable columns, dynamic meta
const columns = [...]; // Hoisted, never changes

const table = useReactTable({
  meta: { onEdit }, // Only meta changes
});

参考資料

• 列定義のパターンについては、column-definitions.md を参照してください。
• meta フィールドの型安全性については、meta-field.md を参照してください。