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.
- Sichus JavaScriptniykumanta pukyuta ruwachkanki, chayta munan
util.js
. - 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 wakin ejemplokunawan llamk’anku chayta qhawanaykipaq.
Ejemplo: Tukuy hinantinpi popovers nisqakunata atichiy
Huk ñan huk p'anqapi llapa popovers qallariypaq kanman akllay data-toggle
atributonkuman hina:
$(function () {
$('[data-toggle="popover"]').popover()
})
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.
$(function () {
$('.example-popover').popover({
container: 'body'
})
})
Qatina
<button type="button" class="btn btn-lg btn-danger" data-toggle="popover" title="Popover title" data-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.
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="top" data-content="Top popover">
Popover on top
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="right" data-content="Right popover">
Popover on right
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Bottom popover">
Popover on bottom
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="left" data-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-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
$('.popover-dismiss').popover({
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, huk p'istumanta popover llamk'achiyta munanki <div>
utaq <span>
chaymanta pointer-events
mana atichisqa elemento kaqpi llallichiyta munanki.
Mana atichisqa popover llamk'achiqkuna kaqpaq, qampas data-trigger="hover"
munankiman chaymanta popover chaylla rikuy kutichiy hina ruwaqniykikunaman rikukun imaynachus mana suyankumanchu huk mana llamk'achisqa elemento ñit'iyta .
<span class="d-inline-block" data-toggle="popover" data-content="Disabled popover">
<button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>
Uso
JavaScript nisqawan popovers nisqakunata atichiy:
$('#example').popover(options)
GPU utqaylla ruway
Popovers wakin kuti Windows 10 dispositivokunapi mana sut'i rikukunku GPU utqaylla ruwayrayku chaymanta huk tikrasqa sistema DPI kaqrayku. Kaypaq llamkana v4 kaqpi GPU utqaylla ruwayta mana ruwaychu popoversniykipi necesitasqanmanhina.
Yuyaychasqa allichay:
Popper.Defaults.modifiers.computeStyle.gpuAcceleration = !(window.devicePixelRatio < 1.5 && /Win/.test(navigator.platform))
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 aria-describedby
atributowan 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 interactivo kamachiykunata (kayhina formulario elementokuna utaq t'inkikuna) popoverniykipi churayta (kay elementokunata yapaspa whiteList
utaq saqisqa atributokunaman chaymanta etiquetakunaman), 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-
, imaynachus data-animation=""
.
sanitize
,
sanitizeFn
chaymanta
whiteList
akllanakuna mana willay atributokuna llamk'achispa quyta atikunkuchu.
Suti | Niraq | Ñawpaqchasqa | Willay |
---|---|---|---|
animación | boolean nisqa | chiqaq | Huk CSS ch'usaqyachiy tikrayta popover kaqman churay |
contenedor | q'aytu | elemento | pantasqa | pantasqa | Popover nisqataqa huk elemento específico nisqamanmi yapan. Ejemplo: |
winay | q'aytu | elemento | ruway | '' . | Ñawpaqmanta churasqa imayna kanankuna sichus Sichus huk ruwana qusqa, chayta waqyasqa kanqa |
unayay | 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 nisqapi | boolean nisqa | pantasqa | Popover nisqaman HTML nisqa churay. Sichus llulla, jQuery kaqpa text ruwaynin llamk'achisqa kanqa DOM kaqman willayta churanapaq. Qillqata llamk'achiy sichus XSS ataquekunamanta llakisqa kanki. |
churay | q'aytu | ruway | 'paña' | 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 |
akllaq | q'aytu | pantasqa | pantasqa | 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 . |
plantilla | qaytu | '<div class="popover" role="tooltip"><div class="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 |
suti | q'aytu | elemento | ruway | '' . | Ñawpaqmanta churasqa titulu chani sichus Sichus huk ruwana qusqa, chayta waqyasqa kanqa |
piñachiy | qaytu | 'click' nisqa. | Imayna popover qallarikun - ñit'iy | hover | enfoque | makiwan. Achka gatillokunatam pasawaq; chaykunata huk ch’usaqwan t’aqay. manual mana huk gatillowan kuskanchasqachu kanman. |
offset nisqa | yupay | qaytu | 0. | Compensación del popover relativo a su meta. Aswan willakuypaq qhaway Popperpa offset docs . |
fallbackClocación | q'aytu | matriz | 'kuyuchiy' | Permitir especificar cual posición Popper utilizará en fallback. Aswan willakuypaq Popperpa comportamiento docs nisqapi qhaway |
costumbreClase | 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: Huk llamkanatapas pasayta atinki, huk sapalla kaskaqta kutichinan tiyan, yapa clase sutikunayuq. |
frontera | q'aytu | imakuna | 'scrollParent' nisqa. | Límite de restricción de desbordamiento del popover nisqa. 'viewport' , 'window' , 'scrollParent' , icha HTMLElement willaypa chanikunata chaskikun (JavaScriptlla). Aswan willakuypaq qhaway Popperpa preventOverflow qillqakuna . |
sanitizar | boolean nisqa | chiqaq | Saneamiento nisqa ruwayta atichiy utaq mana llamk’achiy. Si activado 'template' , 'content' y 'title' opciones serán sanitizadas. JavaScript qillqaykupi desinfectante t'aqapi qhaway . |
yuraqLista | ima | Ñawpaqmanta churasqa chani | Objeto que contiene atributos permitidos y etiquetas |
sanitizarFn | nullq | ruway | chusaq | Kaypiqa qam kikiykipa desinfectar función nisqatam suministrawaq. Kayqa allin kanman sichus huk dedicada biblioteca llamk’ayta munanki saneamiento ruwanapaq. |
popperConfig nisqa | nullq | ima | chusaq | Bootstrap kaqpa ñawpaqmanta Popper wakichiyninta tikranaykipaq, Popperpa wakichiyninta qhaway |
Sapa popovers nisqapaq atributos de datos nisqa
Sapa popovers kaqpaq akllanakuna hukniraymanta willayta atributokuna llamk'achiyninwan riqsichikunman, ñawpaqpi sut'inchasqa hina.
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 .
$().popover(options)
Huk elemento huñunapaq popovers nisqakunata qallarichin.
.popover('show')
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.
$('#element').popover('show')
.popover('hide')
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.
$('#element').popover('hide')
.popover('toggle')
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.
$('#element').popover('toggle')
.popover('dispose')
Huk elementopa popover nisqa kayninta pakaspa chinkachin. Popovers delegación llamk'achiqkuna (mayqinkuna akllana llamk'achispa kamasqaselector
) mana sapalla chinkachiyta atikunmanchu miray gatillo elementokunapi.
$('#element').popover('dispose')
.popover('enable')
Huk elementopa popoverninman qawachinapaq atiyta qun. Popovers nisqakunaqa ñawpaqmantaraqmi atichisqa kachkan.
$('#element').popover('enable')
.popover('disable')
Huk elementopa popover nisqa rikuchisqa kananpaq atiyta hurqun. Popover nisqataqa musuqmanta atichisqa kaptinllam qawachiyta atinqa.
$('#element').popover('disable')
.popover('toggleEnabled')
Huk elementopa popover rikuchisqa utaq pakasqa kananpaq atiyninta tikran.
$('#element').popover('toggleEnabled')
.popover('update')
Huk elementopa popover nisqap kayninta musuqchan.
$('#element').popover('update')
Eventos nisqakuna
Tipo de Evento | Willay |
---|---|
rikuchiy.bs.popover | Kay ruwayqa chaylla rawrarin mayk'aq show instancia 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 hide instancia 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.popover mayk'aq popover plantilla DOM kaqman yapasqa kachkan. |
$('#myPopover').on('hidden.bs.popover', function () {
// do something...
})