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

references/url-state.md

View on GitHub
# Table URL State

Table state is persisted in query params.

Current URL keys used by the table runtime are:

- layout: `l`
- pagination page index: `p.page`
- pagination page size: `p.size`
- sorting key: `s.key`
- sorting direction: `s.dir`
- full-text search: `f.search`
- UI filters:
  `f.ui.{filterKey}`
  or `f.ui.{filterKey}~{operator}`

## Current URL Shape

Example:

```txt
?l=grid&p.page=2&p.size=24&s.key=hiredAt&s.dir=desc&f.search=emma
```

This means:

- grid layout
- page 2
- page size 24
- sorted by `hiredAt`
- descending order
- search query `emma`

## Filter Serialization

UI filters use the `f.ui.*` namespace.

Schema defaults from `filter.behavior.defaultValue` remain effective without counting as active or
producing query params. For example, a status filter whose default is `['published']` keeps the base
list URL clean:

```txt
/templates
```

Choosing Archived replaces that one default and produces:

```txt
/templates?f.ui.status=archived
```

Other filter defaults remain effective, and clearing the override returns to the clean default URL.

If the active operator is the filter's default operator, the operator is omitted from the key:

```txt
?f.ui.department=Engineering
```

If the active operator is not the default operator, it is appended with `~{operator}`:

```txt
?f.ui.salary~gte=100000
```

Examples:

```txt
?f.ui.isActive=true
?f.ui.salary~between=90000,120000
?f.ui.hiredAt~after=2024-01-01T00:00:00.000Z
?f.ui.skills=TypeScript,Go
```

## What Users Should Expect

- table interactions update the URL automatically
- reloading the page preserves the same table state
- sharing the page preserves the same table state
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