Om funksjonen
Formål
To beslektede tallformateringsfunksjoner bygget på innebygd Intl.NumberFormat: formatTall gir kompakt notasjon ("1,2 mill.") for trange flater som nøkkeltall-kort og diagramakser, mens formatTallFullt gir det fulle tallet med tusenskille når eksakthet er viktigere enn kompakthet (f.eks. en datatabell eller eksport).
Egner seg for
- Store tall i nøkkeltall-kort (
<lm-stat>), diagramaksetekst og tabellceller der plass er begrenset. - Steder der brukeren trenger det eksakte tallet - bruk
formatTallFullti stedet forformatTall(f.eks. i en skjult datatabell bak et diagram, se<lm-chart-bar>/<lm-chart-line>m.fl.).
Egner seg ikke for
- Pengebeløp - bruk
formatCurrency, som gir korrekt valutasymbol og desimalregler. - Validering eller beregning; funksjonene returnerer kun visningstekst, ikke et tall å regne videre på.
Signatur(er)
formatTall(value: number | string, locale?: string) => string
| Parameter | Type | Beskrivelse |
|---|---|---|
value | number | string | Tallet som skal formateres. |
locale (valgfri) | string | Locale for Intl.NumberFormat. Standard "nb-NO". |
Returnerer: Kompakt formatert tall, f.eks. "1,2 mill." eller "340k". Returnerer "" for tom/manglende/ikke-numerisk verdi.
import {formatTall} from "/designsystem/funksjoner/formattering/format-tall/format-tall.js";
formatTall(1250000); // "1,3 mill."
formatTall(3400); // "3,4k"
formatTallFullt(value: number | string, locale?: string) => string
| Parameter | Type | Beskrivelse |
|---|---|---|
value | number | string | Tallet som skal formateres. |
locale (valgfri) | string | Locale for Intl.NumberFormat. Standard "nb-NO". |
Returnerer: Fullt formatert tall med tusenskille, f.eks. "1 250 000". Returnerer "" for tom/manglende/ikke-numerisk verdi.
import {formatTallFullt} from "/designsystem/funksjoner/formattering/format-tall/format-tall.js";
formatTallFullt(1250000); // "1 250 000"
Prøv selv
Rediger uttrykket under - returverdien oppdateres live.
Tilgjengelighet
Ikke relevant: ren logikk uten DOM eller UI. Merk at kompakt notasjon (formatTall) kutter presisjon for skjermlesere så vel som seende - vis alltid det fulle tallet et sted (tooltip, skjult datatabell) når eksaktheten faktisk betyr noe, se designsystem/guider/tall-og-statistikk/.
Referanser
Se også:
../format-currency/index.html - Søsterfunksjon i samme formatteringskategori, men for pengebeløp med valutasymbol.../format-prosentendring/index.html - Beslektet formatteringsbehov for prosentvis endring/trend i stedet for en rå størrelse.../../statistikk/beregn-sentraltendens/index.html - Naturlig følgesvenn - regn ut gjennomsnitt/median/persentil, og formater resultatet med disse funksjonene.
Avhengigheter: Ingen