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'achiybootstrap.bundle.js
mayqinchus 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
title
ycontent
valores 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
.disabled
odisabled
elementos 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-nowrap
en 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.
prefers-reduced-motion
medios tapuymanta hapirin. Yaykuna qillqaykumanta pisiyachisqa kuyuy t'aqapi qhaway
.
Ñawinchayllapuni imaynatachus popovers llamk’anku wakin ejemplokunawan qhawanaykipaq.
Ejemplo: Tukuy hinantinpi popovers nisqakunata atichiy
Huk ñan huk p'anqapi llapa popovers qallariypaq kanman akllay data-bs-toggle
atributonkuman hina:
var popoverTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="popover"]'))
var popoverList = popoverTriggerList.map(function (popoverTriggerEl) {
return new bootstrap.Popover(popoverTriggerEl)
})
Ejemplo: container
Opción nisqawan yanapachikuspa
Mayk'aq wakin estilokuna huk tayta elemento kaqpi kanki chaymanta huk popover kaqwan hark'an, huk sapanchasqa willayta munanki chaymanta container
popover 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 kaqpi 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 focus
llamk'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 disabled
mana 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 hover
popoversniykipaq gatillo hina, kayqa mana atikunqachu teclado kaqmanta llamk'aqkunapaq gatillo ruwayta.
Sichus qhapaq, estructurasqa HTML popovers kaqpi html
akllanawan churayta atikunki, sinchita yuyaychayku mana huk llumpay yupayta yapanaykipaq. Imayna popovers kunan llamk'anku chay, huk kuti rikuchisqa, paykunap contenidonku watasqa kachkan chay elemento desencadenante kaqman aria-describedby
atributo kaqwan. 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 allowList
de 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. Kay casos kaqpi, huk modal diálogo llamk'achiyta yuyaykuy chaypa rantinpi.
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"
.
sanitize
,
sanitizeFn
, chaymanta
allowList
akllanakuna 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: |
content |
q'aytu | elemento | ruway | '' |
Ñawpaqmanta churasqa imayna kanankuna sichus Sichus huk ruwana qusqa, chayta waqyasqa kanqa |
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: |
html |
boolean nisqa | false |
Popover nisqaman HTML nisqa churay. Pantasqa kaptinqa, innerText propiedad 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. Huk ruwana churayta tarinapaq llamk'achisqa kaqtinqa, popover DOM nodowan ñawpaq argumenton hina chaymanta elemento trigger DOM nodo iskay kaq hina waqyasqa. Contextoqa |
selector |
q'aytu | pantasqa | false |
Sichus huk akllana qusqa, popover objetokuna nisqa metakunaman delegasqa kanqa. Ruwaypi, kayqa HTML llamk'achiq contenido popovers yapasqa kananpaq atichinanpaq llamk'achkan. 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 Chay popover's
Aswan hawa p'istu elementoqa |
title |
q'aytu | elemento | ruway | '' |
Ñawpaqmanta churasqa titulu chani sichus Sichus huk ruwana qusqa, chayta waqyasqa kanqa |
trigger |
qaytu | 'click' |
Imayna popover qallarikun - ñit'iy | hover | enfoque | makiwan. Achka gatillokunatam pasawaq; chaykunata huk ch’usaqwan t’aqay. manual mana 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 qillqakuna . |
customClass |
q'aytu | ruway | '' |
Chay rikuchisqa kaptin popover nisqaman clasekunata yapay. Reparay kay clasekuna yapasqa kanqa ima clasekuna plantillapi nisqamanta yapasqa. Achka clasekunata yapanaykipaqqa, ch'usaqkunawan t'aqay: Huk llamk'aytapas pasayta atinki, chaytaq huk watiqallata 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: 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: . 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 .
qawachiy
Huk elementopa popover nisqa kaynintam qawarichin. Llamaqman kutimun manaraq popover chiqamanta rikuchisqa kachkaptin (icha manaraq shown.bs.popover
ruway 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.popover
ruway 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.popover
utaq hidden.bs.popover
ruway 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 show instancia método waqyasqa kaqtin. |
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 hide instancia método waqyasqa kachkan. |
pakasqa.bs.wakcha | Kay ruwayqa llamk'achisqa kachkan mayk'aq popover llamk'aqmanta pakasqa kayta tukusqa (suyanqa CSS tikraykuna tukukunanta). |
churasqa.bs.wakcha | Kay ruwayqa ruwaymanta qhipaman llamk'achisqa kachkan show.bs.popover mayk'aq popover plantilla DOM kaqman yapasqa kachkan. |
var myPopoverTrigger = document.getElementById('myPopover')
myPopoverTrigger.addEventListener('hidden.bs.popover', function () {
// do something...
})