> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# widget:popover

export const LwTemplate = ({title = "Key questions to get you started", icon = "sparkles", cta = "Powered by Agent Studio", linkHref = "https://lucidworks.com/demo/?utm_source=docs&utm_medium=referral&utm_campaign=docs_cta_ai"}) => {
  const [isLoaded, setIsLoaded] = useState(false);
  useEffect(() => {
    const timer = setTimeout(() => {
      setIsLoaded(true);
    }, 500);
    return () => clearTimeout(timer);
  }, []);
  return <div className="lw-template-container">
      <Card title={title} icon={icon}>
        {isLoaded && <span dangerouslySetInnerHTML={{
    __html: `<lw-template id="a029c1a9-28be-427e-b0e1-5d918920246a"></lw-template
            >`
  }} />}
        <Link href={linkHref} className="agent-studio-link text-left text-gray-600 gap-2 dark:text-gray-400 text-sm font-medium flex flex-row items-center hover:text-primary dark:hover:text-primary-light group-hover:text-primary group-hover:dark:text-primary-light">Powered by Lucidworks Agent Studio</Link>
      </Card>
    </div>;
};

[localhost link]: http://localhost:3000/docs/4/app-studio/reference/tags/lightning.directive.widgetPopover

[mintlify link]: https://doc.lucidworks.com/docs/4/app-studio/reference/tags/lightning.directive.widgetPopover

[old doc.lw link]: https://doc.lucidworks.com/app-studio/4.2/1149

<LwTemplate />

## Description

The popover widget allows the popover content to be displayed in a popup
when the popover trigger is clicked.

## Usage

as element:

```xml wrap  theme={"dark"}
<widget:popover
       [direction="{string}"]
       [mode="{string}"]
       [close-on-click="{string}"]
       [close-on-mouseleave="{string}"]
       [on-close="{function}"]
       [hover-timeout="{number}"]>
</widget:popover>
```

### Directive info

* This directive creates new scope.

#### Parameters

| Param                             | Type         | Details                                                                                                                                                                          |
| --------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| direction  *(optional)*           | **string**   | Where the popover should appear (top, left, right, bottom, bottom-left, bottom-center-left, bottom-center-right). Default: bottom                                                |
| mode  *(optional)*                | **string**   | How the popover should open (hover or click). Default: click                                                                                                                     |
| close-on-click  *(optional)*      | **string**   | Close the popover when the popover is clicked on. Default: false                                                                                                                 |
| close-on-mouseleave  *(optional)* | **string**   | Close the popover when the mouse leaves the element.                                                                                                                             |
| on-close  *(optional)*            | **function** | Function to call when the popover is closed.                                                                                                                                     |
| hover-timeout  *(optional)*       | **number**   | A number to determining the number of milliseconds the popover should be displayed for after the user leaves the popover-trigger. (Only applicable to hover mode.) Default: 1000 |

## Example

#### Source

```xml wrap  expandable  theme={"dark"}
<layout:box>
    <widget:popover direction="bottom" styling="popover-medium">
        <popover-trigger>
            <button styling="button">Bottom</button>
        </popover-trigger>
        <popover-content>
            <h3 id="example_title">Title</h3>
            <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consequuntur cum distinctio dolores enim esse fuga incidunt laboriosam maxime nam odio pariatur provident, quae quam quidem quod saepe voluptas. Maiores, obcaecati.</p>
        </popover-content>
    </widget:popover>
</layout:box>

<layout:box>
    <widget:popover direction="top" styling="popover-small">
        <popover-trigger><button styling="button">Top</button></popover-trigger>
        <popover-content>
            <h3 id="example_title">Title</h3>
            <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consequuntur cum distinctio dolores enim esse fuga incidunt laboriosam maxime nam odio pariatur provident, quae quam quidem quod saepe voluptas. Maiores, obcaecati.</p>
        </popover-content>
    </widget:popover>
</layout:box>
</div>

<layout:box>
    <widget:popover direction="left">
        <popover-trigger><button styling="button">Left</button></popover-trigger>
        <popover-content>
            <h3 id="example_title">Title</h3>
            <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consequuntur cum distinctio dolores enim esse fuga incidunt laboriosam maxime nam odio pariatur provident, quae quam quidem quod saepe voluptas. Maiores, obcaecati.</p>
        </popover-content>
    </widget:popover>
</layout:box>

<layout:box>
    <widget:popover direction="right" styling="popover-large">
        <popover-trigger><button styling="button">Right</button></popover-trigger>
        <popover-content>
            <h3 id="example_title">Title</h3>
            <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consequuntur cum distinctio dolores enim esse fuga incidunt laboriosam maxime nam odio pariatur provident, quae quam quidem quod saepe voluptas. Maiores, obcaecati.</p>
        </popover-content>
    </widget:popover>
</layout:box>

<layout:box>
    <widget:popover mode="hover">
        <popover-trigger><button styling="button">Hover</button></popover-trigger>
        <popover-content>
            <h3 id="example_hover">Hover</h3>
            <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Accusantium aliquam debitis deserunt eum minus molestiae mollitia perspiciatis possimus provident quae. Architecto corporis dicta ea harum odio saepe suscipit, totam ut!</p>
        </popover-content>
    </widget:popover>
</layout:box>
```

#### Result

<img src="https://mintcdn.com/lucidworks/J_LymSfRoWq3UOvg/assets/images/app-studio/as-examples/tags/widgetPopover.png?fit=max&auto=format&n=J_LymSfRoWq3UOvg&q=85&s=218bec0ddd228c08a250338a554467f3" alt="Result" width="1024" height="446" data-path="assets/images/app-studio/as-examples/tags/widgetPopover.png" />