Docs
Views

List

Scan records as compact lines with a title and a few properties.

The list shows one line per record: the selection checkbox, a title, the properties you choose and the row actions. It uses the same records, query, selection and actions as the table, and opening a line behaves like clicking a table row.

Try the list

Choose React or Vue: each tab runs its framework. Each line shows the project name, then its status, category, budget and start date. Open View settings › Card settings to change the title and properties, show labels or wrap titles, or switch Display mode to Table to compare. Below 768px, mobileMaxProperties keeps two properties. The preview uses the store-opening projects shared by every view guide; see the example setup for project-config.ts and the in-memory host.

Expand ↗

Sample data. Changes stay in this preview.

Expand ↗

Sample data. Changes stay in this preview.

Configuration

Add "list" to displayModes and describe the line with table.list. The configuration is identical in React and Vue.

list-config.ts
export const listConfig = defineTableConfig({
  ...productConfig,
  table: {
    ...productConfig.table,
    displayModes: ["table", "list", "kanban"],
    list: {
      titleColumn: "name",
      cardColumnIds: ["status", "price"],
      showCardLabels: false,
    },
  },
});
OptionDefaultDescription
titleColumnFirst data columnColumn shown as the line title.
cardColumnIdsEvery other data columnProperties shown after the title, in this order.
showCardLabelsfalseShow each property's column name before its value.
wrapfalseLet the title wrap onto several lines instead of truncating it.
showActionstrueShow the row actions menu at the end of each line.
propertyAlign"end""start" places the properties right after the title.
maxPropertiesAllProperties shown at most.
mobileMaxPropertiesAllProperties shown at most below 768px; the lower limit wins.

Line settings

Open View → Card settings to choose the title and the visible properties, show labels, wrap titles, place properties, limit them (also separately on mobile), or hide row actions. Choices are saved with views and in the <tableId>-list URL key; Reset returns to table.list.

Grouping

The list follows the table's first grouping level. Each section is headed "Column: value" with its number of records, records without a value appear under "No value", and the grouped column is left out of the properties. Like Gallery and Kanban, the list shows the current page.

Reorder lines

When the view is sorted by Manual order (see sorting), drag a line by its ⋮⋮ handle with the mouse, a finger or a pen, or focus it and press Alt+↑ / Alt+↓. Lines move within their group. The new position shows at once and is saved through actions.reorder; if saving fails, the error is shown and the server order comes back.

Density

The list follows the table density (View → Density, XS to 2XL): lines use the same heights and padding as table rows, and the choice is saved with the view.