Getting StartedInstallation and setup guides 6
AIAI chat models, streaming, and history 1
FormInput and selection components 27
FlowWorkflow graph and execution surfaces 4
LayoutStructural layout components 9
NavigationMenu surfaces and hierarchical actions 7
OverlayModal and floating layer surfaces 3
FeedbackStatus, empty, progress, and loading placeholder patterns 6
UtilityGeneral-purpose interface utilities 7

API reference

Component popover uses the styled <tng-popover> wrapper and sits on top of the same primitive contract documented on the separate headless popover page.

Wrapper component: <tng-popover>

ElementInput / OutputTypeDescription
<tng-popover>open, openChangeboolean Controlled popover state. Leave open undefined for uncontrolled mode.
<tng-popover>defaultOpenbooleanInitial open state when uncontrolled.
[tngPopoverTriggerFor]Popover referenceTngPopoverComponent Links a native button, tng-button, or trigger-target component to the detached panel.
<tng-popover>disabledbooleanPrevents opening from trigger interactions.
<tng-popover>closeOnEscape, closeOnOutsidePointerbooleanDismiss policy for keyboard escape and outside pointer interactions.
<tng-popover>closeOnFocusOutsideboolean Closes when focus enters an element outside the trigger, panel, and owned nested overlays. Defaults to false.
<tng-popover>restoreFocusbooleanRestores focus to trigger/previous element after close.
<tng-popover>autoFocusboolean | 'first-focusable' | 'panel' | 'none' Controls what receives focus when the panel opens. true maps to 'first-focusable'; false maps to 'none'.
<tng-popover>side, align'top' | 'right' | 'bottom' | 'left', 'start' | 'center' | 'end' Requested anchored placement. The resolved placement is exposed via data-side and data-align.
<tng-popover>offset, collisionPaddingnumber Controls trigger distance and minimum viewport clearance while flipping and shifting.
<tng-popover>panelRole, panelAriaLabel, panelAriaLabelledby, ariaHasPopup'dialog' | 'menu' | 'listbox' | 'region' | 'none', stringARIA contract for panel semantics and the linked trigger.
<tng-popover>closed'escape' | 'focus-outside' | 'outside-pointer' | 'programmatic' | 'trigger-toggle'Close reason payload for analytics and flow state tracking.

Primitive directives

DirectivePurposeKey inputs / outputs
tngPopover Root state machine for open/close, dismissal, placement, and accessibility wiring. open, defaultOpen, closeOnEscape, closeOnFocusOutside, closeOnOutsidePointer, autoFocus, side, align, openChange, closed
tngPopoverTriggerBinds trigger element to a popover instance and toggles open/close on click.[tngPopoverTrigger] (optional explicit popover instance)
tngPopoverPanel / tngPopoverContentPanel surface with generated id, role, hidden state, and slot attributes.Reads state from root; no separate inputs required.
tngPopoverClose Closes the popover when clicked and emits reason through root closed. [tngPopoverClose] close reason (optional)

Keyboard contract (high level)

  • Enter/Space on a button trigger toggles the popover panel.
  • Escape closes when closeOnEscape is enabled.
  • Outside pointer interactions close when closeOnOutsidePointer is enabled and target is outside the popover root.
  • Focus leaving the complete owned overlay tree closes only when closeOnFocusOutside is enabled.
  • Focus restore after close is controlled by restoreFocus.
  • Popover does not trap focus by default; Tab can move outside the panel.