@k8ordo/ui

DataTable

並べ替えと行の選択、列の表示切り替えができる表です。状態はすべて呼び出し側が持ちます。

インポート

ts
import { DataTable, type DataTableSort } from '@k8ordo/ui';

使い方

DataTableは並べ替えの状態を受け取っても自分では並べ替えず、rowsを渡された順に描きます。そのため、サーバーで並べ替えるときも同じコンポーネントで済みます。機能はそれぞれ、その変化を受け取る関数を渡したときだけ現れます。

Role
AokiDesigner3
InoueEngineer8
UedaEngineer5
tsx
const [sort, setSort] = useState<DataTableSort | null>(null);
const [selectedIds, setSelectedIds] = useState<string[]>([]);
const [hiddenColumnIds, setHiddenColumnIds] = useState<string[]>([]);

<DataTable
  columns={[
    { id: 'name', header: 'Name', cell: (m) => m.name, sortable: true },
    { id: 'role', header: 'Role', cell: (m) => <Badge label={m.role} /> },
    {
      id: 'projects',
      header: 'Projects',
      cell: (m) => m.projects,
      align: 'right',
      sortable: true,
    },
  ]}
  getRowId={(m) => m.id}
  hiddenColumnIds={hiddenColumnIds}
  label="Members"
  onHiddenColumnIdsChange={setHiddenColumnIds}
  onSelectedIdsChange={setSelectedIds}
  onSortChange={setSort}
  rows={sortMembers(members, sort)}
  selectedIds={selectedIds}
  sort={sort}
/>

URLに置く並べ替えとページ

@k8ordo/stateのurlに、並べ替えとページを置いた例です。リンクを渡した相手にも同じ並びの同じページが見え、戻るボタンで前の並びに戻れます。

Role
AokiDesigner3
InoueEngineer8
UedaEngineer5
tsx
// members-state.ts
export const membersState = definePageState('members', {
  url: z.object({
    sort: z._default(z.enum(['', 'name', 'projects']), ''),
    dir: z._default(z.enum(['ascending', 'descending']), 'ascending'),
    page: z._default(z.coerce.number().check(z.int(), z.gte(1)), 1),
  }),
});

// members-table.tsx
const [{ sort, dir, page }, update] = useAppState(membersState);
const current = sort === '' ? null : { columnId: sort, direction: dir };
const rows = sortMembers(members, current);

<DataTable
  columns={columns}
  getRowId={(m) => m.id}
  label="Members"
  onSortChange={(next) => {
    update(
      next === null
        ? { sort: '', dir: 'ascending', page: 1 }
        : { sort: next.columnId, dir: next.direction, page: 1 },
      { history: 'push' },
    );
  }}
  rows={rows.slice((page - 1) * PAGE_SIZE, page * PAGE_SIZE)}
  sort={current}
/>
<Pagination
  currentPage={page}
  onChange={(next) => update({ page: next }, { history: 'push' })}
  totalPages={Math.ceil(rows.length / PAGE_SIZE)}
/>

空の表

rowsが空のときは、emptyStateに渡したものを、すべての列をまたぐ1行に描きます。EmptyStateを渡します。

NameRoleProjects

No members yet

tsx
<DataTable
  columns={columns}
  emptyState={<EmptyState title="No members yet" />}
  getRowId={(m) => m.id}
  label="Members"
  rows={[]}
/>

Props

columns
Type: ReadonlyArray<DataTableColumn<Row>>
Default: -
getRowId
Type: (row: Row) => string
Default: -
label
Type: string
Default: -
rows
Type: readonly Row[]
Default: -
emptyState?
Type: ReactNode
Default: -
hiddenColumnIds?
Type: readonly string[]
Default: NONE
onHiddenColumnIdsChange?
Type: (ids: string[]) => void
Default: -
onSelectedIdsChange?
Type: (ids: string[]) => void
Default: -
onSortChange?
Type: (sort: DataTableSort | null) => void
Default: -
selectedIds?
Type: readonly string[]
Default: NONE
sort?
Type: DataTableSort|null
Default: null
PropTypeDefault
columnsReadonlyArray<DataTableColumn<Row>>-
getRowId(row: Row) => string-
labelstring-
rowsreadonly Row[]-
emptyState?ReactNode-
hiddenColumnIds?readonly string[]NONE
onHiddenColumnIdsChange?(ids: string[]) => void-
onSelectedIdsChange?(ids: string[]) => void-
onSortChange?(sort: DataTableSort | null) => void-
selectedIds?readonly string[]NONE
sort?DataTableSort|nullnull

ラベルやプレースホルダーなど、このコンポーネントが描く文言は、propsで指定しないと文言辞書から読まれます。差し替え方は次を見てください: コンポーネントの文言

k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。