Docs
Cloudflare
Railway
CodeRabbit
SerpAPI
OpenRouter
Netlify
Clerk
WorkOS
AG Grid
Electric
Unkey
Sentry
Prisma
Cloudflare
Railway
CodeRabbit
SerpAPI
OpenRouter
Netlify
Clerk
WorkOS
AG Grid
Electric
Unkey
Sentry
Prisma
Table API Reference
Column API Reference
Row API Reference
Cell API Reference
Header API Reference
Features API Reference
Static Functions API Reference

Svelte Example: Column Pinning

<script lang="ts">
  import { faker } from '@faker-js/faker'
  import type {
    ColumnDef,
    ColumnOrderState,
    ColumnPinningState,
    ColumnVisibilityState,
    Header,
  } from '@tanstack/svelte-table'
  import {
    columnPinningFeature,
    columnVisibilityFeature,
    FlexRender,
    columnOrderingFeature,
    rowSortingFeature,
    createSortedRowModel,
    createTable,
    createTableState,
    tableFeatures,
    sortFns,
  } from '@tanstack/svelte-table'
  import './index.css'
  import { makeData, type Person } from './makeData'

  const features = tableFeatures({
    columnOrderingFeature,
    columnPinningFeature,
    columnVisibilityFeature,
    rowSortingFeature,
    sortedRowModel: createSortedRowModel(),
    sortFns,
  })

  const columns: ColumnDef<typeof features, Person>[] = [
    {
      header: 'Name',
      footer: (props) => props.column.id,
      columns: [
        {
          accessorKey: 'firstName',
          cell: (info) => info.getValue(),
          footer: (props) => props.column.id,
        },
        {
          accessorFn: (row) => row.lastName,
          id: 'lastName',
          cell: (info) => info.getValue(),
          header: () => 'Last Name',
          footer: (props) => props.column.id,
        },
      ],
    },
    {
      header: 'Info',
      footer: (props) => props.column.id,
      columns: [
        {
          accessorKey: 'age',
          header: () => 'Age',
          footer: (props) => props.column.id,
        },
        {
          header: 'More Info',
          columns: [
            {
              accessorKey: 'visits',
              header: () => 'Visits',
              footer: (props) => props.column.id,
            },
            {
              accessorKey: 'status',
              header: 'Status',
              footer: (props) => props.column.id,
            },
            {
              accessorKey: 'progress',
              header: 'Profile Progress',
              footer: (props) => props.column.id,
            },
          ],
        },
      ],
    },
  ]

  let data = $state(makeData(1_000))
  const refreshData = () => { data = makeData(1_000) }
  const stressTest = () => { data = makeData(500_000) }

  let isSplit = $state(false)

  const [columnOrder, setColumnOrder] = createTableState<ColumnOrderState>([])
  const [columnPinning, setColumnPinning] =
    createTableState<ColumnPinningState>({ left: [], right: [] })
  const [columnVisibility, setColumnVisibility] =
    createTableState<ColumnVisibilityState>({})

  const randomizeColumns = () => {
    table.setColumnOrder((_updater) =>
      faker.helpers.shuffle(table.getAllLeafColumns().map((d) => d.id)),
    )
  }

  const table = createTable({
    features,
    get data() {
      return data
    },
    columns,
    state: {
      get columnOrder() {
        return columnOrder()
      },
      get columnPinning() {
        return columnPinning()
      },
      get columnVisibility() {
        return columnVisibility()
      },
    },
    onColumnOrderChange: setColumnOrder,
    onColumnPinningChange: setColumnPinning,
    onColumnVisibilityChange: setColumnVisibility,
    debugTable: true,
  })
</script>

{#snippet headerCell(header: Header<typeof features, Person, unknown>)}
  <th colSpan={header.colSpan}>
    <div class="nowrap">
      {#if !header.isPlaceholder}
        <FlexRender header={header} />
      {/if}
    </div>
    {#if !header.isPlaceholder && header.column.getCanPin()}
      <div class="pin-actions">
        {#if header.column.getIsPinned() !== 'left'}
          <button
            class="pin-button"
            onclick={() => {
              header.column.pin('left')
            }}
          >
            {'<='}
          </button>
        {/if}
        {#if header.column.getIsPinned()}
          <button
            class="pin-button"
            onclick={() => {
              header.column.pin(false)
            }}
          >
            X
          </button>
        {/if}
        {#if header.column.getIsPinned() !== 'right'}
          <button
            class="pin-button"
            onclick={() => {
              header.column.pin('right')
            }}
          >
            {'=>'}
          </button>
        {/if}
      </div>
    {/if}
  </th>
{/snippet}

<div class="demo-root">
  <div>
    <button onclick={() => refreshData()}>Regenerate Data</button>
    <button onclick={() => stressTest()}>Stress Test (500k rows)</button>
  </div>
  <div class="column-toggle-panel">
    <div class="column-toggle-panel-header">
      <label>
        <input
          checked={table.getIsAllColumnsVisible()}
          onchange={(e) => {
            console.info(table.getToggleAllColumnsVisibilityHandler()(e))
          }}
          type="checkbox"
        />{' '}
        Toggle All
      </label>
    </div>
    {#each table.getAllLeafColumns() as column}
      <div class="column-toggle-row">
        <label>
          <input
            checked={column.getIsVisible()}
            onchange={column.getToggleVisibilityHandler()}
            type="checkbox"
          />{' '}
          {column.id}
        </label>
      </div>
    {/each}
  </div>
  <div class="spacer-md"></div>
  <div class="button-row">
    <button onclick={() => randomizeColumns()} class="demo-button demo-button-sm">
      Shuffle Columns
    </button>
  </div>
  <div class="spacer-md"></div>
  <div>
    <label>
      <input
        type="checkbox"
        checked={isSplit}
        onchange={(e) => (isSplit = e.currentTarget.checked)}
      />{' '}
      Split Mode
    </label>
  </div>
  <div class={`table-row-group ${isSplit ? 'split-gap' : ''}`}>
    {#if isSplit}
      <table class="outlined-table">
        <thead>
          {#each table.getLeftHeaderGroups() as headerGroup (headerGroup.id)
          }
            <tr>
              {#each headerGroup.headers as header (header.id)}
                {@render headerCell(header)}
              {/each}
            </tr>
          {/each}
        </thead>
        <tbody>
          {#each table.getCoreRowModel().rows.slice(0, 20) as row (row.id)}
            <tr>
              {#each row.getLeftVisibleCells() as cell (cell.id)}
                <td>
                  <FlexRender cell={cell} />
                </td>
              {/each}
            </tr>
          {/each}
        </tbody>
      </table>
    {/if
    }
    <table class="outlined-table">
      <thead>
        {#each isSplit ? table.getCenterHeaderGroups() : table.getHeaderGroups() as headerGroup (headerGroup.id)
        }
          <tr>
            {#each headerGroup.headers as header (header.id)}
              {@render headerCell(header)}
            {/each}
          </tr>
        {/each}
      </thead>
      <tbody>
        {#each table.getCoreRowModel().rows.slice(0, 20) as row (row.id)}
          <tr>
            {#each isSplit ? row.getCenterVisibleCells() : row.getVisibleCells() as cell (cell.id)}
              <td>
                <FlexRender cell={cell} />
              </td>
            {/each}
          </tr>
        {/each}
      </tbody>
    </table>
    {#if isSplit
    }
      <table class="outlined-table">
        <thead>
          {#each table.getRightHeaderGroups() as headerGroup (headerGroup.id)
          }
            <tr>
              {#each headerGroup.headers as header (header.id)}
                {@render headerCell(header)}
              {/each}
            </tr>
          {/each}
        </thead>
        <tbody>
          {#each table.getRowModel().rows.slice(0, 20) as row (row.id)}
            <tr>
              {#each row.getRightVisibleCells() as cell (cell.id)}
                <td>
                  <FlexRender cell={cell} />
                </td>
              {/each}
            </tr>
          {/each}
        </tbody>
      </table>
    {/if
    }
  </div>
  <br />
  <pre>{JSON.stringify(table.state, null, 2)}</pre>
</div>
<script lang="ts">
  import { faker } from '@faker-js/faker'
  import type {
    ColumnDef,
    ColumnOrderState,
    ColumnPinningState,
    ColumnVisibilityState,
    Header,
  } from '@tanstack/svelte-table'
  import {
    columnPinningFeature,
    columnVisibilityFeature,
    FlexRender,
    columnOrderingFeature,
    rowSortingFeature,
    createSortedRowModel,
    createTable,
    createTableState,
    tableFeatures,
    sortFns,
  } from '@tanstack/svelte-table'
  import './index.css'
  import { makeData, type Person } from './makeData'

  const features = tableFeatures({
    columnOrderingFeature,
    columnPinningFeature,
    columnVisibilityFeature,
    rowSortingFeature,
    sortedRowModel: createSortedRowModel(),
    sortFns,
  })

  const columns: ColumnDef<typeof features, Person>[] = [
    {
      header: 'Name',
      footer: (props) => props.column.id,
      columns: [
        {
          accessorKey: 'firstName',
          cell: (info) => info.getValue(),
          footer: (props) => props.column.id,
        },
        {
          accessorFn: (row) => row.lastName,
          id: 'lastName',
          cell: (info) => info.getValue(),
          header: () => 'Last Name',
          footer: (props) => props.column.id,
        },
      ],
    },
    {
      header: 'Info',
      footer: (props) => props.column.id,
      columns: [
        {
          accessorKey: 'age',
          header: () => 'Age',
          footer: (props) => props.column.id,
        },
        {
          header: 'More Info',
          columns: [
            {
              accessorKey: 'visits',
              header: () => 'Visits',
              footer: (props) => props.column.id,
            },
            {
              accessorKey: 'status',
              header: 'Status',
              footer: (props) => props.column.id,
            },
            {
              accessorKey: 'progress',
              header: 'Profile Progress',
              footer: (props) => props.column.id,
            },
          ],
        },
      ],
    },
  ]

  let data = $state(makeData(1_000))
  const refreshData = () => { data = makeData(1_000) }
  const stressTest = () => { data = makeData(500_000) }

  let isSplit = $state(false)

  const [columnOrder, setColumnOrder] = createTableState<ColumnOrderState>([])
  const [columnPinning, setColumnPinning] =
    createTableState<ColumnPinningState>({ left: [], right: [] })
  const [columnVisibility, setColumnVisibility] =
    createTableState<ColumnVisibilityState>({})

  const randomizeColumns = () => {
    table.setColumnOrder((_updater) =>
      faker.helpers.shuffle(table.getAllLeafColumns().map((d) => d.id)),
    )
  }

  const table = createTable({
    features,
    get data() {
      return data
    },
    columns,
    state: {
      get columnOrder() {
        return columnOrder()
      },
      get columnPinning() {
        return columnPinning()
      },
      get columnVisibility() {
        return columnVisibility()
      },
    },
    onColumnOrderChange: setColumnOrder,
    onColumnPinningChange: setColumnPinning,
    onColumnVisibilityChange: setColumnVisibility,
    debugTable: true,
  })
</script>

{#snippet headerCell(header: Header<typeof features, Person, unknown>)}
  <th colSpan={header.colSpan}>
    <div class="nowrap">
      {#if !header.isPlaceholder}
        <FlexRender header={header} />
      {/if}
    </div>
    {#if !header.isPlaceholder && header.column.getCanPin()}
      <div class="pin-actions">
        {#if header.column.getIsPinned() !== 'left'}
          <button
            class="pin-button"
            onclick={() => {
              header.column.pin('left')
            }}
          >
            {'<='}
          </button>
        {/if}
        {#if header.column.getIsPinned()}
          <button
            class="pin-button"
            onclick={() => {
              header.column.pin(false)
            }}
          >
            X
          </button>
        {/if}
        {#if header.column.getIsPinned() !== 'right'}
          <button
            class="pin-button"
            onclick={() => {
              header.column.pin('right')
            }}
          >
            {'=>'}
          </button>
        {/if}
      </div>
    {/if}
  </th>
{/snippet}

<div class="demo-root">
  <div>
    <button onclick={() => refreshData()}>Regenerate Data</button>
    <button onclick={() => stressTest()}>Stress Test (500k rows)</button>
  </div>
  <div class="column-toggle-panel">
    <div class="column-toggle-panel-header">
      <label>
        <input
          checked={table.getIsAllColumnsVisible()}
          onchange={(e) => {
            console.info(table.getToggleAllColumnsVisibilityHandler()(e))
          }}
          type="checkbox"
        />{' '}
        Toggle All
      </label>
    </div>
    {#each table.getAllLeafColumns() as column}
      <div class="column-toggle-row">
        <label>
          <input
            checked={column.getIsVisible()}
            onchange={column.getToggleVisibilityHandler()}
            type="checkbox"
          />{' '}
          {column.id}
        </label>
      </div>
    {/each}
  </div>
  <div class="spacer-md"></div>
  <div class="button-row">
    <button onclick={() => randomizeColumns()} class="demo-button demo-button-sm">
      Shuffle Columns
    </button>
  </div>
  <div class="spacer-md"></div>
  <div>
    <label>
      <input
        type="checkbox"
        checked={isSplit}
        onchange={(e) => (isSplit = e.currentTarget.checked)}
      />{' '}
      Split Mode
    </label>
  </div>
  <div class={`table-row-group ${isSplit ? 'split-gap' : ''}`}>
    {#if isSplit}
      <table class="outlined-table">
        <thead>
          {#each table.getLeftHeaderGroups() as headerGroup (headerGroup.id)
          }
            <tr>
              {#each headerGroup.headers as header (header.id)}
                {@render headerCell(header)}
              {/each}
            </tr>
          {/each}
        </thead>
        <tbody>
          {#each table.getCoreRowModel().rows.slice(0, 20) as row (row.id)}
            <tr>
              {#each row.getLeftVisibleCells() as cell (cell.id)}
                <td>
                  <FlexRender cell={cell} />
                </td>
              {/each}
            </tr>
          {/each}
        </tbody>
      </table>
    {/if
    }
    <table class="outlined-table">
      <thead>
        {#each isSplit ? table.getCenterHeaderGroups() : table.getHeaderGroups() as headerGroup (headerGroup.id)
        }
          <tr>
            {#each headerGroup.headers as header (header.id)}
              {@render headerCell(header)}
            {/each}
          </tr>
        {/each}
      </thead>
      <tbody>
        {#each table.getCoreRowModel().rows.slice(0, 20) as row (row.id)}
          <tr>
            {#each isSplit ? row.getCenterVisibleCells() : row.getVisibleCells() as cell (cell.id)}
              <td>
                <FlexRender cell={cell} />
              </td>
            {/each}
          </tr>
        {/each}
      </tbody>
    </table>
    {#if isSplit
    }
      <table class="outlined-table">
        <thead>
          {#each table.getRightHeaderGroups() as headerGroup (headerGroup.id)
          }
            <tr>
              {#each headerGroup.headers as header (header.id)}
                {@render headerCell(header)}
              {/each}
            </tr>
          {/each}
        </thead>
        <tbody>
          {#each table.getRowModel().rows.slice(0, 20) as row (row.id)}
            <tr>
              {#each row.getRightVisibleCells() as cell (cell.id)}
                <td>
                  <FlexRender cell={cell} />
                </td>
              {/each}
            </tr>
          {/each}
        </tbody>
      </table>
    {/if
    }
  </div>
  <br />
  <pre>{JSON.stringify(table.state, null, 2)}</pre>
</div>