finnYtterpunkter – Finn ytterpunkter i datasett / Find data set extremes

Om funksjonen

Kanonisk navn: finnYtterpunkter
Synonymer: min, max, høyeste, laveste, ytterpunkter, ekstremverdier, diagramsammendrag
Kategori: statistikk
ARIA-mønster: Ikke aktuelt - Ren matematisk beregning uten DOM, interaksjon eller visuell komponent.
Native-first-vurdering: Ren, avhengighetsfri JavaScript (Array.prototype.reduce) - ingen ekstern statistikk-pakke er nødvendig.
Nettleserstøtte: Standard ES2015+ (Array.prototype.reduce, spredning av vanlige objekter) - støttet i alle moderne nettlesere.
Sist endret: 20. september 2026
Brukt: 4 steder

Formål

Finner høyeste og laveste verdi i et sett med etikett/verdi-par. Brukes av <lm-chart-bar>, <lm-chart-line>, <lm-chart-area> og <lm-chart-scatter> til å bygge det synlige tekstsammendraget som vises under hvert diagram (f.eks. «Høyest: tirsdag (40). Lavest: mandag (12).»), i tillegg til den skjulte datatabellen. Se designsystem/guider/tall-og-statistikk/ for hvorfor et synlig sammendrag er en del av tilgjengelig statistikk - WAI sin veiledning om komplekse bilder anbefaler at et tekstsammendrag av det en visualisering viser gjøres tilgjengelig for alle, ikke bare skjermleserbrukere.

Egner seg for

Å generere et kort, menneskelesbart sammendrag av et diagrams data (høyeste/laveste punkt) som vises synlig ved siden av selve visualiseringen.
Ethvert sted et sett med etikett/verdi-par trenger sine ytterpunkter, ikke bare diagramkomponentene.

Egner seg ikke for

Mer avanserte trendmål (stigningstall, standardavvik) - se beregn-sentraltendens for grunnleggende sentraltendens-/spredningsmål.
Datasett der label ikke er unik og selve identiteten til ytterpunktet er tvetydig - funksjonen returnerer bare første treff ved uavgjort.

Signatur(er)

finnYtterpunkter(punkter: Array<{label: string, value: number}>) => {hoyeste: {label: string, value: number}, laveste: {label: string, value: number}} | null

Parameter	Type	Beskrivelse
`punkter`	`Array<{label: string, value: number}>`	Etikett/verdi-par, f.eks. rådataene bak et stolpe- eller linjediagram.

Returnerer: Ytterpunktene, eller null hvis punkter er tom. Ved uavgjort velges det først forekommende punktet.

import {finnYtterpunkter} from "/designsystem/funksjoner/statistikk/finn-ytterpunkter/finn-ytterpunkter.js";

finnYtterpunkter([{label: "Man", value: 12}, {label: "Tir", value: 40}]);
// {hoyeste: {label: "Tir", value: 40}, laveste: {label: "Man", value: 12}}

Prøv selv

Rediger uttrykket under - returverdien oppdateres live.

Tilgjengelighet

Ikke relevant i seg selv (ren logikk uten DOM), men eksisterer nettopp for å styrke tilgjengeligheten til diagramkomponentene som bruker den - se tilgjengelighet-feltet i chart-bar/chart-line/chart-area/chart-scatter sine egne manifester.

Referanser

Se også:

../beregn-sentraltendens/index.html - grunnleggende sentraltendens-/spredningsmål (gjennomsnitt/median/persentil) for samme type numeriske datasett.
../finn-skalatrinn/index.html - finner i stedet rutenett-trinnene for selve Y-aksen - denne funksjonen finner høyeste/laveste datapunkt for det synlige tekstsammendraget.
../../../komponenter/data-visualisering/chart-bar/index.html - bruker denne funksjonen til å bygge diagrammets synlige tekstsammendrag.

Brukes av:

designsystem/komponenter/data-visualisering/chart-bar/
designsystem/komponenter/data-visualisering/chart-line/
designsystem/komponenter/data-visualisering/chart-area/
designsystem/komponenter/data-visualisering/chart-scatter/

Avhengigheter: Ingen