Komponenter
Skeleton
Skeleton brukes til å gi brukeren en midlertidig visuell tilbakemelding mens innholdet lastes eller behandles. Den er en enkel og minimalistisk versjon av det faktiske innholdet som skal vises.
Egnet til:
- Minske oppfattet lastetid
- Minske layout-shift ved flere elementer
Uegnet til:
- Ved lengre lastetider uten ytterligere informasjon
Eksempler
<> {loaded ? ( <span>Loaded</span> ) : ( <div className="w-48"> <Skeleton variant="circle" width={80} height={80} /> <Heading as={Skeleton} size="large"> Card-title </Heading> <Skeleton variant="text" width="100%" /> <Skeleton variant="text" width="100%" /> <Skeleton variant="text" width="80%" /> </div> )}</>
Retningslinjer
Skeleton brukes for å kommunisere til brukerne at innholdet lastes. Fordelen med Skeleton sammenliknet med Loader er at du kan forme Skeleton-elementene helt likt innholdet som vil vises. Brukeren får et hint om hva som kommer og grensesnittet vil være (nesten) uendret når innholdet er klart.
Antall elementer
Hvis skeleton brukes for å representere et ukjent antall elementer, f.eks. kort i en liste eller søketreff bør man som tommelfingerregel alltid vise eksakt antall eller et mindre antall skeletons. Det kan oppleves som at noe gikk galt hvis et element som var der tidligere, ikke er der når alt er lastet.
Ventetid
Om bruker må vente på innholdet vil Skeleton bidra til at ventingen oppleves kortere. Men det tar ikke lang tid før folk blir utålmodig og/eller forvirra over at ingenting skjer. Når du bruker Skeleton må ikke ventetiden for brukerne overstige 9 sekunder. Om ventetiden er lenger enn det bør bruker se en forklaring, eller vis en fremdriftsindikator og tekst som forklarer hva maskinen jobber med.
Når bør man ikke bruke skeleton?
Skeleton har som formål å representere hva som faktisk vil vises når alt er lastet. Dette kan være problematisk hvis man bruker komponenten i f.eks. søk med ukjent antall treff. Hvis bruker ser flere "resultater" representert med skeleton, men får 0 søketreff når alt er lastet kan dette tolkes som at noe gikk feil. I disse tilfellene vil Loader ofte være et bedre alternativ.
Tilgjengelighet
Komponenten setter både visiblity: none
, aria-hidden
og pointer-events: none
på elementet. Skjermlesere vil derfor ikke vite at noe lastes. Vurder om det er nødvendig å legge til aria-live
-regioner med informasjon til skjermlesere. En alternativ løsning kan være å legge seksjonen med Skeleton i en section
med aria-label
.
Ved lengre lastetider, eller hvis noe har gått galt bør bruker gjøres oppmerksom på dette.
Props
Skeleton
variant?
- Type:
"circle" | "rectangle" | "rounded" | "text"
- Default:
"text"
height?
- Type:
string | number
- Description:
When not inferring height from children, you must specify height
width?
- Type:
string | number
- Description:
When not inferring width from children, you must specify width
as?
- Type:
"div" | "span"
- Default:
""div""
- Description:
Overrides html-tag
className?
- Type:
string
data-color?
- Type:
(string & {}) | AkselColor
ref?
- Type:
LegacyRef<HTMLDivElement>
- Description:
Allows getting a ref to the component instance. Once the component unmounts, React will set
ref.current
tonull
(or call the ref withnull
if you passed a callback ref). React Docs
Tokens
Opacity er brukt som teknikk for 'pulse'-animasjonen, derfor kan bare bakgrunnsfarge endres på.
Deprecation warning: I det nye systemet for theming og darkmode, er komponent-tokens fjernet. Mer dokumentasjon for dette kommer, midlertidig dokumentasjon finner du her.
Token | Fallback |
---|---|
--ac-skeleton-bg | --a-surface-neutral-moderate |