+// stylelint-disable custom-property-empty-line-before
+
.popover {
+ // scss-docs-start popover-css-vars
+ --#{$variable-prefix}popover-zindex: #{$zindex-popover};
+ --#{$variable-prefix}popover-max-width: #{$popover-max-width};
+ @include rfs($popover-font-size, --#{$variable-prefix}popover-font-size);
+ --#{$variable-prefix}popover-bg: #{$popover-bg};
+ --#{$variable-prefix}popover-border-width: #{$popover-border-width};
+ --#{$variable-prefix}popover-border-color: #{$popover-border-color};
+ --#{$variable-prefix}popover-border-radius: #{$popover-border-radius};
+ --#{$variable-prefix}popover-box-shadow: #{$popover-box-shadow};
+ --#{$variable-prefix}popover-header-padding-x: #{$popover-header-padding-x};
+ --#{$variable-prefix}popover-header-padding-y: #{$popover-header-padding-y};
+ --#{$variable-prefix}popover-header-color: #{$popover-header-color};
+ --#{$variable-prefix}popover-header-bg: #{$popover-header-bg};
+ --#{$variable-prefix}popover-body-padding-x: #{$popover-body-padding-x};
+ --#{$variable-prefix}popover-body-padding-y: #{$popover-body-padding-y};
+ --#{$variable-prefix}popover-body-color: #{$popover-body-color};
+ --#{$variable-prefix}popover-arrow-width: #{$popover-arrow-width};
+ --#{$variable-prefix}popover-arrow-height: #{$popover-arrow-height};
+ --#{$variable-prefix}popover-arrow-border: var(--#{$variable-prefix}popover-border-color);
+ // scss-docs-end popover-css-vars
+
position: absolute;
top: 0;
left: 0 #{"/* rtl:ignore */"};
- z-index: $zindex-popover;
+ z-index: var(--#{$variable-prefix}popover-zindex);
display: block;
- max-width: $popover-max-width;
+ max-width: var(--#{$variable-prefix}popover-max-width);
// Our parent element can be arbitrary since tooltips are by default inserted as a sibling of their target element.
// So reset our font and text properties to avoid inheriting weird values.
@include reset-text();
- @include font-size($popover-font-size);
+ font-size: var(--#{$variable-prefix}popover-font-size);
// Allow breaking very long words so they don't overflow the popover's bounds
word-wrap: break-word;
- background-color: $popover-bg;
+ background-color: var(--#{$variable-prefix}popover-bg);
background-clip: padding-box;
- border: $popover-border-width solid $popover-border-color;
- @include border-radius($popover-border-radius);
- @include box-shadow($popover-box-shadow);
+ border: var(--#{$variable-prefix}popover-border-width) solid var(--#{$variable-prefix}popover-border-color);
+ @include border-radius(var(--#{$variable-prefix}popover-border-radius));
+ @include box-shadow(var(--#{$variable-prefix}popover-box-shadow));
.popover-arrow {
position: absolute;
display: block;
- width: $popover-arrow-width;
- height: $popover-arrow-height;
+ width: var(--#{$variable-prefix}popover-arrow-width);
+ height: var(--#{$variable-prefix}popover-arrow-height);
&::before,
&::after {
content: "";
border-color: transparent;
border-style: solid;
+ border-width: 0;
}
}
}
.bs-popover-top {
> .popover-arrow {
- bottom: subtract(-$popover-arrow-height, $popover-border-width);
+ bottom: calc((var(--#{$variable-prefix}popover-arrow-height)) * -1); // stylelint-disable-line function-disallowed-list
+
+ &::before,
+ &::after {
+ border-width: var(--#{$variable-prefix}popover-arrow-height) calc(var(--#{$variable-prefix}popover-arrow-width) * .5) 0; // stylelint-disable-line function-disallowed-list
+ }
&::before {
bottom: 0;
- border-width: $popover-arrow-height ($popover-arrow-width * .5) 0;
- border-top-color: $popover-arrow-outer-color;
+ border-top-color: var(--#{$variable-prefix}popover-arrow-border);
}
&::after {
- bottom: $popover-border-width;
- border-width: $popover-arrow-height ($popover-arrow-width * .5) 0;
- border-top-color: $popover-arrow-color;
+ bottom: var(--#{$variable-prefix}popover-border-width);
+ border-top-color: var(--#{$variable-prefix}popover-bg);
}
}
}
/* rtl:begin:ignore */
.bs-popover-end {
> .popover-arrow {
- left: subtract(-$popover-arrow-height, $popover-border-width);
- width: $popover-arrow-height;
- height: $popover-arrow-width;
+ left: calc((var(--#{$variable-prefix}popover-arrow-height)) * -1); // stylelint-disable-line function-disallowed-list
+ width: var(--#{$variable-prefix}popover-arrow-height);
+ height: var(--#{$variable-prefix}popover-arrow-width);
+
+ &::before,
+ &::after {
+ border-width: calc(var(--#{$variable-prefix}popover-arrow-width) * .5) var(--#{$variable-prefix}popover-arrow-height) calc(var(--#{$variable-prefix}popover-arrow-width) * .5) 0; // stylelint-disable-line function-disallowed-list
+ }
&::before {
left: 0;
- border-width: ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5) 0;
- border-right-color: $popover-arrow-outer-color;
+ border-right-color: var(--#{$variable-prefix}popover-arrow-border);
}
&::after {
- left: $popover-border-width;
- border-width: ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5) 0;
- border-right-color: $popover-arrow-color;
+ left: var(--#{$variable-prefix}popover-border-width);
+ border-right-color: var(--#{$variable-prefix}popover-bg);
}
}
}
.bs-popover-bottom {
> .popover-arrow {
- top: subtract(-$popover-arrow-height, $popover-border-width);
+ top: calc((var(--#{$variable-prefix}popover-arrow-height)) * -1); // stylelint-disable-line function-disallowed-list
+
+ &::before,
+ &::after {
+ border-width: 0 calc(var(--#{$variable-prefix}popover-arrow-width) * .5) var(--#{$variable-prefix}popover-arrow-height); // stylelint-disable-line function-disallowed-list
+ }
&::before {
top: 0;
- border-width: 0 ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5);
- border-bottom-color: $popover-arrow-outer-color;
+ border-bottom-color: var(--#{$variable-prefix}popover-arrow-border);
}
&::after {
- top: $popover-border-width;
- border-width: 0 ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5);
- border-bottom-color: $popover-arrow-color;
+ top: var(--#{$variable-prefix}popover-border-width);
+ border-bottom-color: var(--#{$variable-prefix}popover-bg);
}
}
top: 0;
left: 50%;
display: block;
- width: $popover-arrow-width;
- margin-left: -$popover-arrow-width * .5;
+ width: var(--#{$variable-prefix}popover-arrow-width);
+ margin-left: calc(var(--#{$variable-prefix}popover-arrow-width) * -.5); // stylelint-disable-line function-disallowed-list
content: "";
- border-bottom: $popover-border-width solid $popover-header-bg;
+ border-bottom: var(--#{$variable-prefix}popover-border-width) solid var(--#{$variable-prefix}popover-header-bg);
}
}
/* rtl:begin:ignore */
.bs-popover-start {
> .popover-arrow {
- right: subtract(-$popover-arrow-height, $popover-border-width);
- width: $popover-arrow-height;
- height: $popover-arrow-width;
+ right: calc((var(--#{$variable-prefix}popover-arrow-height)) * -1); // stylelint-disable-line function-disallowed-list
+ width: var(--#{$variable-prefix}popover-arrow-height);
+ height: var(--#{$variable-prefix}popover-arrow-width);
+
+ &::before,
+ &::after {
+ border-width: calc(var(--#{$variable-prefix}popover-arrow-width) * .5) 0 calc(var(--#{$variable-prefix}popover-arrow-width) * .5) var(--#{$variable-prefix}popover-arrow-height); // stylelint-disable-line function-disallowed-list
+ }
&::before {
right: 0;
- border-width: ($popover-arrow-width * .5) 0 ($popover-arrow-width * .5) $popover-arrow-height;
- border-left-color: $popover-arrow-outer-color;
+ border-left-color: var(--#{$variable-prefix}popover-arrow-border);
}
&::after {
- right: $popover-border-width;
- border-width: ($popover-arrow-width * .5) 0 ($popover-arrow-width * .5) $popover-arrow-height;
- border-left-color: $popover-arrow-color;
+ right: var(--#{$variable-prefix}popover-border-width);
+ border-left-color: var(--#{$variable-prefix}popover-bg);
}
}
}
// Offset the popover to account for the popover arrow
.popover-header {
- padding: $popover-header-padding-y $popover-header-padding-x;
+ padding: var(--#{$variable-prefix}popover-header-padding-y) var(--#{$variable-prefix}popover-header-padding-x);
margin-bottom: 0; // Reset the default from Reboot
@include font-size($font-size-base);
- color: $popover-header-color;
- background-color: $popover-header-bg;
- border-bottom: $popover-border-width solid $popover-border-color;
+ color: var(--#{$variable-prefix}popover-header-color);
+ background-color: var(--#{$variable-prefix}popover-header-bg);
+ border-bottom: var(--#{$variable-prefix}popover-border-width) solid var(--#{$variable-prefix}popover-border-color);
@include border-top-radius($popover-inner-border-radius);
&:empty {
}
.popover-body {
- padding: $popover-body-padding-y $popover-body-padding-x;
- color: $popover-body-color;
+ padding: var(--#{$variable-prefix}popover-body-padding-y) var(--#{$variable-prefix}popover-body-padding-x);
+ color: var(--#{$variable-prefix}popover-body-color);
}
Things to know when using the popover plugin:
-- Popovers rely on the 3rd party library [Popper](https://popper.js.org/) for positioning. You must include [popper.min.js]({{< param "cdn.popper" >}}) before bootstrap.js or use `bootstrap.bundle.min.js` / `bootstrap.bundle.js` which contains Popper in order for popovers to work!
+- Popovers rely on the third party library [Popper](https://popper.js.org/) for positioning. You must include [popper.min.js]({{< param "cdn.popper" >}}) before `bootstrap.js`, or use one `bootstrap.bundle.min.js` which contains Popper.
- Popovers require the [tooltip plugin]({{< docsref "/components/tooltips" >}}) as a dependency.
- Popovers are opt-in for performance reasons, so **you must initialize them yourself**.
- Zero-length `title` and `content` values will never show a popover.
Keep reading to see how popovers work with some examples.
-## Example: Enable popovers everywhere
+## Examples
-One way to initialize all popovers on a page would be to select them by their `data-bs-toggle` attribute:
+### Enable popovers
+
+As mentioned above, you must initialize popovers before they can be used. One way to initialize all popovers on a page would be to select them by their `data-bs-toggle` attribute, like so:
```js
var popoverTriggerList = Array.prototype.slice.call(document.querySelectorAll('[data-bs-toggle="popover"]'))
})
```
-## Example: Using the `container` option
-
-When you have some styles on a parent element that interfere with a popover, you'll want to specify a custom `container` so that the popover's HTML appears within that element instead.
-
-```js
-var popover = new bootstrap.Popover(document.querySelector('.example-popover'), {
- container: 'body'
-})
-```
+### Live demo
-## Example
+We use JavaScript similar to the snippet above to render the following live popover. Titles are set via `title` attribute and body content is set via `data-bs-content`.
{{< example >}}
<button type="button" class="btn btn-lg btn-danger" data-bs-toggle="popover" title="Popover title" data-bs-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>
### Four directions
-Four options are available: top, right, bottom, and left aligned. Directions are mirrored when using Bootstrap in RTL.
+Four options are available: top, right, bottom, and left. Directions are mirrored when using Bootstrap in RTL. Set `data-bs-placement` to change the direction.
{{< example >}}
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="top" data-bs-content="Top popover">
</button>
{{< /example >}}
+### Custom `container`
+
+When you have some styles on a parent element that interfere with a popover, you'll want to specify a custom `container` so that the popover's HTML appears within that element instead. This is common in responsive tables, input groups, and the like.
+
+```js
+var popover = new bootstrap.Popover(document.querySelector('.example-popover'), {
+ container: 'body'
+})
+```
+
+### Custom popovers
+
+<small class="d-inline-flex px-2 py-1 font-monospace text-muted border rounded-3">Added in v5.2.0</small>
+
+You can customize the appearance of popovers using [CSS variables](#variables). We set a custom class with `data-bs-custom-class="custom-popover"` to scope our custom appearance and use it to override some of the local CSS variables.
+
+{{< scss-docs name="custom-popovers" file="site/assets/scss/_component-examples.scss" >}}
+
+{{< example class="custom-popover-demo" >}}
+<button type="button" class="btn btn-secondary"
+ data-bs-toggle="popover" data-bs-placement="right"
+ data-bs-custom-class="custom-popover"
+ title="Custom popover"
+ data-bs-content="This popover is themed via CSS variables.">
+ Custom popover
+</button>
+{{< /example >}}
+
### 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.
</span>
{{< /example >}}
-## Sass
+## CSS
### Variables
+<small class="d-inline-flex px-2 py-1 font-monospace text-muted border rounded-3">Added in v5.2.0</small>
+
+As part of Bootstrap’s evolving CSS variables approach, popovers now use local CSS variables on `.popover` for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.
+
+{{< scss-docs name="popover-css-vars" file="scss/_popover.scss" >}}
+
+### Sass variables
+
{{< scss-docs name="popover-variables" file="scss/_variables.scss" >}}
## Usage
projects / thirdparty / bootstrap.git / commitdiff
