Popovers
Sahypaňyzdaky islendik elemente iOS-da tapylanlar ýaly Bootstrap popoversini goşmak üçin resminamalar we mysallar.
Gysgaça syn
Açylýan plugin ulanylanda bilmeli zatlar:
- Popovers ýerleşiş üçin 3-nji tarap kitaphanasy Popper.js -e bil baglaýar . Bootstrap.js-dan öň popper.min.js goşmaly ýa -da popoversiň işlemegi üçin Popper.js-i ulanmaly
bootstrap.bundle.min.js
/ ulanmalybootstrap.bundle.js
! - Popovers garaşlylyk hökmünde gurallar pluginini talap edýär.
- JavaScriptimizi çeşmeden gurýan bolsaňyz, talap edýär
util.js
. - Popovers öndürijilik sebäplerine görä saýlanýar, şonuň üçin olary özüňiz başlamaly .
- Nol uzynlygy
title
wecontent
bahalary hiç haçan açylmaz. container: 'body'
Has çylşyrymly komponentlerde ýüze çykmazlyk üçin kesgitläň (giriş toparlarymyz, düwme toparlarymyz we ş.m.) .- Gizlin elementlerde açylan popowerler işlemez.
- Elementler
.disabled
ýa-dadisabled
elementler üçin ýazgylar, örtük elementinde başlamaly. - Birnäçe çyzyk bilen örtülen labyrlardan başlanda, gämi duralgalarynyň umumy giňliginiň arasynda jemlener. Bu gylyk-häsiýetden gaça durmak üçin s-leri
.text-nowrap
ulanyň .<a>
- Popovers degişli elementleri DOM-dan aýrylmazdan ozal gizlenmeli.
- Popovers kölegeli DOM içindäki bir elementiň kömegi bilen ýüze çykyp biler.
Bu komponentiň animasiýa täsiri prefers-reduced-motion
media talaplaryna baglydyr. Elýeterlilik resminamalarymyzyň azaldylan hereket bölümine serediň .
Käbir mysallar bilen popoversiň nähili işleýändigini görmek üçin okaň.
Mysal: Her ýerde popovers açyň
Sahypadaky ähli açyjylary başlamagyň bir usuly, olary data-toggle
atributlary boýunça saýlamak bolar:
Mysal: container
Opsiýany ulanmak
Esasy elementde popover-a päsgel berýän käbir stilleriňiz bar bolsa, container
aç-açan HTML-iň ýerine şol elementiň içinde peýda bolmagy üçin bir adat görkezmek islärsiňiz.
Mysal
Dört ugur
Dört wariant bar: ýokarky, sag, aşaky we çep deňleşdirilen.
Indiki gezek basyň
focus
Ulanyjynyň üýtgetmek elementinden başga bir elementiň indiki gezek basylmagynda triggerleri ulanyň .
Işden çykarmak üçin indiki basmak üçin zerur bellik
Dogry kross-brauzer we platforma bilen özüňi alyp barmak üçin belligi däl -de, <a>
belligi ulanmaly, bir atribut hem goşmaly .<button>
tabindex
Öçürilen elementler
Sypaty bolan elementler disabled
interaktiw däl, ýagny ulanyjylar bir popover (ýa-da gural görkezmesi) açmak üçin basyp ýa-da basyp bilmeýärler. Iş usuly hökmünde, aç-açan gapjagazy açyp <div>
ýa -da ýapyk elementiň <span>
üstünden ýazmak islärsiňiz.pointer-events
Maýyp popover triggerleri üçin, popover ulanyjylaryňyza ýapyk elemente basmagynadata-trigger="hover"
garaşmazlygy sebäpli derrew wizual seslenme bolup görünmegini isläp bilersiňiz .
Ulanylyşy
JavaScript arkaly açylýan ýerleri açyň:
Görnüş
Opsiýalar maglumat atributlary ýa-da JavaScript arkaly geçirilip bilner. Maglumat atributlary üçin, opsiýanyň adyny data-
bolşy ýaly goşuň data-animation=""
.
Howpsuzlyk sebäpli, sanitize
atributlary ulanyp, opsiýalary üpjün edip bolmaýandygyny ýadyňyzdan çykarmaň sanitizeFn
.whiteList
Ady | Görnüşi | Bellenen | Düşündiriş |
---|---|---|---|
animasiýa | boolean | dogry | Açylýan ýerine CSS solgun geçişini ulanyň |
gap | setir | element | ýalan | ýalan | Açylýan ýeri belli bir elemente goşýar. Mysal : |
mazmuny | setir | element | funksiýasy | '' | Sypat ýok bolsa, deslapky mazmun bahasy Eger bir funksiýa berilse, |
gijikdirmek | sany | obýekt | 0 | Açylýan ýeri (ms) görkezmek we gizlemek - el bilen trigger görnüşine degişli däl San berilse, gizlemek / görkezmek üçin gijikdirme ulanylýar Obýektiň gurluşy: |
html | boolean | ýalan | Açylýan ýere HTML salyň. Falsealňyş bolsa, jQuery text usuly DOM-a mazmun girizmek üçin ulanylar. XSS hüjümleri barada alada edýän bolsaňyz, tekst ulanyň. |
ýerleşdirmek | setir | funksiýasy | 'dogry' | Açylýan ýeri nädip ýerleşdirmeli - awto | ýokarky | aşagy | çep | dogry. Görkezilende, popover-i dinamiki üýtgeder Placerleşişi kesgitlemek üçin bir funksiýa ulanylanda, ilkinji argumenti hökmünde açylýan DOM düwünine, ikinjisi hökmünde hereketlendiriji element DOM düwünine diýilýär. Kontekst |
saýlaýjy | setir | ýalan | ýalan | Eger saýlaýjy üpjün edilse, açylan obýektler görkezilen nyşanlara berler. Iş ýüzünde, dinamiki HTML mazmunyny açýanlary goşmak üçin ulanylýar. Muny we maglumat beriji mysaly görüň . |
şablon | setir | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
Açylýan ýer döredilende ulanjak HTML-i esaslaň. Açylanlaryň Açylanlaryň
Daşky örtük elementi |
ady | setir | element | funksiýasy | '' | Sypat ýok bolsa, deslapky at bahasy Eger bir funksiýa berilse, |
trigger | setir | 'basyň' | Nädip açylýandygy - basyň | aýlanmak | fokus | gollanma. Birnäçe trigger geçirip bilersiňiz; boşluk bilen bölüň. manual başga bir trigger bilen birleşdirip bolmaz. |
ofset | sany | setir | 0 | Maksadyna görä çykýan ýeriň ofset. Has giňişleýin maglumat üçin Popper.js-iň ofset resminamalaryna serediň . |
yza gaýtmak | setir | massiw | 'flip' | Popperiň yza gaýdyp haýsy pozisiýany ulanjakdygyny kesgitlemäge rugsat beriň. Has giňişleýin maglumat üçin Popper.js-iň özüni alyp baryş resminamalaryna serediň |
araçäk | setir | elementi | 'scrollParent' | Çykýan ýeriň aşýan çäk çäkleri. 'viewport' ,, ora 'window' - 'scrollParent' da HTMLElement salgylanmasynyň bahalaryny kabul edýär (diňe JavaScript). Has giňişleýin maglumat üçin Popper.js-iň öňüni alyş resminamalaryna serediň . |
arassaçylyk | boolean | dogry | Arassaçylygy işletmek ýa-da öçürmek. Işledilen 'template' bolsa 'content' we 'title' opsiýalar arassalanar. |
ak sanaw | obýekt | Bellenen baha | Rugsat berlen atributlary we bellikleri öz içine alýan obýekt |
sanitizeFn | null | funksiýasy | null | Bu ýerde öz arassaçylyk funksiýaňyzy üpjün edip bilersiňiz. Arassaçylyk işini geçirmek üçin ýörite kitaphanany ulanmagy makul bilseňiz, bu peýdaly bolup biler. |
Aýry-aýry açyjylar üçin maglumatlar atributlary
Aýry-aýry açyjylar üçin opsiýalar, ýokarda düşündirilişi ýaly maglumat atributlaryny ulanmak arkaly kesgitlenip bilner.
Usullar
Asynkron usullar we geçişler
APIhli API usullary asynkron bolup, geçişe başlaýar . Geçiş başlan badyna, ýöne gutarmanka jaň edijä gaýdyp gelýärler . Mundan başga-da, geçiş komponentine çagyryş usuly hasaba alynmaz .
Has giňişleýin maglumat üçin JavaScript resminamalarymyza serediň .
$().popover(options)
Element ýygnamak üçin açylanlary başlaýar.
.popover('show')
Bir elementiň açylýan ýerini açýar. Açylýan ýer görkezilmänkä (ýagny shown.bs.popover
waka ýüze çykmazdan ozal) jaň edijä gaýdyp gelýär. Bu popoveriň “el bilen” başlamagy hasaplanýar. Iki ady we mazmuny nol uzynlykdaky popovers hiç haçan görkezilmeýär.
.popover('hide')
Bir elementiň açylýan ýerini gizleýär. Açylýan ýer hakykatdanam gizlenmänkä (ýagny hidden.bs.popover
waka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär. Bu popoveriň “el bilen” başlamagy hasaplanýar.
.popover('toggle')
Bir elementiň açylýan ýerini üýtgedýär. Açylýan ýer görkezilmän ýa-da gizlenmänkä (ýagny waka shown.bs.popover
ýa-da hidden.bs.popover
waka ýüze çykmazdan ozal) jaň edýän adama gaýdyp gelýär. Bu popoveriň “el bilen” başlamagy hasaplanýar.
.popover('dispose')
Bir elementiň açylýan ýerini gizleýär we ýok edýär. Delegasiýany ulanýan poplar (opsiýany ulanyp döredilýär ) selector
nesil trigger elementlerinde aýratyn ýok edilip bilinmez.
.popover('enable')
Bir elementiň açylmagyna görkezmek ukybyny berýär. Popovers deslapky görnüşde işledilýär.
.popover('disable')
Bir elementiň açylýan ýerini görkezmek ukybyny aýyrýar. Açylýan ýer diňe täzeden işledilen ýagdaýynda görkezilip bilner.
.popover('toggleEnabled')
Bir elementiň açylýan ýerini görkezmek ýa-da gizlemek ukybyny üýtgedýär.
.popover('update')
Bir elementiň açylýan ýerini täzeleýär.
Wakalar
Çäräniň görnüşi | Düşündiriş |
---|---|
show.bs.popover | show Bu waka mysal usuly çagyrylanda derrew ýanýar . |
görkezilen.bs.popover | Bu waka, ulanyjy üçin açyk görkezilende (CSS geçişleriniň tamamlanmagyna garaşar) atylýar. |
hide.bs.popover | Bu waka hide mysal usuly çagyrylanda derrew atylýar. |
gizlenen.bs.popover | Bu waka, ulanyjydan gizlenip gutarandan soň (CSS geçişleriniň tamamlanmagyna garaşar) atylýar. |
insert.bs.popover | show.bs.popover Bu waka , DOM-a popover şablony goşulandan soň atylýar . |