Gorsa Meeshaalee
Galmee fi fakkeenyota gorsa meeshaalee Bootstrap amala CSS fi JavaScript waliin CSS3 fayyadamuun sochiiwwanii fi data-bs-attributes kuusaa mata duree naannoodhaaf dabaluudhaaf.
Haala Waliigalaa
Wantoota yeroo tooltip plugin fayyadamtan beekuu qabdan:
- Tooltips ejjennoodhaaf mana kitaabaa qaama 3ffaa Popper irratti hirkatu. Gorsi meeshaa akka hojjetuuf bootstrap.js dura popper.min.js dabaluu qabda ykn
bootstrap.bundle.min.js
/bootstrap.bundle.js
kan Popper of keessaa qabu fayyadamuu qabda! - Gorsi meeshaalee sababa raawwii hojiitiin filachuudha, kanaaf ofii keetii jalqabuu qabda .
- Gorsi meeshaa mata dureewwan dheerina zeeroo qaban gonkumaa hin agarsiifaman.
container: 'body'
Qaamolee walxaxaa ta'an keessatti (akka gareewwan galtee keenyaa, gareewwan qaree fi kkf) keessatti rakkoolee agarsiisuu akka hin uumamneef ifteessi .- Qaamolee dhokatan irratti gorsa meeshaa kakaasuun hin hojjetu.
- Gorsi meeshaa
.disabled
ykndisabled
elementoota elementii marfataa irratti kakaafamuu qabu. - Yeroo haayperliinkii sararoota hedduu dabarsan irraa kakaafamu, gorsi meeshaa giddugaleessa ta'a. Amala kana irraa of eeguuf s
white-space: nowrap;
kee irratti fayyadami .<a>
- Gorsi meeshaa osoo elementoonni isaanii walgitan DOM irraa hin haqamin dura dhokachuu qabu.
- Gorsi meeshaa galata elementii DOM golboo keessa jiruun kakaafamuu danda'a.
prefers-reduced-motion
gaaffii miidiyaa irratti hundaa'a. Kutaa sochii hir'ate sanada dhaqqabummaa keenyaa ilaali
.
Sana hunda argatte? Guddaa dha, fakkeenya tokko tokkoon akkamitti akka hojjetan haa ilaallu.
Fakkeenya: Gorsa meeshaalee bakka hundatti dandeessisi
data-bs-toggle
Karaan tokko gorsa meeshaalee hunda fuula tokko irratti jalqabsiisuu amaloota isaaniitiin filachuu ta'a :
var tooltipTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="tooltip"]'))
var tooltipList = tooltipTriggerList.map(function (tooltipTriggerEl) {
return new bootstrap.Tooltip(tooltipTriggerEl)
})
Fakkeenyaaf
Gorsa meeshaalee ilaaluuf hidhannoowwan armaan gadii irratti harka kaa'i:
Barruu iddooqa hidhamtoota sarara keessaa tokko tokko gorsa meeshaa waliin agarsiisuuf. Kun amma filler qofa, nama ajjeesu hin qabu. Qabiyyeen as kaa'ame argama barreeffama dhugaa fakkeessuuf qofa . Kana hunda immoo gorsi meeshaalee yeroo haalawwan addunyaa dhugaa keessatti fayyadaman akkamitti akka fakkaatu yaada siif kennuu qofaaf. Kanaafuu amma gorsi meeshaalee hidhaa irratti argaman kun qabatamaan hojjechuu akka danda'an amma argitan abdii qabna , erga marsariitii ykn pirojektii mataa keessanii irratti fayyadamtanii booda.
Kallattiiwwan gorsa meeshaalee afran: gubbaa, mirgaa, jalaa fi bitaa ilaaluuf qaree armaan gadii irratti harka kaa'i. Kallattiiwwan yeroo Bootstrap RTL keessatti fayyadamtu calaqqisiifama.
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="top" title="Tooltip on top">
Tooltip on top
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="right" title="Tooltip on right">
Tooltip on right
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Tooltip on bottom">
Tooltip on bottom
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="left" title="Tooltip on left">
Tooltip on left
</button>
Akkasumas HTML amala dabalamee wajjin:
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-html="true" title="<em>Tooltip</em> <u>with</u> <b>HTML</b>">
Tooltip with HTML
</button>
SVG tokko waliin:
Sass jedhama
Jijjiiramoota
$tooltip-font-size: $font-size-sm;
$tooltip-max-width: 200px;
$tooltip-color: $white;
$tooltip-bg: $black;
$tooltip-border-radius: $border-radius;
$tooltip-opacity: .9;
$tooltip-padding-y: $spacer * .25;
$tooltip-padding-x: $spacer * .5;
$tooltip-margin: 0;
$tooltip-arrow-width: .8rem;
$tooltip-arrow-height: .4rem;
$tooltip-arrow-color: $tooltip-bg;
Fayyadama
Ijaarsi gorsa meeshaa qabiyyee fi mallattoo gaaffii irratti maddisiisa, akkasumas durtii gorsa meeshaa qaama kaka'umsaa isaanii booda kaa'a.
Gorsa meeshaa karaa JaavaScript kakaasi:
var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, options)
Overflow auto
fiscroll
Bakki meeshaa yeroo qabduu warraa keenya qabu overflow: auto
ykn overflow: scroll
jaallatu ofumaan jijjiiruuf yaala .table-responsive
, garuu ammas iddoo iddoo iddoo jalqabaa eega. Kana furuuf, boundary
filannoo (fooyyessaa garagalchuu popperConfig
filannoo fayyadamuun) gara HTMLElement kamiyyuu gatii durtii irra darbuuf saagi, 'clippingParents'
, kan akka document.body
:
var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, {
boundary: document.body // or document.querySelector('#boundary')
})
Markup gochuu
Mallattoon barbaachisu gorsa meeshaa data
amaloota qofaa fi title
qaama HTML irratti gorsa meeshaa qabaachuu barbaadda. Mallattoon gorsa meeshaa uumame baay'ee salphaadha, haa ta'u malee bakka barbaada (durtiidhaan, ifteessaadhaan saagi top
).
Gorsi meeshaalee fayyadamtoota kiiboordii fi teeknooloojii gargaaraaf akka hojjetu gochuu
Qaamolee HTML kanneen akka aadaa furtuu irratti xiyyeeffachuu danda'anii fi wal-qunnamsiisoo ta'an qofa irratti gorsa meeshaa dabaluu qabda (kan akka hidhannoo ykn too'annoo unkaa). Qaamolee HTML fedhii isaaniitiin (kan akka <span>
s) amallicha dabaluudhaan xiyyeeffannoo akka qabaatan gochuun kan danda'amu ta'us tabindex="0"
, kun fayyadamtoota kiiboordiidhaaf qaamolee wal-qunnamtii hin taane irratti dhaabbii caancalaa nama aarsu fi burjaajessu danda'u ni dabala, fi teeknooloojiiwwan gargaaraa baay'een yeroo ammaa haala kana keessatti gorsa meeshaa hin beeksisan. Dabalataanis, akka kaka'umsa gorsa meeshaa keetii qofatti hin hirkatin hover
, kunis gorsa meeshaa kee fayyadamtoota kiiboordiidhaaf kakaasuun akka hin danda'amne taasisa.
<!-- HTML to write -->
<a href="#" data-bs-toggle="tooltip" title="Some tooltip text!">Hover over me</a>
<!-- Generated markup by the plugin -->
<div class="tooltip bs-tooltip-top" role="tooltip">
<div class="tooltip-arrow"></div>
<div class="tooltip-inner">
Some tooltip text!
</div>
</div>
Qaamolee hanqifaman
Qaamonni disabled
amaloota qaban wal-qunnamsiisoo miti, jechuun fayyadamtoonni xiyyeeffannoo, hover, ykn cuqaasuun gorsa meeshaa (ykn popover) kakaasuu hin danda'an. Akka furmaataatti, gorsa meeshaa marfata irraa kakaasuu barbaadda , <div>
akka <span>
gaariitti fayyadamuun kiiboordii irratti xiyyeeffachuu tabindex="0"
danda'a.
<span class="d-inline-block" tabindex="0" data-bs-toggle="tooltip" title="Disabled tooltip">
<button class="btn btn-primary" type="button" disabled>Disabled button</button>
</span>
Filannoowwan
Filannoon karaa amaloota deetaa ykn JaavaScript darbuu danda'u. Amaloota deetaatiif, maqaa filannoo gara data-bs-
, akkuma keessatti dabali data-bs-animation=""
. Yeroo filannoowwan karaa amaloota deetaa dabarsitu akaakuu keesii maqaa filannoo camelCase irraa gara kebab-case jijjiiruu mirkaneessi. Fakkeenyaaf, fayyadamuu mannaa data-bs-customClass="beautifier"
, fayyadami data-bs-custom-class="beautifier"
.
sanitize
,
sanitizeFn
, fi
allowList
amaloota deetaa fayyadamuun dhiyeessuu hin danda'an.
Maqaa | Akaakuu | Durtii dha | Ibsa |
---|---|---|---|
animation |
boolee | true |
Ce'umsa fade CSS gara gorsa meeshaatti hojii irra oolchi |
container |
tarree | elementii | soba | false |
Gorsa meeshaa gara qaama murtaa'etti dabalata. Fakkeenyaaf: |
delay |
lakkoofsa | meeshaa | 0 |
Gorsa meeshaa agarsiisuu fi dhoksuu harkifachuu (ms) - gosa kaka'umsa harkaa irratti hin hojjetu Yoo lakkoofsi kenname, harkifannaa dhoksuu/agarsiisi lamaan irratti hojii irra oola Caasaan wantaa: 1.1. |
html |
boolee | false |
HTML gorsa meeshaa keessatti hayyami. Yoo dhugaa ta'e, mallattoolee HTML kanneen tooltip's Yoo waa'ee haleellaa XSS si yaaddesse barreeffama fayyadami. |
placement |
tarree | faayidaa | 'top' |
Akkaataa tooltip itti dhaabdan - auto | gubbaa | jalaa | bitaa | sirrii. Faankishiniin tokko iddoo murteessuuf yeroo fayyadamu, akka murfii isaa isa jalqabaatti noodiin DOM fiixee meeshaa fi noodiin DOM elementii kakaasu akka isa lammaffaatti waamama. Qabduun |
selector |
tarree | soba | false |
Yoo filataan kenname, wantoonni gorsa meeshaa galmoota ifteessamaniif ni kennamu. Qabatamaan, kun akkasumas gorsa meeshaalee elementoota DOM daayinamiikiin dabalaman irratti hojii irra oolchuuf fayyadama ( jQuery.on deeggarsa). Kanaa fi fakkeenya odeeffannoo qabu ilaalaa . |
template |
hidhaa | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
HTML yeroo gorsa meeshaa uumtu fayyadamuuf bu'uura. Tooltip's
Qaamni marfataa alaa |
title |
tarree | elementii | faayidaa | '' |
Gatii mata duree durtii yoo Yoo faankishiniin kenname, |
trigger |
hidhaa | 'hover focus' |
Akkaataa tooltip itti kakaafamu - | cuqaasi hover | xiyyeeffannoo | kan harkaanii. Kaka’umsa hedduu darbuu dandeessa; bakka adda baasuun addaan baasuu.
|
fallbackPlacements |
tarree | ['top', 'right', 'bottom', 'left'] |
Tarree iddoowwan tarree keessatti (tartiiba filannootiin) kennuudhaan iddoowwan duubatti deebi'uu ibsi. Odeeffannoo dabalataaf docs amala Popper ilaali |
boundary |
tarree | qabiyyee | 'clippingParents' |
Daangaa danqaa dhangala'aa gorsa meeshaa (fooyyessaa preventOverflow Popper qofa irratti hojjeta). Akka durtiitti 'clippingParents' wabii HTMLElement (karaa JavaScript qofa) fudhachuu fi fudhachuu danda'a. Odeeffannoo dabalataaf Popper's detectOverflow docs ilaali . |
customClass |
tarree | faayidaa | '' |
Yeroo agarsiifamu gitawwan gara gorsa meeshaatti dabali. Hubadhu, gitawwan kun gitawwan kamiyyuu unkaa keessatti ifteessaman irratti dabalataan akka dabalaman. Gitoota hedduu dabaluudhaaf, iddoowwan addaan baafadhu: Akkasumas faankishinii tarree tokko maqaa gita dabalataa of keessaa qabu deebisuu qabu dabarsuu dandeessa. |
sanitize |
boolee | true |
Sanitization dandeessisi ykn hanqisi. Yoo activated 'template' fi 'title' filannoowwan sanitized ta'u. Kutaa saanitaayizarii galmee JaavaScript keenya keessatti ilaali . |
allowList |
meeshaa | Gatii durtii | Wanti amaloota fi mallattoolee hayyamaman of keessaa qabu |
sanitizeFn |
null | faayidaa | null |
Asirratti sanitize function mataa keessanii dhiyeessuu dandeessu. Kun faayidaa qabaachuu danda’a yoo mana kitaabaa addaa fayyadamuun qulqulleessuu raawwachuu barbaadde. |
offset |
array | tarree | faayidaa | [0, 0] |
Ofseeti gorsa meeshaa galma isaa wajjin walqabatee. Amaloota deetaa keessatti tarree gatiiwwan komaandiin addaan baafaman akka: Faankishiniin tokko ofseeti murteessuuf yeroo fayyadamu, wanta iddoo popper, wabii, fi popper rects akka falmii isaa isa jalqabaatti of keessaa qabuun waama. Qaamni kakaasu DOM noodiin akka falmii lammaffaatti darba. Faankishinichi tarree lakkoofsota lama qabu deebisuu qaba: . Odeeffannoo dabalataaf Popper's offset docs ilaali . |
popperConfig |
null | wanta | faayidaa | null |
Qindaa'ina Popper durtii Bootstrap jijjiiruuf, qindeessaa Popper ilaali . Yeroo faankishiniin qindeessaa Popper uumuuf fayyadamu, wanta qindeessaa Popper durtii Bootstrap of keessaa qabuun waamama. Durtii qindeessaa mataa keetiin fayyadamuu fi walitti makuuf si gargaara. Faankishinichi wanta qindeessaa Popperiif deebisuu qaba. |
Amaloota deetaa gorsa meeshaalee dhuunfaaf
Filannoon gorsa meeshaalee dhuunfaa filannoodhaan karaa fayyadama amaloota deetaa ifteessuun ni danda'ama, akkuma armaan olitti ibsame.
Faankishinii waliin fayyadamuupopperConfig
var tooltip = new bootstrap.Tooltip(element, {
popperConfig: function (defaultBsPopperConfig) {
// var newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
Malawwan
Malawwanii fi ce’umsawwan wal hin simne
Malleen API hundi wal hin simnee fi ce'umsa jalqabu . Akkuma ce'umsi jalqabame garuu osoo hin xumuramin gara nama bilbileetti deebi'u . Dabalataan, waamichi malaa qaama ce'umsaa irratti ni tuffatama .
agarsiisuu
Gorsa meeshaa elementii tokkoo mul'isa. Osoo gorsi meeshaa qabatamaan hin agarsiifamiin dura gara waamichaatti deebi'a (jechuunis osoo shown.bs.tooltip
taatee hin uumamin dura). Kunis akka “harkaan” kakaasuu tooltip ta’ee fudhatama. Gorsi meeshaa mata dureewwan dheerina zeeroo qaban gonkumaa hin agarsiifaman.
tooltip.show()
dhoksuu
Gorsa meeshaa elementii dhoksa. Osoo gorsi meeshaa qabatamaan hin dhokatiin (jechuun osoo taatee hin uumamin dura) gara waamichaatti deebi'a . hidden.bs.tooltip
Kunis akka “harkaan” kakaasuu tooltip ta’ee fudhatama.
tooltip.hide()
toggle jechuudha
Gorsa meeshaa qaama tokkoo jijjiira. Gara waamichaatti deebi'a osoo gorsi meeshaa qabatamaan hin agarsiifamin ykn hin dhokatiin (jechuunis osoo taatee shown.bs.tooltip
ykn hin uumamin dura hidden.bs.tooltip
). Kunis akka “harkaan” kakaasuu tooltip ta’ee fudhatama.
tooltip.toggle()
gatuu
Gorsa meeshaa qaama tokkoo dhoksuu fi balleessa (Deetaa qaama DOM irratti kuufame haqa). Gorsi meeshaalee bakka bu'iinsa fayyadaman ( kanneen selector
filannoo fayyadamuun uumaman ) qaamolee kaka'umsaa sanyii irratti dhuunfaan balleessuu hin danda'an.
tooltip.dispose()
dandeessisuu
Dandeettii agarsiisuuf tooltip elementii kenna. Gorsi meeshaalee durtiidhan dandeessifama.
tooltip.enable()
akka hin hojjenne gochuu
Dandeettii gorsa meeshaa elementii agarsiisuuf haqa. Gorsi meeshaa agarsiisuu kan danda'u yoo irra deebi'amee dandeessifame qofa.
tooltip.disable()
toggleDandeessifame
Dandeettii gorsa meeshaa elementii akka agarsiifamu ykn dhokfamuuf jijjiira.
tooltip.toggleEnabled()
odeeffannoo dhiyeenyaa
Bakka gorsa meeshaa qaama tokkoo fooyyessa.
tooltip.update()
Fakkeenya argadhu
Mala istaatiksii kan fakkeenya gorsa meeshaa qaama DOM waliin walqabate argachuuf si dandeessisu
var exampleTriggerEl = document.getElementById('example')
var tooltip = bootstrap.Tooltip.getInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance
Fakkeenya argadhuYknUumi
Mala istaatiksii kan fakkeenya gorsa meeshaa qaama DOM waliin walqabate argachuuf si dandeessisu, ykn yoo hin jalqabne haaraa uumuuf si dandeessisu
var exampleTriggerEl = document.getElementById('example')
var tooltip = bootstrap.Tooltip.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance
Taateewwan
Gosa taatee | Ibsa |
---|---|
show.bs.tooltip |
Taatee kun yeroo show mala fakkeenyaa waamamu battalumatti dhukaasa. |
shown.bs.tooltip |
Taatee kun yeroo gorsi meeshaa fayyadamaaf mul'atu taasifamu ni ari'ama (ce'umsa CSS xumuramu ni eega). |
hide.bs.tooltip |
Taatee kun yeroo hide mala fakkeenyaa waamame battalumatti dhukaafama. |
hidden.bs.tooltip |
Taatee kun yeroo gorsi meeshaa fayyadamaa irraa dhokatee xumuru ni dhukaafama (ce'umsa CSS xumuramuu eega). |
inserted.bs.tooltip |
Taatee kun taatee booda show.bs.tooltip yeroo unkaan gorsa meeshaa DOM irratti dabalame ari'ama. |
var myTooltipEl = document.getElementById('myTooltip')
var tooltip = new bootstrap.Tooltip(myTooltipEl)
myTooltipEl.addEventListener('hidden.bs.tooltip', function () {
// do something...
})
tooltip.hide()