Frivio

Design

StatCard

Felles KPI-kort — tall, etikett og ikon i samme materiale som Card.

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

Retningslinjer

Bruk

  • Ett fremhevet tall med kort rundt — dashbord, økonomi, byggsidens nøkkeltall.

  • `tone="hero"` for DEN ene fremhevede metrikken på en flate.

  • `StatCardRad` for raden av flere kort — aldri et håndrullet grid. Tallene i en rad får lik størrelse, og et enslig kort fyller hele raden.

Ikke bruk

  • Ikke for mange små feltverdier i rutenett — det er DescriptionList sin jobb.

  • `sparkline` kun med en ekte serie på minst FIRE punkter og en lesbar retning (regel/sparklinje-trenger-en-kurve).

Eksempler

Vis alt som

Standard, hero og error

Estimert total

kr 1 240 500

Neste 10 år

Fremdrift

62 %

18 av 29 tiltak

Akutte tiltak

3

Bør tas nå

error + trend

Forfalt

2

Bør følges opp nå

Forfalt

2

Bør følges opp nå

40 %

Mobil — tall først

Forfalt

2

Bør følges opp nå

Estimert total

kr 1 240 500

Neste 10 år

Fremdrift

62 %

18 av 29 tiltak

Kolonner følger radens bredde, ikke skjermens

Kolonnene måles på radens bredde (12rem per kort), ikke skjermens.

Inntekter 2026

224 740 kr

Utgifter 2026

198 300 kr

Årsresultat

26 440 kr

Sum felleskostnader/mnd

1 920 kr

Inntekter 2026

224 740 kr

Utgifter 2026

198 300 kr

Årsresultat

26 440 kr

Sum felleskostnader/mnd

1 920 kr

Ord er ikke tall — verdiType="tekst"

Status i ord settes i heading-20, ikke 32. Sett `verdiType="tekst"` når verdien har siffer.

Forfalt

2

Kontantbeholdning

Ikke registrert

Budsjett

Ingen budsjett for 2026

Foreløpig tall (forelopig)

Ufullstendig grunnlag: foreløpig tall, forbehold under.

Per seksjon

2 264 kr

per måned · valgt bygg · alle åpne engangstiltak

Per seksjonForeløpig

2 264 kr (foreløpig)

Foreløpig: bare 2 av 12 seksjoner i valgt bygg er lagt inn, så beløpet er for høyt.

per måned · valgt bygg · alle åpne engangstiltak

To og to på mobil (kompakt)

Bruk når 3–4 nøkkeltall har korte etiketter og korte tall: raden velger selv (`auto`) og blir to kolonner på smal mobil, ellers én. Smal mobil viser ikke ikon, sparkline og trend.

Levert

12

Sendt

4

Ikke sendt

7

Uten svar

2

labelColor — etikett og ikon farget sammen

Inntekter

kr 42 000

Utgifter

kr 31 000

Med ekstra innhold

Estimert total

kr 1 240 500

Neste 10 år

Oppdatert etter siste tilstandsrapport.

sparkline og endring

Inntekter 2026

421 500 kr

+23 500 kr
Utgifter 2026

312 000 kr

−28 000 kr
Vedlikeholdsfond

62 %

av årets mål

Like høye uansett innhold

Økonomi

OK

Årsmøte

Krever oppfølging

StatCardRad — 3 og 4 kort

Estimert total

kr 1 240 500

Fremdrift

62 %

Akutte tiltak

3

Total

kr 1,2M

Inntekt

kr 42 000

Utgift

kr 31 000

Akutte

3

enLinjeMobil — ett kort over en liste

Per seksjon

2 264 kr

per måned

Langt tall — aldri linjebrudd

Et intervall bryter aldri linje, kun mindre skrift. `kolonner={2}`: {4} ble for smalt.

Estimert totalkostnad

651 000–893 000 kr

14 åpne tiltak · inkl. MVA

Per seksjon per måned

890–1 220 kr/mnd

NumberTicker

Kun for et nøkkeltall brukeren følger over tid, aldri pynt.

På konto

0 kr

Oppdatert nå

Progress som children

Ikke sammen med sparkline/endring — samme plass under verdien.

Budsjett brukt

64 %

kr 1 240 000 av kr 1 940 000

Sveip tabellen for å se hele innholdet

Navn
Type
Default
Beskrivelse
icon
LucideIcon
—
PÅKREVD: ikon foran etiketten på hvert kort (14 px, dekor — etiketten bærer meningen). Én regel: ALLE nøkkeltallkort har ikon; raden skjuler dem selv i halv bredde på smal mobil (to og to). Ingen kort uten ikon (regel/statcard-alltid-ikon)
label *
string
—
Kort etikett over verdien.
labelColor
string
—
Overstyrer etikett- OG ikonfargen sammen (f.eks. suksess/feil på inntekt/utgift). Uten den: alltid text-secondary.
value *
ReactNode
—
Hovedtallet — standard heading-32, trappes til 24/20/16 etter kortbredde og lengde. Sifre bryter aldri linje; ren tekst kan bryte, maks to linjer.
valueTekstLengde
number
—
Lengden `value` ville hatt som tekst — kun når `value` er en `ReactNode` StatCard ikke selv kan måle (f.eks. `NumberTicker`).
verdiType
'tall' | 'tekst'
—
`tekst`: verdien er et ord/en frase og står i heading-20, aldri i tallstørrelsen 32. Utelatt: en streng uten sifre og lengre enn to tegn er `tekst`, alt annet `tall`. Sett den selv for «Ingen budsjett for 2026» (har siffer) eller «OK» (kort).
valueStyle
CSSProperties
—
Ekstra stil på verditeksten.
sub
ReactNode
—
Liten forklaringslinje under verdien.
subStyle
CSSProperties
—
Ekstra stil på sub-linjen.
forelopig
ReactNode
—
Forbehold-setning når tallet bygger på ufullstendig grunnlag (lib/datakvalitet.ts), også under dekningsgrensen: tallet tegnes foreløpig. Ikke med sparkline/endring. Bare en påstand holdes tilbake under grensen (ManglerGrunnlag).
sparkline
number[]
—
28px høy sparklinje under sub/endring. Under 4 punkter, flat serie eller en serie uten retning (V, Λ, støy): ingen linje (`sparklineLesbar`). Ingen akse/tooltip — se regel/sparklinje-viser-retning-ikke-verdi.
endring
{ verdi: string; retning: 'opp' | 'ned' | 'flat'; god?: boolean }
—
Lite merke med pil og ferdigformatert verdi. `god` (ikke `retning`) styrer farge — en fallende utgiftskurve er «ned» og likevel bra.
tone
'default' | 'hero' | 'error' | 'danger'
'default'
`hero` bruker den gråtonede gradienten for DEN ene fremhevede metrikken. `error`/`danger` (alias) beholder samme rolige flate som default — kun etikett, ikon og verdi farges i feilfarge.
enLinjeMobil
boolean
false
Under `sm`: kortet er ÉN linje (etikett til venstre, verdi i heading-20 og sub til høyre) i stedet for tre. For ET kort som står alene over en liste, ikke i en StatCardRad og ikke sammen med sparkline/endring/children. Fra `sm`: uendret.
className
string
—
Ekstra klasser på kortet.
StatCardRad kolonner
2 | 3 | 4
3
Kolonner når raden er bred nok — målt på RADENS bredde (container query), 12rem per kort: 2 fra 25rem, 3 fra 37rem, 4 fra 49rem. Smalere: én kolonne, med verdien først (stor), deretter ikon+etikett, så sub.
StatCardRad kompaktMobil
boolean | 'auto'
'auto'
To kolonner også i smal beholder. `auto`: raden avgjør selv, målt mot 320 px (etikett høyst to linjer uten ordbrudd, verdi på én linje). `true` tvinger, `false` slår av. Oddetall: siste kort spenner begge.
StatCardRad className
string
—
Legges på den ytre beholderen (marg, maks-bredde) — det er dens bredde kolonnene måles mot.
children
ReactNode
—
Ekstra innhold under sub (progressbar, notis o.l.).

Regler

regel/sparklinje-viser-retning-ikke-verdiregel/statcard-mobil-en-kolonneregel/mobil-egen-komposisjon-enlinjes-kortregel/nullkort-er-ikke-kortregel/avledede-tall-viser-grunnlagetregel/avledede-tall-under-grensen-skjules

Beslektede