asPortal

Boolean

• true (default)

• false

Se verdadeiro, o elemento é criado como um portal, fora do app root e dentro do body.

children

ReactNode

Conteúdo a ser renderizado inicialmente. Este elemento é hoverable, isto é, ao receber a ação de hover, o elemento flutuante (propriedade content) é exibido.

content

ReactNode

Elemento flutuante cuja visibilidade é controlada pela prop open.

open

Boolean

• true

• false (default)

Controla o estado do Popover. Quando falso, o elemento flutuante (propriedade content) não fica visível, apenas o elemento de referência (propriedade children). Quando verdadeiro, ambos elemento flutuante e elemento de referência ficam visíveis.

role

PopoverRole

• alertdialog

• dialog (default)

• grid

• listbox

• menu

• tooltip

• tree

Define o propósito do popover em termos de acessibilidade.

dismissProps

PopoverDismiss

Define o comportamento de dismiss uma vez que o elemento flutuante (proriedade content) esteja visível.

placement

PopoverPlacement

• auto

• top

• right

• bottom (default)

• left

• top-start

• top-end

• right-start

• right-end

• bottom-start

• bottom-end

• left-start

• left-end

Define a posição que o elemento flutuante (propriedade content) irá aparecer quando open === true.

positionStrategy

PopoverPositionStrategy

• fixed

• absolute (default)

Define a propriedade position do CSS a ser utilizada.

offset

number

Define o valor de offset entre o elemento flutuante (propriedade content) e o elemento de referência (children). Este valor deve ser baseado nos nossos tokens de spacing.

matchReferenceSize

Boolean

• true

• false

Se for verdadeiro, o elemento flutuante (propriedade content) terá o mesmo width do elemento de referência (propridade children).

returnFocus

Boolean

• true (default)

• false

Se for verdadeiro, o focus do navegador retornará para o elemento anteriormente focado na ação de dismiss do Popover.

isAutoUpdate

Boolean

• true

• false (default)

Se for verdadeiro, adiciona listeners que chamam automaticamente uma função de atualização quando necessário para que o elemento flutuante (propriedade content) permaneça ancorado ao elemento de referência (propriedade children) em uma variedade de cenários sem desanexar.

isModal

Boolean

• true (default)

• false

Se for verdadeiro, o focus é travado apenas dentro do elemento flutuante (propriedade content), e conteúdos fora do elemento flutuante não podem ser acessados. Isso inclui cursores virtuais de leitores de tela.

customProps

{ arrow?: ComponentPropsWithoutRef<"div"> & { css?: CSS } }

Adiciona custom props aos elementos filhos.

onDismiss

function

Método acionado quando um dos comportamentos dismissive é identificado.