列指南

注意：本指南讨论的是表格实例中实际生成的列对象 (column objects)，而不是关于如何设置表格的列定义 (column definitions)。

这份快速指南将讨论如何检索和与 TanStack Table 中的列对象进行交互。

从何处获取列

你可以在许多地方找到列对象。它们通常是附带的。

表头和单元格对象 (Header and Cell Objects)

在你使用任何表格实例 API 之前，请考虑你是否真的需要检索表头 (headers) 或单元格 (cells)，而不是列 (columns)。如果你正在渲染表格的标记，你很可能希望使用返回表头或单元格的 API，而不是列。列对象本身并不是真正用来直接渲染表头或单元格的，但是表头和单元格对象将包含对这些列对象的引用，它们可以从中获取渲染 UI 所需的信息。

const column = cell.column; // 从单元格获取列
const column = header.column; // 从表头获取列

列表格实例 API (Column Table Instance APIs)

有数十个表格实例 API 可用于从表格实例中检索列。你将使用哪些 API 完全取决于你在表格中使用的功能和你的用例。

获取列 (Get Column)

如果你只需要通过其 ID 获取单个列，可以使用 table.getColumn API。

const column = table.getColumn('firstName');

最简单的列 API 是 table.getAllColumns，它将返回表格中所有列的列表。但除了此 API 之外，还有数十个受其他功能和表格状态影响的其他列 API。table.getAllFlatColumns、table.getAllLeafColumns、getCenterLeafColumns、table.getLeftVisibleLeafColumns 只是你可能结合列可见性或列固定功能使用的其他列 API 的一些示例。