npm package: @humanspeak/svelte-headless-table
Description: A powerful, headless table library for Svelte that provides complete control over table UI while handling complex data operations like sorting, filtering, pagination, grouping, and row expansion. Build custom, accessible data tables with zero styling opin
Author: Humanspeak, Inc.
Latest version: 6.0.6

<!-- trunk-ignore-all(markdownlint/MD033) -->
<!-- trunk-ignore(markdownlint/MD041) -->
<div align="center">

<img src="https://user-images.githubusercontent.com/42545742/169733428-295e2678-e509-4175-aeb3-cb3a9c9894e1.svg" alt="svelte-headless-table" width="400" />

# Svelte Headless Table

</div>

[![NPM version](https://img.shields.io/npm/v/@humanspeak/svelte-headless-table.svg)](https://www.npmjs.com/package/@humanspeak/svelte-headless-table)
[![Build Status](https://github.com/humanspeak/svelte-headless-table/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/humanspeak/svelte-headless-table/actions/workflows/npm-publish.yml)
[![Coverage Status](https://coveralls.io/repos/github/humanspeak/svelte-headless-table/badge.svg?branch=main)](https://coveralls.io/github/humanspeak/svelte-headless-table?branch=main)
[![License](https://img.shields.io/npm/l/@humanspeak/svelte-headless-table.svg)](https://github.com/humanspeak/svelte-headless-table/blob/main/LICENSE)
[![Downloads](https://img.shields.io/npm/dm/@humanspeak/svelte-headless-table.svg)](https://www.npmjs.com/package/@humanspeak/svelte-headless-table)
[![CodeQL](https://github.com/humanspeak/svelte-headless-table/actions/workflows/codeql.yml/badge.svg)](https://github.com/humanspeak/svelte-headless-table/actions/workflows/codeql.yml)
[![Install size](https://packagephobia.com/badge?p=@humanspeak/svelte-headless-table)](https://packagephobia.com/result?p=@humanspeak/svelte-headless-table)
[![Code Style: Trunk](https://img.shields.io/badge/code%20style-trunk-blue.svg)](https://trunk.io)
[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
[![Types](https://img.shields.io/npm/types/@humanspeak/svelte-headless-table.svg)](https://www.npmjs.com/package/@humanspeak/svelte-headless-table)
[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/humanspeak/svelte-headless-table/graphs/commit-activity)

</div>

## Unopinionated and extensible data tables for Svelte

> Build and design powerful datagrid experiences while retaining 100% control over styles and markup.

Visit the [documentation](https://table.svelte.page/) for code examples and API reference, and get started with the [quick start guide](https://table.svelte.page/docs/getting-started/quick-start)!

## Why Svelte Headless Table?

Svelte Headless Table is designed to work **seamlessly** with Svelte. If you love Svelte, you will love Svelte Headless Table.

- **Full TypeScript support**
- Compatible with **SvelteKit** and SSR
- Manage state with Svelte stores
- Headless and fully customizable
- Intuitive column-first declarative model
- Highly performant
- Feature-rich

## All the features you could ever need

Svelte Headless Table comes with an extensive suite of plugins.

Easily extend Svelte Headless Table with complex **sorting**, **filtering**, **grouping**, **pagination**, and much more.

### Plugin roadmap

- [x] [addSortBy](https://table.svelte.page/docs/plugins/add-sort-by)
- [x] [addColumnFilters](https://table.svelte.page/docs/plugins/add-column-filters)
- [x] [addTableFilter](https://table.svelte.page/docs/plugins/add-table-filter)
- [x] [addColumnOrder](https://table.svelte.page/docs/plugins/add-column-order)
- [x] [addHiddenColumns](https://table.svelte.page/docs/plugins/add-hidden-columns)
- [x] [addPagination](https://table.svelte.page/docs/plugins/add-pagination)
- [x] [addSubRows](https://table.svelte.page/docs/plugins/add-sub-rows)
- [x] [addGroupBy](https://table.svelte.page/docs/plugins/add-group-by)
- [x] [addExpandedRows](https://table.svelte.page/docs/plugins/add-expanded-rows)
- [x] [addSelectedRows](https://table.svelte.page/docs/plugins/add-selected-rows)
- [x] [addResizedColumns](https://table.svelte.page/docs/plugins/add-resized-columns)
- [x] [addGridLayout](https://table.svelte.page/docs/plugins/add-grid-layout)
- [x] [addVirtualScroll](https://table.svelte.page/docs/plugins/add-virtual-scroll)

## Examples

<!-- prettier-ignore -->
```svelte
<script>
  const data = readable([
    { name: 'Ada Lovelace', age: 21 },
    { name: 'Barbara Liskov', age: 52 },
    { name: 'Richard Hamming', age: 38 },
  ]);

  const table = createTable(data);

  const columns = table.createColumns([
    table.column({
      header: 'Name',
      accessor: 'name',
    }),
    table.column({
      header: 'Age',
      accessor: 'age',
    }),
  ]);

  const {
    headerRows,
    rows,
    tableAttrs,
    tableBodyAttrs,
  } = table.createViewModel(columns);
</script>

<table {...$tableAttrs}>
  <thead>
    {#each $headerRows as headerRow (headerRow.id)}
      <Subscribe rowAttrs={headerRow.attrs()} let:rowAttrs>
        <tr {...rowAttrs}>
          {#each headerRow.cells as cell (cell.id)}
            <Subscribe attrs={cell.attrs()} let:attrs>
              <th {...attrs}>
                <Render of={cell.render()} />
              </th>
            </Subscribe>
          {/each}
        </tr>
      </Subscribe>
    {/each}
  </thead>
  <tbody {...$tableBodyAttrs}>
    {#each $rows as row (row.id)}
      <Subscribe rowAttrs={row.attrs()} let:rowAttrs>
        <tr {...rowAttrs}>
          {#each row.cells as cell (cell.id)}
            <Subscribe attrs={cell.attrs()} let:attrs>
              <td {...attrs}>
                <Render of={cell.render()} />
              </td>
            </Subscribe>
          {/each}
        </tr>
      </Subscribe>
    {/each}
  </tbody>
</table>
```

For more complex examples with advanced features, visit the [documentation site](https://table.svelte.page/docs/plugins/overview).