V2 er på vei – slik forbereder du deg
I v2 utvider vi fargesystemet og bygger i enda større grad på webstandarder.

Da @digdir/designsystemet-web ble lansert i februar, tok designsystemet.no et viktig steg mot visjonen vår:
å tilby små, robuste byggeklosser basert på webstandarder, som er enkle for alle å bruke og bygge videre på.
V2 fortsetter i samme retning. Vi utvider fargesystemet og fjerner gamle løsninger til fordel for webstandarder.
Nyheter i v2
Ny Figma-plugin
Lenge har vi vært avhengige av en tredjepartsløsning for å importere temaer i Figma. Nå lager vi vår egen plugin, som forenkler prosessen og gir oss full kontroll over importen. Da blir det lettere for dere å håndtere temaet deres i Figma.
Nye farger
Det har lenge vært en liten utfordring å få nøytrale farger til å harmonere med basefargen i en fargeskala.
Input henter for eksempel farger fra neutral når feltet er skrivebeskyttet.
Derfor får hver fargeskala tre nye farger: surface-muted, border-muted og text-muted.
Da blir det lettere å få et nøytralt uttrykk som harmonerer med fargeskalaen, uten at komponentene må hente farger fra en annen skala.
Og mye mer
I tillegg kommer mange forbedringer i temabyggeren og CLI-en.
Slik forbereder du koden
Vi vet at breaking changes tar tid å håndtere, og det er viktig for oss at overgangen blir smidig. Slik kan du gjøre deg klar allerede nå:
- Oppgrader til siste 1.x-versjon av alle
@digdir/designsystemet*-pakkene. - Se etter advarsler: TypeScript markerer utgåtte props og eksporter i editoren, React- og web-pakken skriver advarsler i konsollen, og CLI-en skriver advarsler i terminalen.
- Bytt ut utgått kode: Alt i listene under er allerede markert som
@deprecatedi v1, og erstatningene virker allerede. Du kan altså bytte nå, uten å vente på v2.
Endringer for alle
| Komponent | Ikke bruk | Bruk (virker allerede i v1) | Merk |
|---|---|---|---|
| ToggleGroup | data-toggle-group="LABEL" | focusgroup="radiogroup" aria-label="LABEL" | Virker også uten endring, men skjermlesere leser ikke opp navnet på gruppen |
| Spinner | <svg class="ds-spinner"> | <progress class="ds-spinner">og <button aria-busy="true"> | CSS tegner spinneren automatisk |
| Enkeltstående CSS-filer | De gamle navnene togglegroup.css og skiplink.css | De nye navnene toggle-group.css og skip-link.css | De nye filnavnene har vært tilgjengelige og anbefalt lenge |
| Search | Fjernes | Les blogginnlegget om hvorfor Search fjernes, og hva du kan bruke i stedet |
Endringer kun for React
| Komponent | Ikke bruk | Bruk (virker allerede i v1) | Merk |
|---|---|---|---|
| Typer | Den gamle importen @digdir/designsystemet-react/colors | Den nye importen @digdir/designsystemet-types | Den nye importen har vært tilgjengelig og anbefalt lenge |
| ToggleGroup.Item | data-variant og icon | Ikke style etter data-variant, og legg ikonet direkte i ToggleGroup.Item | |
| RovingFocus | RovingFocusRoot og RovingFocusItem | focusgroup | |
| Hjelpefunksjoner | useDebounceCallback, useSynchronizedAnimation, useIsomorphicLayoutEffect, useMediaQuery, omit, MergeRight | Kopier koden inn i prosjektet ditt ved behov. Trykk på en funksjon for å se koden. |
useDebounceCallback
import { useEffect, useRef } from "react";
type DebounceFunction<T> = (...args: T[]) => void;
export function useDebounceCallback<T>(
callback: DebounceFunction<T>,
delay = 50,
) {
const timeoutRef = useRef<number | null>(null);
useEffect(() => {
// Cleanup the previous timeout on re-render
return () => {
if (timeoutRef.current) {
clearTimeout(timeoutRef.current);
}
};
}, []);
const debouncedCallback = (...args: T[]) => {
if (timeoutRef.current) {
clearTimeout(timeoutRef.current);
}
timeoutRef.current = window.setTimeout(() => {
callback(...args);
}, delay);
};
return debouncedCallback;
}
useSynchronizedAnimation
// Inspired by Sam Selikoff
// https://github.com/samselikoff/2022-02-24-use-synchronized-animation/blob/main/src/App.js
import { useEffect, useLayoutEffect, useRef } from "react";
/**
* Synchronizes the css animation of multiple elements with the same `animationName`.
*
* @example
* const ref = useSynchronizedAnimation<HTMLDivElement>('spin');
*
* <div ref={ref} />
*/
export function useSynchronizedAnimation<T>(animationName: string) {
const ref = useRef<T>(null);
const useHook = typeof window === "undefined" ? useEffect : useLayoutEffect;
useHook(() => {
const animations = document
.getAnimations()
.filter(
(animation) =>
"animationName" in animation &&
animation.animationName === animationName,
);
const firstOfType = animations.find(
(animation) =>
"animationName" in animation &&
animation.animationName === animationName,
);
const myAnimation = animations.find(
(animation) =>
(animation.effect as KeyframeEffect)?.target === ref.current,
);
if (myAnimation && myAnimation === firstOfType) {
myAnimation.currentTime = 0;
}
if (
myAnimation &&
firstOfType?.currentTime &&
myAnimation !== firstOfType
) {
myAnimation.currentTime = firstOfType.currentTime;
}
return () => {
if (myAnimation && firstOfType?.currentTime) {
myAnimation.currentTime = firstOfType.currentTime;
}
};
}, [animationName]);
return ref;
}
useIsomorphicLayoutEffect
import { useEffect, useLayoutEffect } from "react";
export const useIsomorphicLayoutEffect =
typeof window === "undefined" ? useEffect : useLayoutEffect;
useMediaQuery
import { useEffect, useLayoutEffect, useState } from "react";
type UseMediaQueryOptions = {
defaultValue?: boolean;
initializeWithValue?: boolean;
};
export function useMediaQuery(
query: string,
{
defaultValue = false,
initializeWithValue = true,
}: UseMediaQueryOptions = {},
): boolean {
const useHook = typeof window === "undefined" ? useEffect : useLayoutEffect;
const onChange = () => setMatches(getMatches(query));
const getMatches = (query: string): boolean => {
if (typeof window === "undefined") return defaultValue;
return window.matchMedia(query).matches;
};
const [matches, setMatches] = useState<boolean>(() => {
return initializeWithValue ? getMatches(query) : defaultValue;
});
useHook(() => {
const matchMedia = window.matchMedia(query);
onChange(); // Triggered at the first client-side load and if query changes
// Use deprecated `addListener` and `removeListener` to support Safari < 14
if (matchMedia.addListener) matchMedia.addListener(onChange);
else matchMedia.addEventListener("change", onChange);
return () => {
if (matchMedia.removeListener) matchMedia.removeListener(onChange);
else matchMedia.removeEventListener("change", onChange);
};
}, [query]);
return matches;
}
omit
type UnknownRecord = Record<string | number | symbol, unknown>;
/**
* Returns a partial copy of an object omitting the keys specified.
* @example omit(['a', 'd'], {a: 1, b: 2, c: 3, d: 4}); //=> {b: 2, c: 3}
*/
export const omit = (names: string[], obj: UnknownRecord): object => {
const result: UnknownRecord = {};
const index: UnknownRecord = {};
let idx = 0;
const len = names.length;
while (idx < len) {
index[names[idx]] = 1;
idx += 1;
}
for (const prop in obj)
if (!Object.hasOwn(index, prop)) result[prop] = obj[prop];
return result;
};
MergeRight
/**
* Create a new type with the properties of the first type merged with the properties of the second type.
* If a key exists in both types, the property from the *second* type will be used.
*/
export type MergeRight<T1, T2> = Omit<T1, keyof T2> & T2;
Endringer i CLI-en
- Bruk en konfigurasjonsfil i stedet for parameterne
--main-colors,--support-colors,--neutral-color,--font-family,--border-radiusog--theme. - Importer typer fra
@digdir/designsystemet-typesi stedet for@digdir/designsystemet/types.
Hva med Suggestion?
Suggestion har lenge vært markert som eksperimentell. Det er den mest komplekse komponenten i designsystemet.no, og de mange måtene dere bruker den på, har gitt oss mange gode tilbakemeldinger om hva den bør støtte, og hva den kan løse bedre. Vi jobber nå med å forbedre komponenten før vi gjør den stabil.
Spørsmål?
Ta kontakt med oss på Slack eller opprett en sak på GitHub (github.com) hvis du står fast eller mener vi har glemt noe.