Komponenter
Avatar
Avatar viser et bilde, initialer eller ikon for en person, enhet eller profil.
React
const Preview = () => ( <Avatar aria-label='Ola Nordmann' variant='circle' /> ); 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.
React
const Sizes = () => ( <> <Avatar data-size='xs' aria-label='extra small' initials='xs' /> <Avatar data-size='sm' aria-label='small' initials='sm' /> <Avatar data-size='md' aria-label='medium' initials='md' /> <Avatar data-size='lg' aria-label='large' initials='lg' /> </> ); render(<Sizes />)
Farger
Avatar kommer i alle farger i ditt tema.
React
const ColorVariants = () => { const colors = ['neutral', 'accent', 'brand1', 'brand2', 'brand3']; return ( <> {colors.map((color) => ( <Avatar key={color} data-color={color as AvatarProps['data-color']} aria-label={`color ${color}`} /> ))} </> ); }; render(<ColorVariants />)
Varianter
Avatar kan være rund eller kvadratisk. Bruk dem konsekvent i hele løsningen.
React
const ShapeVariants = () => ( <> <Avatar variant='circle' aria-label='variant circle' /> <Avatar variant='square' aria-label='variant square' /> <Avatar variant='circle' aria-label='Ola Nordmann'> ON </Avatar> <Avatar variant='square' aria-label='Ola Nordmann'> ON </Avatar> </> ); render(<ShapeVariants />)
Med bilde eller ikon
Avatar kan bruke bilde eller ikon som innhold.
React
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.
React
const InDropdown = () => ( <Dropdown.TriggerContext> <Dropdown.Trigger variant='tertiary'> <Avatar aria-hidden='true' data-size='sm'> ON </Avatar> Ola Nordmann </Dropdown.Trigger> <Dropdown placement='bottom-end' autoPlacement={false} data-size='md'> <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> </Dropdown.TriggerContext> ); 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.