Frivio

Design

FloatingLayer

ny

Headless primitiv: rendrer barn i en portal på document.body, posisjonert ut fra ankerets plassering — med automatisk flip og horisontal klemming.

import { FloatingLayer } from '@/components/ui/FloatingLayer'

Retningslinjer

Bruk

  • Alt som «flyter over annet innhold» og må unngå å klippes av en `overflow`-beholder rundt ankeret — Popover, OverflowMenu, Dropdown, MultiSelect og Tooltip bruker den, direkte eller via Popover.

  • Klikk-utenfor/Escape er IKKE del av primitivet — bruk delt `useKlikkUtenfor` mot både anker- og panel-ref, se demoene under.

Ikke bruk

  • Ikke for sidelengs plassering — kun vertikal flip (over/under) er del av kontrakten.

  • Legg aldri på materiale selv (bakgrunn/kant/skygge/radius) — det er kallstedets `className`.

Eksempler

Vis alt som

Klippes aldri av en overflow-beholder

Beholder med overflow: hidden — som en Card, en tabellrad eller docs sin eksempelboks.

align "start" / "end"

Horisontal ankring mot ankerets venstre- eller høyrekant.

matchWidth

Panelets min-bredde følger ankerets bredde, for et felt-/dropdown-nedtrekk.

Sveip tabellen for å se hele innholdet

Navn
Type
Default
Beskrivelse
open *
boolean
—
Styrer om panelet er montert/synlig.
anchorRef *
RefObject<HTMLElement | null>
—
Elementet panelet ankres mot.
children *
ReactNode
—
Panelinnholdet.
side
'bottom' | 'top' | 'left' | 'right'
'bottom'
Foretrukket side. `top`/`bottom` flippes automatisk til motsatt når det ikke er plass OG motsatt side har mer plass — `left`/`right` flipper aldri (se ikkeBruk).
align
'start' | 'end' | 'center'
'start'
Horisontal ankring mot ankerets bredde.
offset
number
4
Luft mellom anker og panel, i px.
matchWidth
boolean
—
Panelets MIN-bredde settes lik ankerets bredde.
viewportPadding
number
8
Minste avstand til viewportkanten ved horisontal klemming.
className
string
—
Kallstedets EGET materiale — bakgrunn/kant/skygge/radius. FloatingLayer legger kun på posisjon + z-70.
style
CSSProperties
—
Slås sammen med den beregnede posisjonen (top/left/minWidth/visibility) — egne verdier her overstyrer disse.
panelRef
(el: HTMLDivElement | null) => void
—
Callback-ref til panel-DOM-noden — for klikk-utenfor-sjekk (.contains()).
id
string
—
Id på panel-DOM-noden, f.eks. for aria-controls fra triggeren.
role
string
—
ARIA-rolle på panel-DOM-noden, f.eks. "listbox" eller "dialog".
aria-label
string
—
Tilgjengelig navn på panelet.
onAnchorOutOfView
() => void
—
Kalles når ankeret scroller HELT utenfor viewporten mens panelet er åpent — kallstedet setter typisk `open` til usann her, i stedet for å la panelet stå klemt inn i viewporten løsrevet fra ankeret. Popover/Tooltip bruker den; valgfri.

Beslektede