К содержимому
uiify

Popup

Поверхность всплывающего блока, привязанная к его триггеру.

Браузеры
Chrome 114+Firefox 125+Safari 17+
Уровень
0
Сжатый размер
883 B
Лимит принудительной компоновки
0 ms
Лимит axe
0
Совместим с SSR
Да
На основе
elements/popover
Публичный контракт
Тестовый стенд

Песочница

Popup

Preferences

Invite teammate

Manual dismissal

API

PopupTrigger

СвойствоТипПо умолчаниюОписание
target*string—Идентификатор PopupContent, переключаемого этой кнопкой; браузер обеспечивает переключение, закрытие по щелчку снаружи и Escape без гидратации.
childrenReactNode—Содержимое кнопки триггера.
asTAs & NativeButtonAs<TAs>"button"Компонент, передающий свойства и ref нативной кнопке; другие теги отклоняются, поскольку командам invoker нужна настоящая кнопка.

PopupContent

СвойствоТипПо умолчаниюОписание
id*string—Уникальный идентификатор, заданный потребителем; на него ссылаются триггер и закрытие.
side"top" | "right" | "bottom" | "left""bottom"Сторона триггера, к которой привязана поверхность.
align"start" | "center" | "end""center"Выравнивание поверхности вдоль выбранной стороны.
mode"auto" | "manual""auto"Поведение всплывающего блока: «auto» закрывается по щелчку снаружи и Escape, «manual» остаётся открытым до команды закрытия.
childrenReactNode—Содержимое поверхности всплывающего блока.

PopupClose

СвойствоТипПо умолчаниюОписание
target*string—Идентификатор PopupContent, скрываемого этой кнопкой.
childrenReactNode—Содержимое кнопки закрытия.
asTAs & NativeButtonAs<TAs>"button"Компонент, передающий свойства и ref нативной кнопке; другие теги отклоняются, поскольку командам invoker нужна настоящая кнопка.

Popup.Root (legacy compound)

СвойствоТипПо умолчаниюОписание
id*string—Стабильный идентификатор поверхности всплывающего блока и команд invoker, передаваемый прямым дочерним Trigger, Content и Close.
mode"auto" | "manual" | "hint""auto"Поведение всплывающего блока, передаваемое поверхности Content.
classNamestring—Класс оборачивающего элемента.
childrenReactNode—Части Trigger, Content и Close.

Popup.Trigger (legacy compound)

СвойствоТипПо умолчаниюОписание
classNamestring—Класс кнопки триггера.
childrenReactNode—Содержимое кнопки триггера.

Popup.Content (legacy compound)

СвойствоТипПо умолчаниюОписание
side"top" | "right" | "bottom" | "left""bottom"Сторона триггера, к которой привязана поверхность.
align"start" | "center" | "end""center"Выравнивание поверхности вдоль выбранной стороны.
classNamestring—Класс поверхности всплывающего блока.
childrenReactNode—Содержимое поверхности всплывающего блока.

Popup.Close (legacy compound)

СвойствоТипПо умолчаниюОписание
classNamestring—Класс кнопки закрытия.
childrenReactNode—Содержимое кнопки закрытия.

Клавиатура

КлавишаДействие
EscapeЗакрыть
TabПерейти в содержимое открытого всплывающего блока

Доступность

Нативный Popover API: триггер popovertarget открывает или закрывает поверхность до выполнения JavaScript; браузер обеспечивает закрытие по щелчку снаружи, Escape и вложенность, а также привязывает поверхность к открывшему её триггеру.

Привязка стилей

data-sidedata-aligndata-positioningdata-uiify-popupdata-part="trigger|content|close"--uiify-trigger-open (inside [data-uiify-popup][data-part="root"])