row-pinning
Pin stable row IDs into top, center, and bottom collections with rowPinningFeature and keepPinnedRows. Load for filtering/pagination visibility, explicit region rendering, or renderer-owned sticky CSS.
How do I install this agent skill?
npx skills add https://github.com/tanstack/table --skill row-pinningIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides architectural guidance and implementation patterns for row pinning using the TanStack Table library. It contains legitimate technical documentation, setup examples, and common development pitfalls related to UI state management and table rendering. No security risks were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
This skill builds on core and table-features. Pinning creates row regions; the renderer controls order and sticky layout.
Setup
import { rowPinningFeature, tableFeatures } from '@tanstack/table-core'
type Person = { id: string; name: string }
export const features = tableFeatures({ rowPinningFeature })
export const options = {
getRowId: (row: Person) => row.id,
keepPinnedRows: true,
}
Core Patterns
const regions = [
table.getTopRows(),
table.getCenterRows(),
table.getBottomRows(),
]
for (const rows of regions) rows.forEach(renderRow)
Render each region explicitly if the visual order matters.
Common Mistakes
[HIGH] Persisting index-based IDs
Wrong: const options = { getRowId: (_row: Person, index: number) => String(index) }
Correct: const options = { getRowId: (row: Person) => row.id }
Indexes change under sorting, filtering, pagination, and insertion.
Source: docs/framework/react/guide/row-pinning.md
[HIGH] Expecting sticky rows automatically
Wrong: row.pin('top')
Correct: topRowElement.style.position = 'sticky'
Pinning state does not style or place DOM elements.
Source: examples/react/row-pinning/src/main.tsx
Choose the pinned-row visibility policy
keepPinnedRows: trueis the default. Pinned rows stay visible in their pinned region even when filtering or pagination removes them from the center row model.keepPinnedRows: falselimits pinned rows to those present in the current filtered and paginated row model.
Choose explicitly based on product behavior; neither value is inherently wrong.
Source: packages/table-core/src/features/row-pinning/rowPinningFeature.types.ts
API Discovery
Inspect node_modules/@tanstack/table-core/dist/features/row-pinning/ for region getters, row APIs, and keepPinnedRows semantics.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tanstack/table/row-pinning">View row-pinning on skillZs</a>