Hopp til hovedinnhold
Meny

lmfaole.party / designsystem / funksjoner / Tallformatering

  • Forside
  • Turer
  • Økonomi
  • Slides
  • formatTall – Tallformatering / Number formatting

    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 formatTallFullt i stedet for formatTall (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
    valuenumber | stringTallet som skal formateres.
    locale (valgfri)stringLocale 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
    valuenumber | stringTallet som skal formateres.
    locale (valgfri)stringLocale 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å:

    Avhengigheter: Ingen