Кораллар
CSS3 һәм JavaScript ярдәмендә Bootstrap коралларын өстәү өчен документлар һәм мисаллар, анимацияләр өчен CSS3 кулланып, җирле исем саклау өчен мәгълүмат-атрибутлар.
Гомуми күзәтү
Кораллар плагинын кулланганда белергә кирәк нәрсәләр:
- Кораллар урнаштыру өчен 3-нче партия китапханәсенә таяналар . Сез bootstrap.js алдыннан popper.min.js кертергә тиеш , яки корал киңәшләре эшләсен өчен Popper булган / кулланырга
bootstrap.bundle.min.js
/ кулланыргаbootstrap.bundle.js
тиеш! - Әгәр дә сез безнең JavaScriptны чыганактан төзисез икән, бу кирәк
util.js
. - Кораллар эш башкару сәбәпле оптималь, шуңа күрә сез аларны үзегез башларга тиеш .
- Нуль озынлыгы булган кораллар беркайчан да күрсәтелми.
- Катлаулырак компонентларда проблемалар китермәс өчен күрсәтегез
container: 'body'
(безнең кертү төркемнәре, төймә төркемнәре һ.б.). - Яшерен элементлардагы инструмент киңәшләре эшләмәячәк.
- Электрон кораллар
.disabled
якиdisabled
элементлар төрү элементында башланырга тиеш. - Берничә сызыкны үз эченә алган гиперштамалардан башлангач, инструментлар үзәкләштереләчәк. Бу тәртиптән саклану өчен с-ларда
white-space: nowrap;
кулланыгыз .<a>
- Кораллар тиешле элементлар DOMдан чыгарылганчы яшерелергә тиеш.
- Кораллар DOM күләгәсе эчендәге элемент ярдәмендә башланырга мөмкин.
prefers-reduced-motion
медиа соравына бәйле. Безнең документларның кыскартылган хәрәкәт бүлеген карагыз
.
Барысы да бармы? Яхшы, әйдәгез аларның кайбер мисаллар белән ничек эшләвен карыйк.
Exampleрнәк: бөтен җирдә корал күрсәтмәләрен эшләгез
Биттәге барлык инструментларны башлап җибәрүнең бер ысулы - аларны data-toggle
атрибутлары буенча сайлау:
$(function () {
$('[data-toggle="tooltip"]').tooltip()
})
Мисаллар
Корал киңәшләрен карау өчен түбәндәге сылтамалар өстендә йөрегез:
Корал киңәшләре белән кайбер сылтамаларны күрсәтү өчен урын иясе тексты . Бу хәзер тутыручы гына, үтерүче дә юк. Чын текстның булуын охшату өчен монда урнаштырылган эчтәлек . Realәм болар барысы да реаль дөнья ситуацияләрендә кулланылганда инструментлар ничек булачагы турында күзаллау өчен. Шуңа күрә сез сылтамалардагы бу инструментларның практикада ничек эшләвен күрдегез дип өметләнәм, аларны үз сайтыгызда яки проектта кулланганнан соң.
Дүрт коралның юнәлешен карау өчен астагы төймәләр өстенә басыгыз: өске, уң, аскы һәм сул.
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="top" title="Tooltip on top">
Tooltip on top
</button>
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="right" title="Tooltip on right">
Tooltip on right
</button>
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="bottom" title="Tooltip on bottom">
Tooltip on bottom
</button>
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="left" title="Tooltip on left">
Tooltip on left
</button>
Customәм махсус HTML өстәлде:
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-html="true" title="<em>Tooltip</em> <u>with</u> <b>HTML</b>">
Tooltip with HTML
</button>
Куллану
Кораллар плагины таләп буенча эчтәлек һәм билгеләр чыгара, һәм триггер элементыннан соң корал күрсәтмәләрен урнаштыра.
JavaScript аша корал киңәшен эшләгез:
$('#example').tooltip(options)
Ташу auto
һәмscroll
Tooltip позициясе ата-аналар контейнеры бездә булганда overflow: auto
яки overflow: scroll
бездә булганда автоматик рәвештә үзгәрергә .table-responsive
тырыша, ләкин оригиналь урнаштыру позициясен саклый. Чишү өчен, boundary
вариантны килешү кыйммәтеннән башка берәр нәрсәгә куегыз 'scrollParent'
, мәсәлән 'window'
:
$('#example').tooltip({ boundary: 'window' })
Билгеләү
Корал киңәше өчен кирәкле билгеләр бары тик data
атрибут һәм title
HTML элементында сез корал киңәше булырга телисез. Корал киңәшенең ясалган билгесе бик гади, ләкин ул позиция таләп итә (килешү буенча, top
плагин белән куелган).
Клавиатура һәм ярдәмче технология кулланучылар өчен инструментлар ясау
Сез традицион клавиатурага игътибарлы һәм интерактив булган HTML элементларына корал күрсәтмәләрен өстәргә тиеш (мәсәлән, сылтамалар яки форма белән идарә итү). Характерлы HTML элементлары (мәсәлән <span>
) tabindex="0"
атрибутны өстәп игътибарны тупларга мөмкин булса да, бу клавиатура кулланучылары өчен интерактив булмаган элементларга потенциаль рәнҗетүче һәм буталчык өстәмә тукталышлар өстәячәк, һәм күпчелек ярдәмче технологияләр хәзерге вакытта бу очракта кораллар турында игълан итмиләр. Өстәвенә, кораллар өчен триггер буларак кына таянмагыз hover
, чөнки бу сезнең корал киңәшләрен клавиатура кулланучылары өчен эшләтеп булмый.
<!-- HTML to write -->
<a href="#" data-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="arrow"></div>
<div class="tooltip-inner">
Some tooltip text!
</div>
</div>
Инвалид элементлар
Атрибутлы элементлар disabled
интерактив түгел, димәк, кулланучылар кораллар (яки поповер) җибәрү өчен аларны туплый алмыйлар, күтәрә алмыйлар. Эш урыны буларак, сез кораллар коралын төргәктән <div>
яисә <span>
идеаль рәвештә клавиатура фокуслы итеп ясарга һәм инвалид элементны tabindex="0"
юкка чыгарырга теләрсез.pointer-events
<span class="d-inline-block" tabindex="0" data-toggle="tooltip" title="Disabled tooltip">
<button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>
Вариантлар
Вариантларны мәгълүмат атрибутлары яки JavaScript аша бирергә мөмкин. Мәгълүмат атрибутлары өчен вариант исемен data-
өстәгез data-animation=""
.
sanitize
,
sanitizeFn
һәм
whiteList
вариантлар мәгълүмат атрибутлары ярдәмендә бирелә алмый.
Исем | Тип | Килешү | Тасвирлау |
---|---|---|---|
анимация | буле | дөрес | Кораллар киңәшенә CSS сүнгән күчүне кулланыгыз |
контейнер | кыл | элемент | ялган | ялган | Корал киңәшен билгеле бер элементка өсти. Мисал : |
тоткарлау | саны | объект | 0 | Корал күрсәтмәсен күрсәтү һәм яшерү (мс) - кул белән эшләнгән триггер төренә кагылмый Әгәр дә сан бирелсә, яшерү / күрсәтү өчен тоткарлык кулланыла Объект структурасы: |
html | буле | ялган | HTML коралында рөхсәт итегез. Дөрес булса, кораллар киңәшендәге HTML тэглары кораллар күрсәтмәсендә XSS һөҗүмнәре турында борчылсагыз, текст кулланыгыз. |
урнаштыру | кыл | функциясе | 'top' | Корал киңәшен ничек урнаштырырга - авто | өстә | аста | сул | уң. Урнаштыруны билгеләр өчен функция кулланылганда, ул беренче аргумент буларак DOM төен кораллары белән, икенчесе буларак DOM төененең этәргеч элементы дип атала. |
селектор | кыл | ялган | ялган | Әгәр дә селектор тәкъдим ителсә, кораллы объектлар күрсәтелгән максатларга биреләчәк. Практикада, бу шулай ук динамик кушылган DOM элементларына ( jQuery.on ярдәм) корал күрсәтмәләрен куллану өчен кулланыла. Моны һәм информацион мисалны карагыз . |
шаблон | кыл | '<div class="tooltip" role="tooltip"><div class="arrow"></div><div class="tooltip-inner"></div></div>' |
Кораллар ясаганда куллану өчен HTML нигезе. Кораллар
Тышкы төрү элементы |
исем | кыл | элемент | функциясе | '' |
Әгәр дә функция бирелсә, ул |
триггер | кыл | 'фокусны әйләндерү' | Кораллар ничек эшләнә - басыгыз | | | фокус | кулланма. Сез берничә триггер узарга мөмкин; аларны бушлык белән аерыгыз.
|
офсет | саны | кыл | функциясе | 0 | Максатына караганда кораллар оффеты. Офсетны билгеләү өчен функция кулланылганда, аның беренче аргументы буларак офсет мәгълүматлары булган объект белән атала. Функция бер үк структуралы объектны кайтарырга тиеш. Икенче аргумент буларак DOM төененең этәргеч элементы уза. Күбрәк мәгълүмат өчен Попперның офсет документларына мөрәҗәгать итегез . |
.әр сүзнең | кыл | массив | 'флип' | Попперның кире кайту вакытында нинди позицияне кулланачагын күрсәтергә рөхсәт итегез. Күбрәк мәгълүмат өчен Попперның тәртип документларына мөрәҗәгать итегез |
CustomClass | кыл | функциясе | '' | Күрсәтелгәндә инструментыгызга дәресләр өстәгез. Игътибар итегез, бу класслар шаблонда күрсәтелгән теләсә нинди классларга өстәп өстәләчәк. Берничә класс өстәр өчен, аларны урыннар белән аерыгыз : Сез шулай ук өстәмә класс исемнәре булган бер сызыкны кайтарырга тиеш функцияне уза аласыз. |
чик | кыл | элемент | 'scrollParent' | Коралның чик чикләре. 'viewport' ,, Һәм HTMLElement сылтамасының кыйммәтләрен кабул итә 'window' ( JavaScript кына). 'scrollParent' Күбрәк мәгълүмат өчен Попперның профилактика Оверфлоу документларына мөрәҗәгать итегез . |
санитарлаштыру | буле | дөрес | Санитизацияне эшләтеп җибәрү яки сүндерү. Активлаштырылса 'template' һәм 'title' вариантлар санитарияләнәчәк. Безнең JavaScript документациясендә санитизатор бүлеген карагыз . |
ак исемлек | объект | Килешенгән кыйммәт | Рөхсәт ителгән атрибутлар һәм тэглар булган объект |
sanitizeFn | null | функциясе | нуль | Монда сез үзегезнең санитария функциясен тәкъдим итә аласыз. Санитизация ясау өчен махсус китапханә кулланырга теләсәгез, бу файдалы булырга мөмкин. |
popperConfig | null | объект | нуль | Bootstrap'ның default Popper конфигурациясен үзгәртү өчен, Popper конфигурациясен карагыз |
Индивидуаль кораллар өчен мәгълүмат атрибутлары
Индивидуаль кораллар өчен вариантлар, югарыда аңлатылганча, мәгълүмат атрибутлары ярдәмендә альтернатив рәвештә күрсәтелергә мөмкин.
Методлар
Асинхрон ысуллар һәм күчү
Барлык API ысуллары да асинхрон һәм күчү башлый . Күчерелеш башлангач, ләкин ул беткәнче шалтыратучыга кире кайталар . Моннан тыш, күчү компонентына методик чакыру игътибарсыз калачак .
Күбрәк мәгълүмат алу өчен безнең JavaScript документларын карагыз .
$().tooltip(options)
Элемент коллекциясенә инструменты эшкәртүчене бәйли.
.tooltip('show')
Элемент коралын күрсәтә. Корал киңәше күрсәтелгәнче (ягъни shown.bs.tooltip
вакыйга булганчы) шалтыратучыга кире кайта. Бу корал күрсәтмәсенең “кул белән” этәргеч булып санала. Нуль озынлыгы булган кораллар беркайчан да күрсәтелми.
$('#element').tooltip('show')
.tooltip('hide')
Элемент коралын яшерә. Корал киңәше яшерелгәнче (ягъни hidden.bs.tooltip
вакыйга булганчы) шалтыратучыга кире кайта. Бу корал күрсәтмәсенең “кул белән” этәргеч булып санала.
$('#element').tooltip('hide')
.tooltip('toggle')
Элементның инструменты. Корал киңәше күрсәтелгән яки яшерелгәнче ( shown.bs.tooltip
яисә hidden.bs.tooltip
вакыйга булганчы) шалтыратучыга кире кайта. Бу корал күрсәтмәсенең “кул белән” этәргеч булып санала.
$('#element').tooltip('toggle')
.tooltip('dispose')
Элемент коралын яшерә һәм юк итә. Делегацияне кулланган кораллар ( вариант ярдәмендә ясалганselector
) нәсел триггер элементларында аерым юк ителми.
$('#element').tooltip('dispose')
.tooltip('enable')
Элементның кораллар күрсәтү сәләтен күрсәтә. Кораллар килешү буенча кушылган.
$('#element').tooltip('enable')
.tooltip('disable')
Элементның корал күрсәтмәсен күрсәтү мөмкинлеген бетерә. Корал киңәше яңадан эшләнгән очракта гына күрсәтеләчәк.
$('#element').tooltip('disable')
.tooltip('toggleEnabled')
Элементның корал күрсәтмәсен күрсәтү яки яшерү мөмкинлеген күчә.
$('#element').tooltip('toggleEnabled')
.tooltip('update')
Элемент коралының позициясен яңарта.
$('#element').tooltip('update')
Вакыйгалар
Вакыйга төре | Тасвирлау |
---|---|
show.bs.tooltip | show Бу вакыйга инстанция ысулы чакырылганда шунда ук янып тора . |
күрсәтелгән.bs.tooltip | Бу вакыйга инструмент киңәше кулланучыга күренгәндә эшләнә (CSS күчү тәмамлануын көтә). |
hide.bs.tooltip | hide Бу вакыйга инстанция ысулы чакырылганда шунда ук эштән чыгарыла . |
hidden.bs.tooltip | Бу вакыйга инструмент киңәше кулланучыдан яшерелгәннән соң (CSS күчү тәмамлануын көтеп торачак). |
insert.bs.tooltip | Бу вакыйга show.bs.tooltip DOMга кораллар шаблоны өстәлгәннән соң җибәрелә. |
$('#myTooltip').on('hidden.bs.tooltip', function () {
// do something...
})