Komponenter
Avatar
Avatar viser et bilde, initialer eller ikon for en person, enhet eller profil.
Trykk Enter for å redigere
Unable to parse html
const Preview = () => <Avatar aria-label='Ola Nordmann' />; render(<Preview />)
Bruk avatar når
- en person eller enhet skal representeres
Unngå avatar når
- noe annet enn en person eller enhet skal representeres, for eksempel et dokument. Bruk heller ikoner eller andre visuelle symboler
- det brukes rent visuelt, uten funksjon eller mening
Eksempel
Størrelser
I tillegg til sm, md og lg, støtter avatar også størrelsen xs.
Trykk Enter for å redigere
Unable to parse html
const Sizes = () => ( <> <Avatar data-size='xs' aria-label='extra small'> xs </Avatar> <Avatar data-size='sm' aria-label='small'> sm </Avatar> <Avatar data-size='md' aria-label='medium'> md </Avatar> <Avatar data-size='lg' aria-label='large'> lg </Avatar> </> ); render(<Sizes />)
Farger
Avatar kommer i alle farger i ditt tema.
Trykk Enter for å redigere
Unable to parse html
const ColorVariants = () => { const colors = ['neutral', 'accent']; return ( <> {colors.map((color) => ( <Avatar key={color} data-color={color as AvatarProps['data-color']} aria-label={`color ${color}`} /> ))} </> ); }; render(<ColorVariants />)
Varianter
Avatar kan endre radius, men velg én konsekvent versjon i hele løsningen.
Trykk Enter for å redigere
Unable to parse html
const Radius = () => ( <> <Avatar aria-label='radius default' /> <Avatar aria-label='radius 1rem' style={ { '--dsc-avatar-radius': '1rem', } as React.CSSProperties } /> <Avatar aria-label='radius lg' style={ { '--dsc-avatar-radius': 'var(--ds-border-radius-lg)', } as React.CSSProperties } > ON </Avatar> <Avatar aria-label='radius none' style={ { '--dsc-avatar-radius': '0', } as React.CSSProperties } > ON </Avatar> </> ); render(<Radius />)
Med bilde eller ikon
Avatar kan bruke bilde eller ikon som innhold.
Trykk Enter for å redigere
Unable to parse html
const WithImageAndIcon = () => ( <> <Avatar aria-label='Ola Nordmann'> <img src='/img/component-docs/cats/cat1.webp' alt='' /> </Avatar> <Avatar aria-label='Ola Nordmann'> <BriefcaseIcon /> </Avatar> </> ); render(<WithImageAndIcon />)
Kombinasjoner
Avatar kan settes sammen med andre komponenter.
Trykk Enter for å redigere
Unable to parse html
const InDropdown = () => ( <> <Button popovertarget='dropdown' variant='tertiary'> <Avatar aria-hidden='true' data-size='sm'> ON </Avatar> Ola Nordmann </Button> <Dropdown id='dropdown' placement='bottom-end' autoPlacement={false}> <Dropdown.List> <Dropdown.Item> <Dropdown.Button> <Badge.Position overlap='circle'> <Badge data-color='danger' data-size='sm'></Badge> <Avatar aria-hidden='true' data-size='xs'> ON </Avatar> </Badge.Position> Ola Nordmann </Dropdown.Button> </Dropdown.Item> <Dropdown.Item> <Dropdown.Button> <Avatar aria-hidden='true' data-size='xs'> <BriefcaseIcon /> </Avatar> Sogndal kommune </Dropdown.Button> </Dropdown.Item> </Dropdown.List> </Dropdown> </> ); render(<InDropdown />)
Retningslinjer
Avatar skal bidra til å gjøre brukergrensesnittet mer gjenkjennelig og lett å navigere i, uten å forstyrre eller ta for mye plass.
- Bruk samme form på avataren på en konsekvent måte i hele løsningen.
- Avataren bør som regel kombineres med tekst, med mindre det er helt åpenbart hvem eller hva avataren representerer.
- Bruk avatar kun når det faktisk gir verdi for brukeropplevelsen, for eksempel å vise hvem som har skrevet noe, eller hvem som er ansvarlig.
Tekst
Avatar skal som hovedregel ikke inneholde tekst i selve komponenten, med unntak av når initialer brukes. Annen tekst, for eksempel fullt navn, rolle eller organisasjon, bør vises utenfor avataren for å sikre god lesbarhet.
Rediger denne siden på github.com (åpnes i ny fane)