Om komponenten
Formål
Viser ett enkelt, fremtredende nøkkeltall med en valgfri, dempet etikett over - mønsteret man ser i dashboard-apper ("Denne måneden" / "12 340 kr"). Bruker en semantisk beskrivelsesliste (<dl>/<dt>/<dd>) internt, ikke generiske <p>/<span>-elementer, slik at etikett og verdi har en ekte term/beskrivelse-relasjon for skjermlesere.
Egner seg for
- Ett enkelt, dominerende tall per flate - et pengebeløp, en varighet, et antall - med en kort kontekst-etikett.
- Dashboard-/oversiktssider som skal fremheve én nøkkeltall-verdi fremfor en full tabell eller et diagram.
Egner seg ikke for
- Flere sammenlignbare tall side om side med samme vekt - bruk i stedet flere
<lm-stat>-elementer inni en<lm-grid>, eller et diagram (lm-chart-bar/lm-chart-line/lm-chart-pie) hvis dataene faktisk skal sammenlignes visuelt. - Løpende, redigerbar verdi i et skjema - dette er en ren visningskomponent uten input-semantikk.
Bruk
<script type="module" src="/designsystem/komponenter/innhold/stat/stat.js"></script>
<lm-stat label="Denne måneden">12 340 kr</lm-stat>
Prøv selv
Rediger koden under - resultatet oppdateres live.
Attributter
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
label | string | null | Attributt. Kort etikett vist dempet over selve verdien, f.eks. "Denne måneden". Utelates helt (ingen tomt rom) hvis attributtet mangler. |
Slots
| Slot | Beskrivelse |
|---|---|
| (standard) | Selve verdien - typisk kort tekst (et formatert beløp, en varighet, et antall). Vises stort og fett med tabular-nums for stabil sifferbredde. |
Parts
| Part | Beskrivelse |
|---|---|
stat | Den ytre <dl>-containeren. |
etikett | <dt>-elementet med etiketten. |
verdi | <dd>-elementet med selve verdien. |
Styling med ::part()
Hver part over kan restyles direkte fra et vanlig, ytre stilark - uten å måtte endre selve komponenten eller duplisere den:
lm-stat::part(stat) {
/* egne stiler for "Den ytre `<dl>`-containeren." */
}
lm-stat::part(etikett) {
/* egne stiler for "`<dt>`-elementet med etiketten." */
}
lm-stat::part(verdi) {
/* egne stiler for "`<dd>`-elementet med selve verdien." */
}
Tilgjengelighet
Bruker native <dl>/<dt>/<dd>-semantikk uten egne ARIA-roller. Skjermlesere annonserer etiketten som term og verdien som tilhørende beskrivelse.
label-attributtet rendres som<dt>- utelates helt fra DOM-treet (ingen tom<dt>) når attributtet mangler, slik at skjermlesere ikke annonserer en tom term.- Selve verdien får
font-variant-numeric: tabular-numsfor stabil siffer-bredde, en ren visuell detalj uten tilgjengelighetskonsekvens.
Detaljer
- Erstatter den tidligere prosjektspesifikke CSS-klassen
.sammendrag-belopiokonomi/styles.css. - Bruker den nye
--font-size-display-tokenen (designsystem/tokens/typografi/), lagt til spesifikt for denne typen store, enkeltstående tall.
Referanser
Se også:
../../data-visualisering/chart-bar/index.html - for sammenlignbare tall som faktisk skal visualiseres mot hverandre, i stedet for ett enkeltstående nøkkeltall.
Brukes av:
okonomi/index.html - "Denne måneden"-sammendragsbeløpet på Hjem-fanen.okonomi/index.html og okonomi/formue/index.html - nettoformue-tallet.
Avhengigheter: Ingen