Ir para o conteúdo
uiify

Popup

Superfície de janela flutuante ancorada ao acionador.

Navegadores
Chrome 114+Firefox 125+Safari 17+
Nível
0
Tamanho compactado
883 B
Limite de layout forçado
0 ms
Limite do axe
0
Compatível com SSR
Sim
Construído sobre
elements/popover
Contrato publicado
Ambiente de teste

Experimentar

Popup

Preferences

Invite teammate

Manual dismissal

API

PopupTrigger

PropTipoPadrãoDescrição
target*string—Id do PopupContent alternado por este botão; o navegador trata alternância, fechamento ao clicar fora e Escape sem hidratação.
childrenReactNode—Conteúdo do botão acionador.
asTAs & NativeButtonAs<TAs>"button"Componente que encaminha props e ref a um botão nativo; outras tags são rejeitadas, pois comandos de invocador exigem um botão real.

PopupContent

PropTipoPadrãoDescrição
id*string—Id único fornecido pelo consumidor; referenciado pelo acionador e pelo controle de fechamento.
side"top" | "right" | "bottom" | "left""bottom"Lado do acionador ao qual a superfície é ancorada.
align"start" | "center" | "end""center"Alinhamento da superfície ao longo do lado escolhido.
mode"auto" | "manual""auto"Comportamento da janela flutuante: "auto" fecha ao clicar fora e com Escape; "manual" permanece aberta até um invocador de fechamento ocultá-la.
childrenReactNode—Conteúdo da superfície da janela flutuante.

PopupClose

PropTipoPadrãoDescrição
target*string—Id do PopupContent ocultado por este botão.
childrenReactNode—Conteúdo do botão de fechar.
asTAs & NativeButtonAs<TAs>"button"Componente que encaminha props e ref a um botão nativo; outras tags são rejeitadas, pois comandos de invocador exigem um botão real.

Popup.Root (legacy compound)

PropTipoPadrãoDescrição
id*string—Id estável da superfície da janela flutuante e dos comandos de invocador, injetado nos filhos diretos Trigger, Content e Close.
mode"auto" | "manual" | "hint""auto"Comportamento da janela flutuante passado à superfície Content.
classNamestring—Classe aplicada ao elemento envolvente.
childrenReactNode—As partes Trigger, Content e Close.

Popup.Trigger (legacy compound)

PropTipoPadrãoDescrição
classNamestring—Classe aplicada ao botão acionador.
childrenReactNode—Conteúdo do botão acionador.

Popup.Content (legacy compound)

PropTipoPadrãoDescrição
side"top" | "right" | "bottom" | "left""bottom"Lado do acionador ao qual a superfície é ancorada.
align"start" | "center" | "end""center"Alinhamento da superfície ao longo do lado escolhido.
classNamestring—Classe aplicada à superfície da janela flutuante.
childrenReactNode—Conteúdo da superfície da janela flutuante.

Popup.Close (legacy compound)

PropTipoPadrãoDescrição
classNamestring—Classe aplicada ao botão de fechar.
childrenReactNode—Conteúdo do botão de fechar.

Teclado

TeclaAção
EscapeFeche
TabMova o foco para o conteúdo da janela flutuante quando aberta

Acessibilidade

Popover API nativa: um invocador popovertarget alterna a superfície antes de qualquer JavaScript; o navegador controla fechamento ao clicar fora, Escape e aninhamento e ancora a superfície ao invocador que a abriu.

Pontos de integração de estilos

data-sidedata-aligndata-positioningdata-uiify-popupdata-part="trigger|content|close"--uiify-trigger-open (inside [data-uiify-popup][data-part="root"])
Esta página foi traduzida automaticamente e ainda não foi revisada.