Om funksjonen
Formål
Formaterer en avstand oppgitt i kilometer, med valgfri konvertering til miles ved visning, via innebygd Intl.NumberFormat. Lar en app tilby km/miles som brukerpreferanse uten å gjøre interne beregninger enhetsavhengige.
Egner seg for
- Visning av en avstand i brukerens foretrukne enhet, når selve beregningen internt alltid skjer i kilometer.
Egner seg ikke for
- Ikke for selve reiseberegningen (transportvalg, hastighetsestimat) - den skal fortsatt regne i kilometer internt, kun visningen konverteres.
Signatur(er)
formatDistance(km: number, unit?: "km" | "miles", locale?: string) => string
| Parameter | Type | Beskrivelse |
|---|---|---|
km | number | Avstanden i kilometer. |
unit (valgfri) | "km" | "miles" | Enheten avstanden skal vises i. |
locale (valgfri) | string | Overstyrer hvilket locale Intl.NumberFormat skal bruke. |
Returnerer: Formatert avstand med enhet, f.eks. "120 km" eller "75 mi". Returnerer "" for manglende/ugyldig km.
import {formatDistance} from "/designsystem/funksjoner/formattering/format-distance/format-distance.js";
formatDistance(120.4); // "120 km"
formatDistance(120.4, "miles"); // "75 mi"// Brukt i turer/ for å vise avstander i brukerens valgte enhet
// (satt under onboarding), uten å gjøre selve transportvalg-/
// hastighetsestimat-beregningene enhetsavhengige - de regner alltid i km.Prøv selv
Rediger uttrykket under - returverdien oppdateres live.
Tilgjengelighet
Ikke relevant: ren logikk uten DOM eller UI.
Referanser
Se også:
../format-currency/index.html - Samme mønster - en brukervalgt enhet/valuta konverteres kun ved visning, ikke i intern beregning.
Brukes av:
turer
Avhengigheter: Ingen