Skip to content

ChronicStone/nuxt-ui-tools / skills/consumer/table

nuxt-ui-tools-table

Verified

Use this skill when building or debugging table usage with nuxt-ui-tools as a package consumer. Covers defineTableSchema, useTable, DataList, granular composition, columns, filters, sorting, offset or cursor loading, layouts, summary rows on phones, first-use empty states, actions, selection, accessible row names, context, and URL state with concrete examples.

FileKindSize
SKILL.mdskill md3.6 KB
references/actions.mdmarkdown7.7 KB
references/columns.mdmarkdown4.1 KB
references/context.mdmarkdown1.3 KB
references/data-modes.mdmarkdown2.9 KB
references/filters.mdmarkdown17.7 KB
references/getting-started.mdmarkdown1.4 KB
references/groups.mdmarkdown2.1 KB
references/layouts.mdmarkdown6.7 KB
references/overview.mdmarkdown1.2 KB
references/pagination.mdmarkdown2.5 KB
references/patterns.mdmarkdown989 B
references/schema-surface.mdmarkdown1.3 KB
references/selection.mdmarkdown3.3 KB
references/slots.mdmarkdown11.0 KB
references/sorting.mdmarkdown480 B
references/tree.mdmarkdown3.9 KB
references/url-state.mdmarkdown1.6 KB
---
name: nuxt-ui-tools-table
description: Use this skill when building or debugging table usage with nuxt-ui-tools as a package consumer. Covers defineTableSchema, useTable, DataList, granular composition, columns, filters, sorting, offset or cursor loading, layouts, summary rows on phones, first-use empty states, actions, selection, accessible row names, context, and URL state with concrete examples.
---

# nuxt-ui-tools Table

Use this skill for package-consumer tasks involving:

- `defineTableSchema(...)`
- `tableSource(...)`
- `useTable(...)`
- `DataList`
- `DataListRoot` and granular rendering parts
- table columns
- table filters
- client or remote table setup
- table query-state integration
- cursor infinite loading and no-pagination mode
- tree rows (`table.tree`) and the `expansion` API
- row groups (`table.groupBy`, `grid.groupBy`)
- summary rows (`table.summary`) and the view toggle for phones
- first-use empty states (`empty`) and record names for assistive technology (`rowLabel`)
- touch targets below the `md` breakpoint (`ui.mobile`)

## Read This Skill With

- `skills/consumer/package/SKILL.md`
- `skills/consumer/table/references/overview.md`

Then use the focused references:

- `skills/consumer/table/references/getting-started.md`
- `skills/consumer/table/references/data-modes.md`
- `skills/consumer/table/references/url-state.md`
- `skills/consumer/table/references/schema-surface.md`
- `skills/consumer/table/references/layouts.md`
- `skills/consumer/table/references/pagination.md`
- `skills/consumer/table/references/sorting.md`
- `skills/consumer/table/references/filters.md`
- `skills/consumer/table/references/columns.md`
- `skills/consumer/table/references/selection.md`
- `skills/consumer/table/references/tree.md`
- `skills/consumer/table/references/groups.md`
- `skills/consumer/table/references/context.md`
- `skills/consumer/table/references/actions.md`
- `skills/consumer/table/references/slots.md`
- `skills/consumer/table/references/patterns.md`

## I18n-Friendly Schema Text

Schema-owned table text should be written as translation-friendly lazy values when it comes from app i18n.

Use this pattern for:

- filter labels
- filter placeholders
- preset labels and descriptions
- column labels
- action labels
- static option labels

Example:

```ts
const { t } = useI18n()

const schema = defineTableSchema({
  tableKey: 'employees',
  rowKey: 'id',
  filters: {
    search: {
      fields: ['fullName', 'email'],
      placeholder: () => t('employees.search.placeholder'),
    },
    ui: (filter) => [
      filter.text('fullName', {
        label: () => t('employees.filters.name'),
        editor: {
          placeholder: () => t('employees.filters.searchName'),
        },
      }),
      filter.date('hiredAt', {
        label: () => t('employees.filters.hiredAt'),
        editor: {
          scalar: {
            presets: [
              {
                label: () => t('shared.datePresets.today'),
                value: ({ now }) => now,
              },
            ],
          },
        },
      }),
    ],
  },
  rowActions: ({ row }) => [
    {
      key: 'copy-email',
      label: () => t('employees.actions.copyEmail'),
    },
  ],
  table: {
    columns: (column) => [
      column.field('fullName', {
        label: () => t('employees.columns.fullName'),
      }),
    ],
  },
})
```

Prefer translation keys through `t(...)` over writing bilingual helpers or rebuilding the whole schema in a `computed(...)`.

If a surface only renders package-owned UI text and does not come from your schema, use the package locale/provider layer instead of duplicating those strings in your app schema.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall