For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/components/popover.md.
v0.0.57
  • English
  • Popover

    Data Display@rockshin/tao-ui

    Displays a floating card with rich content anchored to a trigger element, opened by click or hover.

    When to use

    Use Popover for rich, non-blocking contextual content behind a click or hover. Use Tooltip for short text-only hints and Modal for blocking interactions.

    Recommended

    • Keep the title to one short line; put detail in the content.
    • Use the default hover trigger for read-only previews and trigger="click" for interactive content.
    • Keep popup content compact; link out for long-form detail.

    Avoid

    • Do not nest essential workflows inside a hover-only popover.
    • Do not chain popovers from inside another popover.

    Examples

    Basic usage

    TSX

    Hover, focus, and click

    TSX

    Placement and arrow

    TSX

    Controlled popup and internal dismissal

    An action inside the popup can update open and dismiss it after completion.

    TSX

    Focus trigger

    Use trigger=focus for keyboard hints and keep essential instructions visible on the page.

    TSX

    Arrow and delay

    Hover delays use seconds, and arrow controls the pointer.

    TSX

    Form content

    A popup can contain input and actions; submit, report the result, and close it.

    Workspace
    TSX

    API

    Popover

    PropertyDescriptionTypeDefault Value
    titleHeader content of the popup.PopoverRender-
    contentBody content of the popup.PopoverRender-
    triggerHow the popup opens. Defaults to 'hover'.PopoverTrigger | PopoverTrigger[] | undefinedhover
    placementPopup position relative to the trigger. Defaults to 'top'.PopoverPlacement | undefinedtop
    mouseEnterDelayHover delay in seconds before opening. Defaults to 0.1.number | undefined0.1
    mouseLeaveDelayHover delay in seconds before closing. Defaults to 0.1.number | undefined0.1
    arrowShow a pointing arrow on the popup. Defaults to true.boolean | { pointAtCenter?: boolean | undefined; } | undefinedtrue
    destroyOnHiddenUnmount the popup content while closed. Defaults to false.boolean | undefined-
    destroyTooltipOnHide@deprecated Use destroyOnHidden instead.boolean | undefined-
    classNameMerged onto the popup root.string | undefined-
    styleAdditional styleCSSProperties | undefined-
    childrenExactly one trigger element.ReactNode (Required)-