Saltar al contenido principal Salta a docs navegación
in English

Popovers

Qillqakuna chaymanta ejemplokuna Bootstrap popovers yapanapaq, iOS kaqpi tarisqa hina, mayqin elemento kaqmanpas sitioykipi.

Hatun qhawariy

Imakuna yachanapaq popover plugin kaqwan llamk'achkaspa:

  • Popovers 3 kaq parti biblioteca Popper nisqapi hapipakunku posición nisqapaq. Popper.min.js manaraq bootstrap.js kaqmanta churanayki tiyan utaq bootstrap.bundle.min.js/ llamk'achiy bootstrap.bundle.jsmayqinchus Popper kaqta hap'in popovers llamk'ananpaq!
  • Popovers huk yanapakuy hina yanapakuypa yanapakuyninta mañakun.
  • Popovers ruwayrayku opt-in kanku, chayrayku qam kikiyki qallarichinayki tiyan .
  • Cero-largo titley contentvalores nisqakunaqa manan hayk’aqpas popover nisqataqa rikuchinqachu.
  • container: 'body'Aswan sasa componentekunapi (yaykuna huñuyku, ñit'ina huñukuna, hukkuna hina) sasachakuykunata mana ruwaypaq willay .
  • Pakasqa elementokunapi popoverkunata qallarichiyqa manam llamkanqachu.
  • Popovers para .disabledo disabledelementos deben ser desencadenadas en un elemento de envoltura.
  • Achka chirukunata p’istuykuq anclakunamanta llamk’achisqa kaqtinqa, popovers nisqakunaqa anclakunap tukuy anchon chawpipi chawpichasqa kanqa. Utilizar .text-nowrapen tu <a>s para evitar este comportamiento.
  • Popovers nisqakunaqa pakasqam kanan manaraq DOM nisqamanta tupaqnin elementokuna hurqusqa kachkaptin.
  • Popovers nisqaqa huk llantu DOM ukhupi huk elementoman gracias nisqawanmi llamk'achisqa kanman.
Ñawpaqmanta, kay componente ruwasqa contenido desinfectante kaqwan llamk'achin, mayqinchus mayqin HTML elementokuna mana sut'imanta saqisqa kaqta qichun. Aswan willakuypaq JavaScript qillqaykupi desinfectante t'aqapi qhaway .
Kay componentepa animación efectonqa prefers-reduced-motionmedios tapuymanta hapirin. Yaykuna qillqaykumanta pisiyachisqa kuyuy t'aqapi qhaway .

Ñawinchayllapuni imaynatachus popovers wakin ejemplokunawan llamk’anku chayta qhawanaykipaq.

Ejemplo: Tukuy hinantinpi popovers nisqakunata atichiy

Huk ñan huk p'anqapi llapa popovers qallariypaq kanman akllay data-bs-toggleatributonkuman hina:

var popoverTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="popover"]'))
var popoverList = popoverTriggerList.map(function (popoverTriggerEl) {
  return new bootstrap.Popover(popoverTriggerEl)
})

Ejemplo: containerOpción nisqawan yanapachikuspa

Mayk'aq wakin estilokuna huk tayta elemento kaqpi kanki chaymanta huk popover kaqwan hark'an, huk sapanchasqa willayta munanki chaymanta containerpopover kaqpa HTML chay elemento ukhupi rikukun chaypa rantinpi.

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

Qatina

<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>

Tawa ñankuna

Tawa akllanakuna kan: pata, paña, uray, lluq'i chiqanchasqa. RTL kaqpi Bootstrap llamk'achkaspa ñankuna espejo kaqwan ruwasqa kanku.

<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>

Qatiqnin ñit’iypiqa qarquy

Gatillota focusllamk'achiy popovers kaqmanta llamk'achiqpa qatiqnin ñit'iyninpi huk elementomanta mana toggle elementomanta qarqunapaq.

Específica marcado necesario para dismiss-en-siguiente-click

Allin chakana maskaq chaymanta chakana plataforma ruwaypaq, <a>etiquetata llamk'achinayki tiyan, mana etiquetatachu , chaymanta huk atributotapas <button>churanayki tiyan .tabindex

<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-bs-toggle="popover" data-bs-trigger="focus" title="Dismissible popover" data-bs-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
var popover = new bootstrap.Popover(document.querySelector('.popover-dismiss'), {
  trigger: 'focus'
})

Mana atiq elementokuna

Atributoyuq elementokuna disabledmana interactivochu kanku, niyta munan llamk'aqkuna mana hover utaq ñit'iyta atinkuchu huk popover (utaq yanapakuypa yuyaychaynin) llamk'achinapaq. Huk allichay hina, popover huk p'istumanta <div>utaq <span>, allin ruwasqa teclado-enfocable kaqwan llamk'achispa llamk'achiyta munanki tabindex="0".

Mana atichisqa popover llamk'achiqkuna kaqpaq, qampas data-bs-trigger="hover focus"munankiman chaymanta popover chaylla rikuy kutichiy hina ruwaqniykikunaman rikukun imaynachus mana suyankumanchu huk mana llamk'achisqa elemento ñit'iyta .

<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>

Sass

Variables nisqakuna

$popover-font-size:                 $font-size-sm;
$popover-bg:                        $white;
$popover-max-width:                 276px;
$popover-border-width:              $border-width;
$popover-border-color:              rgba($black, .2);
$popover-border-radius:             $border-radius-lg;
$popover-inner-border-radius:       subtract($popover-border-radius, $popover-border-width);
$popover-box-shadow:                $box-shadow;

$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;
$popover-arrow-color:               $popover-bg;

$popover-arrow-outer-color:         fade-in($popover-border-color, .05);

Uso

JavaScript nisqawan popovers nisqakunata atichiy:

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

Popovers llamk'ayta ruway teclado chaymanta yanapakuy tecnologia kaqmanta llamk'aqkunapaq

Teclado kaqmanta ruwaqkuna popoversniyki llamk'achiyta saqinapaq, HTML elementokunamanlla yapanayki tiyan mayqinkunachus ñawpaqmanta teclado-enfocables chaymanta interactivos kanku (kayhina t'inkikuna utaq formulario kamachiykuna). Aunque arbitrario HTML elementokuna (kayhina <span>s) ruwayta atikunku enfoquepaq atributo yapaspa tabindex="0", kayqa yapanqa potencialmente phiñachiq chaymanta pantasqa tabla sayaykunata mana interactivo elementokunapi teclado kaqmanta ruwaqkunapaq, chaymanta aswan yanapakuq tecnologiakuna kunan pacha mana popover kaqpa contenidonta kay situacionpi willankuchu . Chaymanta, ama sapallapi hapipakuychu hoverpopoversniykipaq gatillo hina, kayqa mana atikunqachu teclado kaqmanta llamk'aqkunapaq gatillo ruwayta.

Sichus qhapaq, estructurasqa HTML popovers kaqpi htmlakllanawan churayta atikunki, sinchita yuyaychayku mana huk llumpay yupayta yapanaykipaq. Imayna popovers kunan llamk'anku chay, huk kuti rikuchisqa, paykunap contenidonku aria-describedbyatributowan elemento desencadenante kaqman watasqa kachkan. Chayhina, tukuy popover kaqpa contenido willasqa kanqa yanapakuq tecnologia kaqmanta llamk'aqkunaman huk suni, mana hark'asqa mayu hina.

Chaymanta, maypachachus atikun chaymanta controles interactivos (kayhina forma elementokuna utaq t'inkikuna) popoverniykipi churayta (kay elementokunata yapaspa chaymanta chay allowListde atributos permitidos chaymanta etiquetas kaqpi), yachay kunan pacha popover mana teclado enfoque ordenta kamachinchu. Mayk'aq huk teclado llamk'aq huk popover kichan, enfoque elemento desencadenante kaqpi qhipakuchkan, chaymanta imaynachus popover aswanta mana chayllachu qatin gatillota qillqap estructuranpi, mana garantia kanchu ñawpaqman/ ñit'iyTABhuk teclado llamk'aqta kikin popover kaqman kuyuchinqa. Pisi rimaypi, huk popover kaqman controles interactivos yapayllaqa kay controles mana chayay atiy/mana llamk'achiy atiyniyuq kay teclado kaqmanta ruwaqkunapaq chaymanta yanapaq tecnologiakuna kaqmanta ruwaqkunapaq, utaq aswan pisi kaqpi huk mana lógico tukuy enfoque kamachiypaq ruwan. Kayhina kaptinqa, chaypa rantinpi huk modal rimanakuna llamk'achiyta yuyaykuy.

Akllanakuna

Akllanakuna willay layakuna utaq JavaScript kaqnintakama pasayta atikun. Willayta layakunapaq, akllana sutita yapay data-bs-, imaynachus data-bs-animation="". Aswan allinta qhaway akllana sutipa caso laya camelCase kaqmanta kebab-case kaqman tikrayta mayk'aq akllanakunata willay atributokuna kaqninta pasanki. Ejemplopaq data-bs-customClass="beautifier", utilizanaykimantaqa data-bs-custom-class="beautifier".

Reparay, harkasqa razonkunarayku sanitize, sanitizeFn, chaymanta allowListakllanakuna mana willay layakuna llamk'achispa quyta atikunkuchu.
Suti Niraq Ñawpaqchasqa Willay
animation boolean nisqa true Huk CSS ch'usaqyachiy tikrayta popover kaqman churay
container q'aytu | elemento | pantasqa false

Popover nisqataqa huk elemento específico nisqamanmi yapan. Ejemplo: container: 'body'. Kay akllana aswan allin kan kaypi chaymanta popoverta qillqap puriyninpi elemento desencadenante qayllapi churayta atikun - mayqinchus harkanqa popoverta elemento desencadenantemanta karuman wayt'ayta huk ventana hatun kayninta tikray pachapi.

content q'aytu | elemento | ruway ''

Ñawpaqmanta churasqa imayna kanankuna sichus data-bs-contentlaya mana kanchu.

Sichus huk ruwana qusqa, chayta waqyasqa kanqa thisreferencia churasqawan chay elementoman mayqinmanchus popover k'askasqa kachkan.

delay yupay | ima 0

Popover (ms) rikuchiy chaymanta pakay tardakuy - mana makiwan gatillo layapaqchu ruwakun

Sichus huk yupay qusqa, tardiy iskaynin pakay/rikuchiypi churasqa

Imakunap rurasqanqa kaymi:delay: { "show": 500, "hide": 100 }

html boolean nisqa false Popover nisqaman HTML nisqa churay. Pantasqa kaptinqa, innerTextpropiedad llamk'achisqa kanqa DOM kaqman willayta churanapaq. Qillqata llamk'achiy sichus XSS ataquekunamanta llakisqa kanki.
placement q'aytu | ruway 'right'

Imaynatataq popover - auto | patamanta | urayninpi | lluq'i | paña.
Mayk'aqchus autonisqa kachkan, chay popover nisqataqa dinamicamente musuqmanta pusanqa.

Huk ruwana churayta tarinapaq llamk'achisqa kaqtinqa, popover DOM nodowan ñawpaq argumenton hina chaymanta elemento trigger DOM nodo iskay kaq hina waqyasqa. Contextoqa thispopover instanciamanmi churasqa kachkan.

selector q'aytu | pantasqa false Sichus huk akllana qusqa, popover objetokuna nisqa metakunaman delegasqa kanqa. Ruwaypi, kayqa llamk'achisqa HTML llamk'achiq contenido popovers yapasqa kananpaq atichinanpaq. Kayta hinaspa huk willakuypaq ejemplota qaway .
template qaytu '<div class="popover" role="tooltip"><div class="popover-arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>'

Base HTML llamk'achinapaq popover ruwachkaspa.

Chay popover's titlenisqataqa inyectasqa kanqa chay .popover-header.

Chay popover's contentnisqataqa inyectasqa kanqa chay .popover-body.

.popover-arrowpopoverpa flechanman tukunqa.

Aswan hawa p'istu elementoqa .popoverclaseyuqmi kanan.

title q'aytu | elemento | ruway ''

Ñawpaqmanta churasqa titulu chani sichus titlelaya mana kanchu.

Sichus huk ruwana qusqa, chayta waqyasqa kanqa thisreferencia churasqawan chay elementoman mayqinmanchus popover k'askasqa kachkan.

trigger qaytu 'click' Imayna popover qallarikun - ñit'iy | hover | enfoque | makiwan. Achka gatillokunatam pasawaq; chaykunata huk ch’usaqwan t’aqay. manualmana huk gatillowan kuskanchasqachu kanman.
fallbackPlacements matriz ['top', 'right', 'bottom', 'left'] Fallback churanakunata riqsichiy huk lista churanakuna matrizpi quspa (munasqa ordenpi). Aswan willakuypaq Popperpa comportamiento docs nisqapi qhaway
boundary q'aytu | imakuna 'clippingParents' Popperpa desbordamiento hark'ay linderon (Popperpa preventOverflow modificadorninllapaqmi). Ñawpaqmanta 'clippingParents'huk HTMLElement willayta chaskiyta atin chaymanta (JavaScript kaqlla kaqnintakama). Aswan willakuypaq qhaway Popperpa detectOverflow docs .
customClass q'aytu | ruway ''

Chay rikuchisqa kaptin popover nisqaman clasekunata yapay. Reparay kay clasekuna yapasqa kanqa mayqin clasekuna plantillapi nisqamanta yapasqa. Achka clasekunata yapanaykipaqqa, rakikunawan rakiy: 'class-1 class-2'.

Huk llamkanatapas pasayta atinki, huk sapalla kaskaqta kutichinan tiyan, yapa clase sutikunayuq.

sanitize boolean nisqa true Saneamiento nisqa ruwayta atichiy utaq mana llamk’achiy. Si activado 'template', 'content'y 'title'opciones serán sanitizadas. JavaScript qillqaykupi desinfectante t'aqapi qhaway .
allowList ima Ñawpaqmanta churasqa chani Objeto que contiene atributos permitidos y etiquetas
sanitizeFn nullq | ruway null Kaypiqa qam kikiykipa desinfectar función nisqatam suministrawaq. Kayqa allin kanman sichus huk dedicada biblioteca llamk’ayta munanki saneamiento ruwanapaq.
offset matriz | q'aytu | ruway [0, 8]

Compensación del popover relativo a su meta. Huk watiqata willay layakunapi chikuwan t'aqasqa chanikunawan kayhinata pasayta atinki:data-bs-offset="10,20"

Huk llamk'ayta offset nisqa riqsinapaq llamk'achisqa kaqtinqa, huk imayaywanmi waqyakun, chaypiqa popper churana, referencia, popper rects nisqakuna ñawpaq argumenton hina. Chay elemento desencadenante DOM nodo iskay kaq argumento hina pasakun. Rurayqa iskay yupayniyuq matriztam kutichinan: .[skidding, distance]

Aswan willakuypaq qhaway Popperpa offset docs .

popperConfig nullq | objeto | ruway null

Bootstrap kaqpa ñawpaqmanta Popper wakichiyninta tikranaykipaq, qhaway Popperpa wakichiyninta .

Huk ruwana Popper ruwana ruwanapaq llamk'achisqa kaqtin, huk imayaywan waqyasqa mayqinchus Bootstrap ñawpaqmanta Popper ruwanayuq kachkan. Yanapasunki llamk'achiyta chaymanta hukllanapaq ñawpaqmanta ruwasqa kikin ruwanaykiwan. Ruwayqa Popperpaq huk wakichiy imayayta kutichinan tiyan.

Sapa popovers nisqapaq atributos de datos nisqa

Sapa popovers kaqpaq akllanakuna hukniraymanta willayta atributokuna llamk'achiyninwan riqsichikunman, ñawpaqpi sut'inchasqa hina.

Utilizar función conpopperConfig

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

Métodos

Métodos y transiciones asíncronas

Llapan API ruwanakuna mana sink'uyuq kanku chaymanta huk tikrayta qallarinku . Paykunaqa kutinku waqyaqman chaylla transición qallarisqa ichaqa manaraq tukukuchkaptin . Chaymantapas, huk tikray componente kaqpi huk método waqyay mana qhawasqachu kanqa .

Aswan willakuypaq JavaScript qillqaykuta qhaway .

qawachiy

Huk elementopa popover nisqa kaynintam qawarichin. Llamaqman kutimun manaraq popover chiqamanta rikuchisqa kachkaptin (icha manaraq shown.bs.popoverruway ruwakuchkaptin). Kayqa qhawarikun huk “manual” desencadenante de la popover nisqa. Popovers mayqinpa titulon chaymanta contenido iskaynin cero-largo kaqniyuq mana hayk'aqpas rikuchisqachu.

myPopover.show()

pakay

Huk elementopa popover nisqa kayninta pakan. Llamaqman kutimun manaraq popover chiqamanta pakasqa kachkaptin (icha manaraq hidden.bs.popoverruway ruwakuchkaptin). Kayqa qhawarikun huk “manual” desencadenante de la popover nisqa.

myPopover.hide()

toggle nisqa

Huk elementopa popover nisqatam tikran. Llamaqman kutimun manaraq popover chiqamanta rikuchisqa utaq pakasqa kachkaptin (icha manaraq shown.bs.popoverutaq hidden.bs.popoverruway ruwakuchkaptin). Kayqa qhawarikun huk “manual” desencadenante de la popover nisqa.

myPopover.toggle()

wischuy

Huk elementopa popoverninta pakan hinaspa chinkachin (DOM elementopi waqaychasqa willakuykunata hurqun). Popovers delegación llamk'achiqkuna (mayqinkuna akllana llamk'achispa kamasqaselector ) mana sapalla chinkachiyta atikunmanchu miray gatillo elementokunapi.

myPopover.dispose()

kawsarichisqa

Huk elementopa popoverninman qawachinapaq atiyta qun. Popovers nisqakunaqa ñawpaqmantaraqmi atichisqa kachkan.

myPopover.enable()

wañuchisqa

Huk elementopa popover nisqa rikuchisqa kananpaq atiyta hurqun. Popover nisqataqa musuqmanta atichisqa kaptinllam qawachiyta atinqa.

myPopover.disable()

toggleAtichisqa

Huk elementopa popover rikuchisqa utaq pakasqa kananpaq atiyninta tikran.

myPopover.toggleEnabled()

kunanyachiy

Huk elementopa popover nisqap kayninta musuqchan.

myPopover.update()

GetInstancia

Método estático mayqinchus huk DOM elementowan tinkisqa popover instanciata jap'iyta atikun

var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getInstance(exampleTriggerEl) // Returns a Bootstrap popover instance

Instanciata tariyUtaq Ruway

Método estático mayqinchus popover instanciata huk DOM elementowan tinkisqata jap'iyta atikun, utaq musuq ruwayta sichus mana qallarisqachu karqa

var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap popover instance

Eventos nisqakuna

Tipo de evento Willay
rikuchiy.bs.popover Kay ruwayqa chaylla rawrarin mayk'aq showinstancia método waqyasqa.
rikuchisqa.bs.popover Kay ruwayqa llamk'achisqa kachkan mayk'aq popover ruwaqman rikukuq ruwasqa (suyanqa CSS tikraykuna tukukunanta).
pakay.bs.popover Kay ruwayqa chaylla llamk'achisqa kachkan mayk'aq hideinstancia método waqyasqa kachkan.
pakasqa.bs.wakcha Kay ruwayqa llamk'achisqa kachkan mayk'aq popover llamk'achiqmanta pakasqa kayta tukusqa (suyanqa CSS tikraykuna tukukunanta).
churasqa.bs.wakcha Kay ruwayqa ruwaymanta qhipaman qarqusqa kachkan show.bs.popovermayk'aq popover plantilla DOM kaqman yapasqa kachkan.
var myPopoverTrigger = document.getElementById('myPopover')
myPopoverTrigger.addEventListener('hidden.bs.popover', function () {
  // do something...
})