Popovers

Overview

Rerum scire quando usus est popover plugin:

• Popoveri confidunt in tertia parte bibliothecae Popper pro positione. Ante popper.min.js includere debes bootstrap.js, vel eo uti , bootstrap.bundle.min.jsquod popper continet.
• Popovers popover plugin sicut dependentiam require.
• Popoveri in agendis causis optent, ergo eas te ipsum initialize oportet .
• Nulla longitudo titleac contentvalores popover numquam ostendent.
• Specificare container: 'body'ad vitandas difficultates in pluribus componentibus (sicut coetus input coetus, globuli, etc).
• Felis popovers in occultis elementis non laborabit.
• Popovers elementum .disabledvel disabledelementum Urguet in wrapper.
• Cum ex ancoris utitur qui per plures lineas involvunt, popoveri inter latitudinem altiore ancorarum centrum erit. Utere .text-nowraptuo <a>s ad vitandum hunc mores.
• Popovers occultari debent antequam elementa eorum correspondentia a dom.
• Popoveri urguere potest propter elementum intra umbram dom.

Legere videas quomodo popovers cum aliquibus exemplis operetur.

Exempla

Admitte popovers

Ut supra, popovers initialize debes antequam adhiberi possunt. Uno modo ut omnes popoveri in pagina initializent eos ex suo data-bs-toggleattributo eligere, sic:

const popoverTriggerList = document.querySelectorAll('[data-bs-toggle="popover"]')
const popoverList = [...popoverTriggerList].map(popoverTriggerEl => new bootstrap.Popover(popoverTriggerEl))

Vivamus demo

Utimur JavaScript similes snippeti supra ad reddendam vivam popover. Titles are set via data-bs-titleand body content is set via data-bs-content.

<button type="button" class="btn btn-lg btn-danger" data-bs-toggle="popover" data-bs-title="Popover title" data-bs-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>

Quattuor directiones

Quattuor optiones praesto sunt: ​​summum, dextrum, fundum et sinistrum. Directiones speculantur cum per Bootstrap in RTL. Pone data-bs-placementmutare directionem.

<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="top" data-bs-content="Top popover">
  Popover on top
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="right" data-bs-content="Right popover">
  Popover on right
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="bottom" data-bs-content="Bottom popover">
  Popover on bottom
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="left" data-bs-content="Left popover">
  Popover on left
</button>

Consuetudinemcontainer

Cum aliqua genera in parentis elemento popover impediente habeas, morem containerexprimere voles ut popover HTML in loco illo elemento appareat. Hoc commune est in tabulis responsivis, coetibus inputandis, et similibus.

const popover = new bootstrap.Popover('.example-popover', {
  container: 'body'
})

Alia condicio ubi expressam consuetudinem ponere voles, sunt popoveri dialogi modales containerintus , fac ut popover ipsum modalis apponatur . Hoc praecipue momenti est pro popovers quae elementa interactiva continent - dialogi modales umbilicum capient, ideo nisi popover parvulus est elementum modalis, utentes non poterunt haec interactiva elementa versari vel movere.

const popover = new bootstrap.Popover('.example-popover', {
  container: '.modal-body'
})

Custom popovers

Possis domicilii speciem popoveri utens CSS variabilium . Consuetudo classium constituimus cum data-bs-custom-class="custom-popover"ut speciem consuetudinem nostram attingamus et ea utamur ad quasdam variabilium localium CSS delendi.

.custom-popover {
  --bs-popover-max-width: 200px;
  --bs-popover-border-color: var(--bs-primary);
  --bs-popover-header-bg: var(--bs-primary);
  --bs-popover-header-color: var(--bs-white);
  --bs-popover-body-padding-x: 1rem;
  --bs-popover-body-padding-y: .5rem;
}

<button type="button" class="btn btn-secondary"
        data-bs-toggle="popover" data-bs-placement="right"
        data-bs-custom-class="custom-popover"
        data-bs-title="Custom popover"
        data-bs-content="This popover is themed via CSS variables.">
  Custom popover
</button>

Dimitte in proximo click

Felis utere focusut popovers emittat in usoris proximi cliccum alterius elementi quam toggle.

<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-bs-toggle="popover" data-bs-trigger="focus" data-bs-title="Dismissible popover" data-bs-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>

const popover = new bootstrap.Popover('.popover-dismiss', {
  trigger: 'focus'
})

Debilitatum elementis

Elementa cum disabledattributo non sunt interactive, utentes significationes non possunt volitare vel preme ea ut popover felis (vel tooltip). Pro habemus, voles ex fasciculo in popover trigger <div>vel <span>, bene uti claviaturae focusable factae tabindex="0".

Pro triggers popover debiles, etiam praeferre data-bs-trigger="hover focus"potes ut popover ut immediata visivae opiniones usoribus tuis appareat, cum in elemento debili strepere non possunt .

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

CSS

Variabilium

Cum pars Bootstrap evolutionis CSS variabilium accedunt, popoveri nunc CSS variabilium localium utuntur .popoverin aucta real-time customizatione. Valores variabilium pro CSS per Sass positae sunt, ergo etiam adhuc Sass customization adiuvatur.

  --#{$prefix}popover-zindex: #{$zindex-popover};
  --#{$prefix}popover-max-width: #{$popover-max-width};
  @include rfs($popover-font-size, --#{$prefix}popover-font-size);
  --#{$prefix}popover-bg: #{$popover-bg};
  --#{$prefix}popover-border-width: #{$popover-border-width};
  --#{$prefix}popover-border-color: #{$popover-border-color};
  --#{$prefix}popover-border-radius: #{$popover-border-radius};
  --#{$prefix}popover-inner-border-radius: #{$popover-inner-border-radius};
  --#{$prefix}popover-box-shadow: #{$popover-box-shadow};
  --#{$prefix}popover-header-padding-x: #{$popover-header-padding-x};
  --#{$prefix}popover-header-padding-y: #{$popover-header-padding-y};
  @include rfs($popover-header-font-size, --#{$prefix}popover-header-font-size);
  --#{$prefix}popover-header-color: #{$popover-header-color};
  --#{$prefix}popover-header-bg: #{$popover-header-bg};
  --#{$prefix}popover-body-padding-x: #{$popover-body-padding-x};
  --#{$prefix}popover-body-padding-y: #{$popover-body-padding-y};
  --#{$prefix}popover-body-color: #{$popover-body-color};
  --#{$prefix}popover-arrow-width: #{$popover-arrow-width};
  --#{$prefix}popover-arrow-height: #{$popover-arrow-height};
  --#{$prefix}popover-arrow-border: var(--#{$prefix}popover-border-color);
  

Sass variables

$popover-font-size:                 $font-size-sm;
$popover-bg:                        $white;
$popover-max-width:                 276px;
$popover-border-width:              $border-width;
$popover-border-color:              var(--#{$prefix}border-color-translucent);
$popover-border-radius:             $border-radius-lg;
$popover-inner-border-radius:       subtract($popover-border-radius, $popover-border-width);
$popover-box-shadow:                $box-shadow;

$popover-header-font-size:          $font-size-base;
$popover-header-bg:                 shade-color($popover-bg, 6%);
$popover-header-color:              $headings-color;
$popover-header-padding-y:          .5rem;
$popover-header-padding-x:          $spacer;

$popover-body-color:                $body-color;
$popover-body-padding-y:            $spacer;
$popover-body-padding-x:            $spacer;

$popover-arrow-width:               1rem;
$popover-arrow-height:              .5rem;

Consuetudinem

Admitte popovers per JavaScript:

const exampleEl = document.getElementById('example')
const popover = new bootstrap.Popover(exampleEl, options)

Optiones

Cum optiones transeantur per data attributa vel JavaScript, potes appendere nomen optionis data-bs-, ut in data-bs-animation="{value}". Fac mutare casus genus optionis nominis ab " camelCase " ad " kebab-casum " cum transeundo optiones per data attributa. Exempli gratia data-bs-custom-class="beautifier"loco data-bs-customClass="beautifier".

Sicut de Bootstrap 5.2.0, omnia membra experimentalem datam reservatam sustinent data-bs-configquae figuram simplicem componentem sicut chorda JSON domum habere potest. Cum elementum habet data-bs-config='{"delay":0, "title":123}'et data-bs-title="456"attributa, valor finalis titleerit 456et attributa separata data valores supra datos vincent data-bs-config. Praeterea exsistentes notitiae attributae possunt domum JSON valores similes data-bs-delay='{"show":0,"hide":150}'.

Munus cum usurapopperConfig

const popover = new bootstrap.Popover(element, {
  popperConfig(defaultBsPopperConfig) {
    // const newPopperConfig = {...}
    // use defaultBsPopperConfig if needed...
    // return newPopperConfig
  }
})

Methodi

// getOrCreateInstance example
const popover = bootstrap.Popover.getOrCreateInstance('#example') // Returns a Bootstrap popover instance

// setContent example
myPopover.setContent({
  '.popover-header': 'another title',
  '.popover-body': 'another content'
})

Events

const myPopoverTrigger = document.getElementById('myPopover')
myPopoverTrigger.addEventListener('hidden.bs.popover', () => {
  // do something...
})