Intro
Popover er et skjult panel koblet til et element. Popoveren vil legge seg over alle andre elementer i grensesnittet. Du styrer selv når og hvordan den skal vises og skjules.
Eksempler
Popover kan kobles til de fleste typer elementer med bruk av ref.
Her kan du teste ulike 'placement'-verdier. Legg merke til at Popover overstyrer valget hvis hvis det ikke er plass i den retningen.
Komponenten brukes i
Varianter
Plassering
Popover kan plasseres top, right, bottom og left relatert til elementet. Disse orienteringene har også muligheten til å definere start/end, for eksempel top-end. Se "placement"-eksempelet for en demonstrasjon.
Popover styrer selv plassering hvis den ikke har plass i ønsket retning. Dette kan overstyres ved å sette prop flip
til false
.
Arrow
Popover kan brukes med eller uten pil.
Offset
Offset er avstanden mellom elementet og popoveren, og kan overstyres.
Padding
Selve Popover-komponenten har ingen padding, men du kan bruke utility-komponenten Popover.Content
som legger på 16px padding.
Tilgjengelighet
Elementet som åpner popoveren bør bruke aria-expanded=true/false
for å indikere om den er åpen eller ikke.
Interaksjon med skjermleser
Popoveren bør helst ligge rett etter elementet som åpner den i DOM-en.
Props
Popover benytter seg av Floating UI.
Popover
children
- Type:
ReactNode
- Description:
anchorEl
- Type:
Element | null
- Description:
open
- Type:
boolean
- Description:
onClose
- Type:
() => void
- Description:
placement?
- Type:
"top" | "bottom" | "right" | "left" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "right-start" | "right-end" | "left-start" | "left-end"
- Default:"top"
- Description:
arrow?
- Type:
boolean
- Default:true
- Description:
offset?
- Type:
number
- Default:16 w/arrow, 4 w/no-arrow
- Description:
strategy?
- Type:
"absolute" | "fixed"
- Default:"absolute"
- Description:
flip?
- Type:
boolean
- Default:true
- Description:
className?
- Type:
string
ref?
- Type:
LegacyRef<HTMLDivElement>
- Description:
Popover.Content
className?
- Type:
string
ref?
- Type:
LegacyRef<HTMLDivElement>
- Description:
Tokens
Token | Fallback |
---|---|
--ac-popover-bg | --a-surface-default |
--ac-popover-border | --a-border-default |