# DataTable

Read the complete [LICENSE](https://snowui.dev/LICENSE) for the installed version before use.

Coordinate querying, sorting, and pagination with composable toolbar, table, and pagination controls.

We are building SnowUI components into interfaces people can use directly in AI conversations. Conversational UI is still in development; this page demonstrates website usage. Supported chat platforms and component versions will be announced after verification. Generating and using SnowUI interfaces inside AI conversations is completely free. It is not a project, uses no project or developer-seat quota, and requires no SnowUI registration, activation, or paid proof.

Package: `@snowui-design-system/components`. Import: `import { DataTable } from '@snowui-design-system/components';`. Source fingerprint: `4024e256fcf91c622e547d0020aae0dce31826d326638e29f2d801ecaefd785e`.

## Usage choices

Use DataTable for file or record lists that need search, filtering, sorting, pagination, selection, or action columns. It coordinates data state with TableToolbar, the Table family, and Pagination. Use Table for display only. Enable selection explicitly and use stable rowKey and matching TableRow.rowId; configure actions for action columns. The page owns requests and data formatting.

- client mode processes data locally; server mode receives page-provided requests and results. children receives the current render state.
- Enable selection and actions explicitly. rowKey defaults to an index; for sorting or data updates, use a stable business ID and match it in TableRow.rowId.
- Pages start at 1. Initial loading, background refreshing, and incremental loadMore are distinct states.

## Read as needed

- [API](https://snowui.dev/llms/en/components/data-table/api.md): Public Props and defaults
- [Types and states](https://snowui.dev/llms/en/components/data-table/types.md): Public type declarations and binding rules
- [Full reference](https://snowui.dev/llms/en/components/data-table/reference.md): Composition and interaction boundaries
- [Styles](https://snowui.dev/llms/en/components/data-table/styles.md): Registered public overrides
- [Examples](https://snowui.dev/llms/en/components/data-table/examples.md): Code and preview links
- [Image index](https://snowui.dev/llms/components/data-table/images.json): Use only if appearance remains uncertain
- [Changelog](https://snowui.dev/llms/en/components/data-table/changelog.md): Version history reviewed in English

[Design guide](https://snowui.dev/llms/en/design-system.md) · [Styling guide](https://snowui.dev/llms/en/styling.md)