Inneholder grunnstilen til designsystemet Jøkul. Inneholder også et normaliserings-stilark som sørger for at alle nettlesere har samme utgangspunkt når de skal vise en Fremtind-side.
Dersom du skal bygge komponenter for Fremtind, utover de som finnes i Jøkul, bør du bruke variablene her. Det sørger for at farger, sperring, typografisk skala og liknende holder seg oppdatert mot endringer i designsystemet.
Se portalen for bruk og prinsipper.
Installasjon
npm i @fremtind/jkl-core
.- Importér stil-pakken i prosjektet ditt.
import { initTabListener, Link } from "@fremtind/jkl-core";
initTabListener();
import "@fremtind/jkl-core/core.min.css";
@use "@fremtind/jkl-core/core";
@use "@fremtind/jkl-core/jkl";
@include jkl.light-mode-variables {
}
Bruk
Klassen jkl
For at CSSen i Jøkul skal fungere som forventet må du sette klassen jkl
på rotnivå i applikasjonen din.
Vi bruker jkl
-klassen til å blant annet:
- Sette riktige fonter.
- Gi standardfarger til tekst og bakgrunn.
- Noen CSS resets.
Du har kanskje en komponent som heter Layout
eller App
hvor du kan sette denne klassen? Om du er usikker, sett klassen på body
.
import React, { FC } from "react";
import { WithChildren } from "@fremtind/jkl-core";
export const Layout: FC<WithChildren> = ({ children }) => {
return <div className="jkl">{children}</div>;
};
initTabListener()
Av tilgjengelighetshensyn viser vi fokusomriss på interaktive elementer når man navigerer en løsning ved hjelp av tastaturet. Normalt blir disse omrissene også vist når man bruker musen for navigasjon, noe vi ikke ønsker.
Hjelpefunksjonen initTabListener()
sørger for å sette et flagg på <body>
når man navigerer med musen, som skjuler omrissene. Importer og kall funksjonen på rotnivå i prosjektet ditt (der siden rendres).
import { initTabListener } from "@fremtind/jkl-core";
initTabListener();
Kompakt modus
Noen løsninger, spesielt rådgiverløsninger, har behov for å vise veldig mye informasjon på skjermen samtidig. Derfor ønsker vi å tilby kompakte versjoner av komponentene til dette formålet.
For å gjøre det enklere å ha kompakt modus på en hel løsning tillater vi å sette en attributt data-layout-density="compact"
på <body>
(eller et annet element) slik at alle komponenter inne i dette elementet blir kompakte.
getValuePair()
Noen komponenter, som Select
og RadioButtons
, kan ta inn verdier enten som en streng eller som et ValuePair
-objekt med en value
og et label
. Hjelpefunksjonen getValuePair
konstruerer et ValuePair
fra en string
, for å sikre enkel implementasjon av disse komponentene. Funksjonen sender gjennom ValuePair
-objekter uendret:
import { getValuePair } from "@fremtind/jkl-core";
getValuePair("En verdi");
const value = { label: "En annen verdi", value: "value2" };
getValuePair(value);
Denne er fin å bruke sammen med map()
for å rendre valg:
const choices = ["Valg 1", "Valg 2", "Valg 3"];
return choices.map(getValuePair).map((choice) => (
<option selected={choice.value === selectedValue} value={choice.value}>
choice.label
</option>
));