Frivio

Design

DataTable

ny

Faner, søk, sortering, paginering og masse-handling — bygget PÅ Table.

import { DataTable } from '@/components/ui/DataTable'

Retningslinjer

Bruk

  • En liste av objekter brukeren skal FILTRERE (faner/søk), SORTERE og gjøre MASSE-HANDLINGER på.

  • Faner er PREDIKAT-baserte (`test: rad => boolean`) — dekker fane-logikk som krysser flere felt.

  • `skjulUnder` (sm, md, lg, xl) skjuler en kolonne under et brytpunkt i stedet for å tvinge sidelengs rulling (regel/tabell-skjuler-heller-enn-aa-klippe).

Ikke bruk

  • Bruk `Table` alene for ren datavisning uten faner/søk/sortering.

  • Bruk `ListRow` for oppgave-/gjøremålslister — se regel/registertabell-familie.

Eksempler

Vis alt som

Full tabell — faner, søk, sortering, radvalg og masse-handling

Sveip tabellen for å se hele innholdet

Status
Rørlegger'n AS
Betalt
20. jul
24 000 kr
Boligventilasjon AS
Betalt
24. jul
9 400 kr
ByggMester Nord
Betalt
28. jul
28 000 kr
Låsesmeden AS
Karantene
1. aug
6 800 kr
Elektro Sør AS
Betalt
5. aug
32 000 kr
Heisservice AS
Karantene
6. aug
11 200 kr
Rørlegger'n AS
Karantene
11. aug
15 600 kr
Grønn Drift AS
Betalt
12. aug
36 000 kr
Totalt
417 900 kr

Kun sortering

Vaktmestersentralen
8. okt
7 800 kr
Grønn Drift AS
1. okt
6 400 kr
Elektro Sør AS
27. sep
4 800 kr
ByggMester Nord
22. sep
3 600 kr
Rørlegger'n AS
18. sep
2 400 kr
Heisservice AS
15. sep
1 800 kr

Med radvalg og masse-handling

Heisservice AS
15. sep
1 800 kr
Rørlegger'n AS
18. sep
2 400 kr
ByggMester Nord
22. sep
3 600 kr
Elektro Sør AS
27. sep
4 800 kr
Grønn Drift AS
1. okt
6 400 kr
Vaktmestersentralen
8. okt
7 800 kr

Registertabell — avatar + radutfolding

Detaljer
Leverandør
Heisservice AS
1 800 kr
Status
Ubetalt
Forfall
15. sep
Rørlegger'n AS
2 400 kr
Status
Ubetalt
Forfall
18. sep
ByggMester Nord
3 600 kr
Status
Ubetalt
Forfall
22. sep
Elektro Sør AS
4 800 kr
Status
Ubetalt
Forfall
27. sep

mobilRad — nøkkeltall under sm

Under sm: ListRow med nøkkeltall i stedet for sidelengs rulling.

Heisservice AS
Beløp
1 800 kr
Forfall
15. sep
Status
Ubetalt
Rørlegger'n AS
Beløp
2 400 kr
Forfall
18. sep
Status
Ubetalt
ByggMester Nord
Beløp
3 600 kr
Forfall
22. sep
Status
Ubetalt
Elektro Sør AS
Beløp
4 800 kr
Forfall
27. sep
Status
Ubetalt
Grønn Drift AS
Beløp
6 400 kr
Forfall
1. okt
Status
Ubetalt
Totalt
19 000 kr

Laster

Tom tilstand

Ingen fakturaer

Fakturaer sendt til adressen din dukker opp her.

Sveip tabellen for å se hele innholdet

Navn
Type
Default
Beskrivelse
data *
readonly T[]
—
Radenes data (ufiltrert, ett kilde-array).
kolonner *
DataTableColumn<T>[]
—
id, header, headerSr, celle()/verdi(), sorterbar, justering, bredde, skjulUnder, valgfri, formatTotal. Tom `header` + `headerSr` gir kolonnen skjermleserlesbart navn (standard «Handling»).
radKey *
(rad: T) => string
—
Stabil nøkkel per rad — brukes også som identifikator i radvalg.
radEtikett
(rad: T) => string
—
Menneskelesbar tekst for skjermleser-etiketten til rad-avkrysningen og ekspanderknappen.
faner
DataTableFane<T>[]
—
nokkel, label, test?(rad), alltidSynlig? — utelatt `test` (typisk «Alle») matcher alt. Antall vises live mot gjeldende søk. `alltidSynlig` merker den viktigste fanen («Trenger handling» på Fakturaer): den står alltid i raden, også på 375 px, og havner aldri bak «+N».
aktivFane / onFaneEndret
string / (nokkel: string) => void
—
Kontrollert fane (samme mønster som Popover sin open/onOpenChange) — kun nødvendig når kalleren selv må lese eller sette aktiv fane, f.eks. et kryss-hint i tomtilstanden som hopper til en annen fane.
sok
{ felter: (rad: T) => (string|number|null|undefined)[]; plassholder?; ariaLabel?; minRader? }
—
Slår på søkefeltet. æøå-trygg, case-insensitiv. `plassholder` er kort (maks 22 tegn, standard «Søk…»), `ariaLabel` er hva som søkes i og blir feltets aria-label — plassholderen kuttes aldri. `minRader` (standard 10): søkefeltet vises først fra så mange rader (`0` = alltid).
ekstraFilter
ReactNode
—
Ekstra filterkontroll i samme Toolbar, etter søket — f.eks. `PeriodeVelger` (se FakturaListe). Kallested filtrerer selv `data` FØR DataTable, så fanetellerne holder seg levende for filteret også.
standardSortering
{ kolonneId: string; retning: 'stigende'|'synkende' }
—
Startsortering. Uten denne vises radene i `data` sin egen rekkefølge.
radvalg
{ masseHandlinger: (ctx: { ider, rader, tom }) => ReactNode }
—
Slår på avkrysning. `masseHandlinger` rendres i en ActionBar når minst én rad er valgt.
sideStorrelse
number
10
Rader per side.
totaler
string[]
—
Kolonne-id-er som summeres i fotraden (krever `verdi()` på kolonnen).
tomTilstand
ReactNode | (ctx: { fane, sokAktiv, sokTekst, nullstillFilter }) => ReactNode
—
Erstatter hele tabellen når resultatet er tomt. Funksjonsform får aktiv fane, søketekst og en `nullstillFilter()` som tømmer søk/fane (for et fane-spesifikt kryss-hint eller «nullstill søket»-handling). Utelatt: enkel tekstrad (`tomTekst`).
laster
boolean
—
Viser et Skeleton-basert tabellskjelett i stedet for rader.
kolonnevelger
boolean
—
Slår på menyen for `valgfri`-kolonner (ingen effekt uten minst én).
minBredde
string
—
Arves rett til Table — sveip-hint under den bredden, se Table sin egen dokumentasjon.
merketRadKey
string | null
—
Arves til Table (markert rad, rulles inn i syne) — og DataTable hopper til siden raden ligger på. Fanen må kalleren sette selv (aktivFane), siden fanefilteret kjører før raden når Table.
urlNokkel
string
—
Lagrer fane+side i `?`-parametre (prefikset med denne nøkkelen) for en lenkbar side. Valgfritt, ingen av dagens to kallsteder bruker den.
radDetalj
(rad: T) => ReactNode
—
Radutfolding: legger til en chevron-kolonne først; trykk viser innholdet i en fullbredde rad under (Table sin `radUnder`/`apneRader`, delt `.collapsible-rows`-CSS). Brukt i Seksjoner for felt uten egen kolonne (leietaker, skatteopplysninger, notater).
mobilRad
(rad: T) => DataTableMobilRad
—
Opt-in: når DataTable-beholderen er smalere enn 48 rem (ikke skjermen) vises radene som ListRow (tittel + nokkeltall) i stedet for et sidelengs rutenett. Returnerer ListRow-slots + `apne` (trykk på raden åpner panelet/siden tabellen åpner) eller `detalj` (trekkspill med chevron, når det ikke finnes noe å åpne) og `under` (alltid synlig). Mister radvalg/masse-handling og kolonnesortering på smal skjerm; totalsummen vises som en «Totalt»-rad. Brukt i Fakturaer, Avtaleregisteret og Leverandører (navn i tittelen, fagtype og antall jobber på linje 2, kontakt og handlinger i `detalj`).
tomTekst
string
'Ingen rader'
Enkel tekst i tomtilstanden når `tomTilstand` er utelatt.
skeletonRader
number
5
Antall skjelettrader vist mens `laster` er sann.
className
string
—
Ekstra klasser på ytre wrapper.

Regler

regel/datatabell-er-en-primitiv-ikke-en-komposisjonregel/faner-teller-liveregel/masse-handling-i-actionbar-med-antallregel/kolonner-skjules-for-rullingregel/registertabell-familieregel/sok-bare-over-lister-det-lonner-seg-a-lete-iregel/alt-paa-foerste-linje

Beslektede