Popovers

Documentation and examples for adding Bootstrap popovers, like those found in iOS, to any element on your site.

Overview

  • Zero-length title and content attributes will never show a popover.
  • Triggering popovers on hidden elements will not work.
  • Popovers for disabled elements must be triggered on a wrapper element.
  • When triggered from anchors that wrap across multiple lines, popovers will be centered between the anchors' overall width. Use textNowrap on your b-a components to avoid this behavior.
  • Popovers must be hidden before their corresponding elements have been removed from the DOM.
  • Popovers can be triggered thanks to an element inside a shadow DOM.

Example

vue
<template>
 <b-button
  color="danger"
  size="lg"
  toggle="popover"
  title="Popover title"
  content="And here's some amazing content. It's very engaging. Right?"
 >
  Click to toggle popover
 </b-button>
</template>

Four directions

Four options are available: top, right, bottom, and left aligned. Directions are mirrored when using Bootstrap in RTL.

vue
<template>
 <b-button
  color="secondary"
  toggle="popover"
  placement="top"
  content="Top popover"
 >
  Popover on top
 </b-button>
 <b-button
  color="secondary"
  toggle="popover"
  placement="right"
  content="Right popover"
 >
  Popover on right
 </b-button>
 <b-button
  color="secondary"
  toggle="popover"
  placement="bottom"
  content="Bottom popover"
 >
  Popover on bottom
 </b-button>
 <b-button
  color="secondary"
  toggle="popover"
  placement="left"
  content="Left popover"
 >
  Popover on left
 </b-button>
</template>

Dismiss on next click

Use the focus trigger to dismiss popovers on the user's next click of a different element than the toggle element.

Dismissible popover
vue
<template>
 <Anchor
  tabindex="0"
  size="lg"
  button
  color="secondary"
  toggle="popover"
  placement="left"
  trigger="focus"
  title="Dismissible popover"
  content="And here's some amazing content. It's very engaging. Right?"
 >
  Dismissible popover
 </Anchor>
</template>

Disabled elements

Elements with the disabled attribute aren't interactive, meaning users cannot hover or click them to trigger a popover (or tooltip). As a workaround, you'll want to trigger the popover from a wrapper b-div component or span tag, ideally made keyboard-focusable using tabindex="0".

For disabled popover triggers, you may also prefer trigger="hover focus" so that the popover appears as immediate visual feedback to your users as they may not expect to _click_ on a disabled element.

vue
<template>
 <b-button
  button
  color="danger"
  size="lg"
  toggle="popover"
  trigger="hover focus"
  content="Disabled popover"
 >
  Click to toggle popover
 </b-button>

 <span
  class="d-inline-block"
  tabindex="0"
  toggle="popover"
  data-b-s-trigger="hover focus"
  data-bs-content="Disabled popover"
 >
  <b-button
   class="btn btn-primary"
   type="button"
   disabled
  >
   Disabled button
  </b-button>
 </span>
</template>