跳到主要内容

Table View

The Table view displays your items in a spreadsheet-like format with rows and columns. It is well-suited for managing large numbers of items, performing bulk edits, and working with many fields at once.

Layout​

  • Each row represents an item.
  • Each column represents a field (title, status, assignee, due date, custom fields, etc.).
  • Rows are organized into collapsible groups (similar to grouped rows in a spreadsheet), with each group header showing a colored bar, the group name, and an item count badge.
  • The first column (item name) is frozen and stays visible while you scroll horizontally through additional columns.

Column Headers​

Each column header displays:

  • A type icon representing the field type (e.g., Type icon for text, Hash for numbers, Calendar for dates, User for person fields, Tag for select fields, Star for ratings, CheckSquare for checkboxes).
  • The column name in text.
  • A sort indicator (up or down chevron) when the column has an active sort rule.

Inline Editing​

Click any cell to edit its value directly. The cell switches from a CellRenderer (display mode) to a CellEditor (edit mode):

  • Text fields — click and type. Save on blur or Enter. Cancel with Escape.
  • Select fields — click to open the dropdown. Selection saves immediately.
  • Date fields — click to open the date picker. Selection saves immediately.
  • Person fields — click to open the member selector.
  • Number fields — click and type a number.
  • Checkbox fields — click to toggle (saves immediately without entering edit mode).
  • Rating fields — click a star to set the rating.

Press Tab to move to the next cell, or Enter to confirm and move down.

Immediate-edit types

Some field types (checkbox, select, status, priority, rating) switch to edit mode on the first click without requiring a double-click. This makes common operations faster.

Column Management​

  • Add a column — click the + icon at the end of the column headers to open the Add Column dialog. Choose a field type, enter a name, and configure options.
  • Reorder columns — drag column headers left or right.
  • Resize columns — drag the right edge of a column header. Each column has a configurable default width.
  • Hide columns — right-click a column header and select Hide Column.
  • Freeze columns — right-click a column header and select Freeze to keep it visible while scrolling horizontally.

Sorting​

Click any column header to sort by that column. Click again to toggle between ascending and descending order. For multi-column sorting:

  1. Click the Sort button in the top bar.
  2. Add multiple sort rules with priority ordering.
  3. The primary sort is applied first, then secondary sorts break ties.
Manual reorder disabled with active sort

When a sort rule is active, manual row reordering via drag-and-drop is disabled. Remove the sort to re-enable manual ordering.

Grouping​

By default, items are grouped by their status field. To change the grouping:

  1. Click Group By in the top bar.
  2. Select the field you want to group by, or choose None to display a flat list.

Groups can be collapsed by clicking the chevron icon on the group header row.

Adding Items​

At the bottom of each group section, a + New Item row allows you to add items directly in context:

  1. Click the + New Item row.
  2. Type the title in the first cell.
  3. Press Tab to move through fields and fill in values inline.

Selecting Multiple Items​

  • Click the checkbox on the left side of any row to select it.
  • Hold Shift and click to select a range.
  • Use Cmd+A / Ctrl+A to select all visible items.

Once items are selected, the bulk action bar appears at the bottom. See Bulk Operations for more details.

Filtering​

The table view supports the same filter panel as the board view. Click Filter in the top bar to apply conditions. Filtered rows are hidden from the table but not deleted — remove the filter to see all items again.

Troubleshooting​

ProblemSolution
Columns not visibleScroll horizontally or check if columns have been hidden. Use the Column Manager to restore hidden columns.
Cannot edit a cellVerify you have Member or Admin permissions. Viewers have read-only access.
Sort not working as expectedCheck for multiple sort rules. The primary rule takes precedence.

Data Source​

The table view uses the same boards.getByProjectId tRPC query as the Board, Calendar, and Timeline views. The flat API response is transformed into a nested BoardData structure with groups, columns, and items. This ensures changes made in any view are immediately visible when you switch to another.

Item Detail Panel​

Clicking an item name (or the row expand icon) opens the Item Detail Panel as a slide-out sheet on the right. You can edit all fields, add comments, view activity, and manage attachments without leaving the table context.

Row Count and Summary​

At the bottom of each group section, the table displays the group's item count. The total number of visible items (after filtering) is shown in the toolbar, helping you understand the scope of the current view.

Empty and Error States​

  • No items — when the board has no items, a centered empty state is displayed with a Table icon and the message "No items yet. Add your first item to get started."
  • Loading — a skeleton loader mimics the table layout with placeholder rows while data is being fetched from the server.
  • Error — an error state with a Retry button appears if the board data fails to load.

Best Practices​

  • Use frozen columns for large tables. Freeze the item name column so you always know which item you are editing as you scroll horizontally.
  • Hide unused columns to reduce visual noise. You can always show them again later.
  • Combine filters and grouping for focused views. For example, group by Priority and filter to "Assigned to me" to see your high-priority tasks first.
  • Use Tab for rapid data entry — when adding items, press Tab to move through cells and Enter to move to the next row for efficient batch input.

Next Steps​