Lisebelisoa
Litokomane le mehlala ea ho eketsa lisebelisoa tsa lisebelisoa tsa Bootstrap ka CSS le JavaScript u sebelisa CSS3 bakeng sa lipopae le litšobotsi tsa data bakeng sa polokelo ea lihlooho tsa lehae.
Kakaretso
Lintho tseo u lokelang ho li tseba ha u sebelisa plugin ea tooltip:
- Litlhahiso li itšetlehile ka laeborari ea batho ba boraro ea Popper.js bakeng sa maemo. U tlameha ho kenyelletsa popper.min.js pele ho bootstrap.js kapa sebelisa
bootstrap.bundle.min.js
/bootstrap.bundle.js
e nang le Popper.js e le hore lisebelisoa tsa lisebelisoa li sebetse! - Haeba u theha JavaScript ea rona ho tsoa mohloling, e hloka
util.js
. - Litlhahiso ke tsa ho kena ka mabaka a ts'ebetso, kahoo u tlameha ho li qala ka bouena .
- Lisebelisoa tse nang le lihlooho tsa bolelele ba zero ha li hlahisoe.
- Hlakisa
container: 'body'
ho qoba ho fana ka mathata ka likarolo tse rarahaneng (joalo ka lihlopha tsa rona tsa ho kenya, lihlopha tsa likonopo, joalo-joalo). - Ho kenya lisebelisoa ho lisebelisoa tse patiloeng ho ke ke ha sebetsa.
- Lisebelisoa tsa lisebelisoa
.disabled
kapadisabled
likarolo li tlameha ho hlahisoa holim'a karolo ea wrapper. - Ha e hlahisoa ho tsoa ho li-hyperlink tse nang le mela e mengata, lisebelisoa tsa lisebelisoa li tla ba teng. Sebelisa
white-space: nowrap;
ho hao<a>
ho qoba boitšoaro bona. - Lisebelisoa li tlameha ho patoa pele likarolo tsa tsona tse tsamaellanang li tlosoa ho DOM.
- Lisebelisoa li ka hlahisoa ka lebaka la ntho e ka hare ho moriti oa DOM.
Liphetho tsa animation tsa karolo ena li ipapisitse le prefers-reduced-motion
potso ea media. Sheba karolo e fokolitsoeng ea motsamao oa litokomane tsa phihlello ea rona .
O nale tseo tsohle? E kholo, a re boneng hore na ba sebetsa joang ka mehlala e meng.
Mohlala: Lumella lithulusi hohle
Tsela e 'ngoe ea ho qala lisebelisoa tsohle tse leqepheng e tla ba ho li khetha ka data-toggle
tšobotsi ea tsona:
Mehlala
Tsamaea holim'a lihokelo tse ka tlase ho bona lintlha tsa lisebelisoa:
Borikhoe bo thata bo latelang keffiyeh mohlomong ha u so utloe ka bona. Photo booth litelu tse tala tsa denim letterpress vegan messenger bag stumptown. Seaparo sa polasi-to-tafola seitan, mcsweeney's fixie sustainable quinoa 8-bit american apparse e na le terry richardson vinyl chambray. Litelu stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. A really ironic artisan whatever keytar , scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral.
Tsamaea holim'a likonopo tse ka tlase ho bona litsela tse 'nè tsa lisebelisoa: holimo, ho le letona, tlase, le ho le letšehali.
'Me ka HTML e tloaelehileng e ekelitsoe:
Tšebeliso
plugin ea tooltip e hlahisa litaba le markup ho latela tlhoko, 'me ka ho sa feleng e beha malebela ka mor'a ntho ea eona ea ho qala.
Qala sesebelisoa ka JavaScript:
Khala auto
lescroll
Sebaka sa Tooltip se leka ho fetoha ha sesebelisoa sa motsoali se rata overflow: auto
kapa se overflow: scroll
rata .table-responsive
, empa se ntse se boloka boemo ba sebaka sa pele. Ho rarolla, beha boundary
khetho ho eng kapa eng ntle le boleng ba kamehla 'scrollParent'
, joalo ka 'window'
:
Markup
Letšoao le hlokahalang bakeng sa sesebelisoa ke data
tšobotsi feela 'me title
ho karolo ea HTML u lakatsa ho ba le sesebelisoa. Thepa e hlahisitsoeng ea sesebelisoa e bonolo, leha e hloka boemo (ka kamehla, e behiloeng top
ke plugin).
Ho etsa hore malebela a lithulusi a sebetse ho keyboard le basebelisi ba theknoloji e thusang
O lokela ho kenya feela malebela a lisebelisoa ho likarolo tsa HTML tseo ka tloaelo li shebaneng le keyboard le ho sebelisana (joalo ka likhokahano kapa taolo ea liforomo). Leha likarolo tsa HTML tse sa reroang (tse kang <span>
s) li ka tsepamisoa maikutlo ka ho eketsa tabindex="0"
tšobotsi, sena se tla eketsa litopo tse ka bang tsa khopisa le tse ferekanyang linthong tse sa sebelisaneng bakeng sa basebelisi ba keyboard, 'me mahlale a mangata a thusang hajoale ha a phatlalatse sesebelisoa boemong bona. Ho phaella moo, u se ke ua itšetleha feela ka hover
hore e be mohloli oa lisebelisoa tsa hau, kaha sena se tla etsa hore lisebelisoa tsa hau tsa lisebelisoa li se ke tsa khoneha bakeng sa basebelisi ba keyboard.
Lintho tse holofetseng
Lintho tse nang le disabled
tšobotsi ha li sebelisane, ho bolelang hore basebelisi ha ba khone ho tsepamisa maikutlo, ho ōka, kapa ho li tobetsa ho kenya lisebelisoa (kapa popover). Joalo ka mokhoa oa ho sebetsa, o tla batla ho qala sesebelisoa ho tsoa ho sekoaelo <div>
kapa <span>
, ka mokhoa o nepahetseng o etse hore keyboard e tsepamise maikutlo ho sebelisa tabindex="0"
, 'me u kenye pointer-events
holim'a ntho e holofetseng.
Dikgetho
Likhetho li ka fetisoa ka lintlha tsa data kapa JavaScript. Bakeng sa litšobotsi tsa data, kenya lebitso la khetho ho data-
, joalo ka data-animation=""
.
Hlokomela hore ka mabaka a ts'ireletso sanitize
, sanitizeFn
le whiteList
likhetho li ke ke tsa fanoa ho sebelisoa litšobotsi tsa data.
Lebitso | Mofuta | Ea kamehla | Tlhaloso |
---|---|---|---|
animation | boolean | 'nete | Kenya phetoho ea CSS fade ho tooltip |
setshelo | khoele | ntho | bohata | bohata | E kopanya ntlha ea lisebelisoa ho ntho e itseng. Mohlala |
lieha | nomoro | ntho | 0 | Ho lieha ho bonts'a le ho pata ntlha ea lisebelisoa (ms) - ha e sebetse mofuteng oa ho kenya letsoho Haeba nomoro e fanoe, ho lieha ho sebelisoa ho pata/show ka bobeli Sebopeho sa ntho ke: |
html | boolean | bohata | Lumella HTML karolong ea lisebelisoa. Haeba ke 'nete, li-tag tsa HTML tse karolong ea lisebelisoa li Sebelisa mongolo haeba u tšoenyehile ka litlhaselo tsa XSS. |
ho beha | khoele | tshebetso | 'holimo' | Mokhoa oa ho beha sesebelisoa - auto | holimo | tlase | le letšehali | hantle. Ha ts'ebetso e sebelisoa ho fumana hore na e behiloe hokae, e bitsoa ka node ea DOM e nang le "tooltip" e le khang ea eona ea pele, 'me karolo e qalang ea DOM e le ea bobeli. Moelelo |
mokhethi | khoele | bohata | bohata | Haeba ho fanoe ka sekhetho, lintlha tsa lisebelisoa li tla abeloa lipehelo tse boletsoeng. Ha e le hantle, sena se sebelisetsoa ho sebelisa lisebelisoa tsa lisebelisoa ho likarolo tsa DOM tse ekelitsoeng ka matla ( jQuery.on ts'ehetso). Bona sena le mohlala o rutang . |
template | khoele | '<div class="tooltip" role="tooltip"><div class="arrow"></div><div class="tooltip-inner"></div></div>' |
HTML ea mantlha eo u ka e sebelisang ha u theha sesebelisoa. The tooltip's
Karolo e ka ntle ea wrapper e lokela ho ba le |
sehlooho | khoele | ntho | tshebetso | '' | Boleng ba sehlooho sa kamehla haeba Haeba mosebetsi o fanoe, o tla bitsoa ka |
qhoqhoa | khoele | 'hover focus' | Mokhoa oa lisebelisoa o qala joang - tlanya | hloella | tsepamisa | tataiso. U ka 'na ua fetisa li-triggers tse ngata; di arole ka sebaka.
|
offset | nomoro | khoele | tshebetso | 0 | Offset ea lisebelisoa tse amanang le sepheo sa eona. Ha ts'ebetso e sebelisoa ho khetholla offset, e bitsoa ka ntho e nang le data ea offset e le khang ea eona ea pele. Mosebetsi o tlameha ho khutlisa ntho e nang le sebopeho se ts'oanang. The triggering element DOM node e fetisoa e le khang ea bobeli. Ho fumana lintlha tse ling, sheba ho Popper.js's offset docs . |
fallbackPlacement | khoele | array | 'phetla' | Lumella ho hlakisa hore na Popper e tla sebelisa boemo bofe ha ho khutla. Ho fumana lintlha tse ling, sheba ho Popper.js's behaviour docs |
moeli | khoele | element | 'scrollParent' | Moeli oa litšitiso tse fetelletseng oa sesebelisoa. E amohela boleng ba 'viewport' , 'window' , 'scrollParent' , kapa HTMLElement reference (JavaScript feela). Ho fumana lintlha tse ling, sheba ho Popper.js's preventOverflow docs . |
sanitize | boolean | 'nete | Lumella kapa o tima tsamaiso ea sanitization. Haeba e kentsoe 'template' 'me 'title' likhetho li tla hloekisoa. |
whiteList | ntho | Boleng ba kamehla | Ntho e nang le litšobotsi le li-tag tse lumelletsoeng |
hloekisaFn | null | tshebetso | lefeela | Mona o ka fana ka ts'ebetso ea hau ea sanitize. Sena se ka ba molemo haeba u khetha ho sebelisa laebrari e inehetseng ho etsa bohloeki. |
popperConfig | null | ntho | lefeela | Ho fetola tlhophiso ea kamehla ea Bootstrap ea Popper.js, bona tlhophiso ea Popper.js |
Litšobotsi tsa data bakeng sa lisebelisoa tsa motho ka mong
Likhetho tsa lisebelisoa tsa motho ka mong li ka hlalosoa ka tšebeliso ea lintlha, joalo ka ha ho hlalositsoe ka holimo.
Mekhoa
Mekhoa ea Asynchronous le liphetoho
Mekhoa eohle ea API ha e- synchronous 'me e qala phetoho . Ba khutlela ho motho ea letselitseng hang ha phetoho e qala empa pele e fela . Ho feta moo, mohala oa mokhoa ho karolo ea phetoho o tla hlokomolohuoa .
Sheba litokomane tsa rona tsa JavaScript bakeng sa lintlha tse ling .
$().tooltip(options)
E hokela sebatli sa lithulusi pokellong ea lintho.
.tooltip('show')
E senola karolo ea lisebelisoa. E kgutlela ho moletsi pele thulusi e bontshwa (ke hore pele shown.bs.tooltip
ketsahalo e etsahala). Sena se nkuoa e le "manual" e qalang ea sesebelisoa. Lisebelisoa tse nang le lihlooho tsa bolelele ba zero ha li hlahisoe.
.tooltip('hide')
E pata ntlha ea lisebelisoa. E khutlela ho ea letselitseng pele sesebelisoa se patiloe (ke hore pele hidden.bs.tooltip
ketsahalo e etsahala). Sena se nkuoa e le "manual" e qalang ea sesebelisoa.
.tooltip('toggle')
E fetola ntlha ea lisebelisoa. E khutlela ho ea letselitseng pele sesebelisoa se bontšoa kapa se patiloe (ke hore pele ketsahalo shown.bs.tooltip
kapa hidden.bs.tooltip
ketsahalo e etsahala). Sena se nkuoa e le "manual" e qalang ea sesebelisoa.
.tooltip('dispose')
E pata le ho senya ntlha ea lisebelisoa. Litlhahiso tse sebelisang kemiso (tse entsoeng ho sebelisoa khetho selector
) li ke ke tsa senngoa ka bonngoe holima lintho tse qalang.
.tooltip('enable')
E fa ntlha ea lisebelisoa bokhoni ba ho bonts'a. Litlhahiso tsa lisebelisoa li lumelloa ka mokhoa oa kamehla.
.tooltip('disable')
E tlosa bokhoni ba ho hlahisa lisebelisoa tsa element. The tooltip e tla khona ho bonts'oa ha feela e buletsoe hape.
.tooltip('toggleEnabled')
E fetola bokhoni ba lisebelisoa tsa element hore li bontšoe kapa li patehe.
.tooltip('update')
E kaonefatsa boemo ba ntlha ea lisebelisoa.
Liketsahalo
Mofuta oa Ketsahalo | Tlhaloso |
---|---|
bonts'a.bs.tooltip | Ketsahalo ena e tuka hang hang ha show mokhoa oa mohlala o bitsoa. |
bontshiweng.bs.tooltip | Ketsahalo ena e ts'oaroa ha sesebelisoa sa lisebelisoa se bonahalitsoe ho mosebelisi (e tla emela hore liphetoho tsa CSS li phethehe). |
pata.bs.tooltip | Ketsahalo ena e lelekoa hang hang ha hide mokhoa oa mohlala o bitsoa. |
patiloeng.bs.tooltip | Ketsahalo ena e ts'oaroa ha sesebelisoa se qeta ho patoa ho mosebelisi (e tla emela hore liphetoho tsa CSS li phethehe). |
kenya.bs.tooltip | Ketsahalo ena e lelekoa ka mor'a show.bs.tooltip ketsahalo ea ha thempleite ea tooltip e kentsoe ho DOM. |