Описи алатки

Документација и примери за додавање прилагођених Боотстрап описа алатки са ЦСС-ом и ЈаваСцрипт-ом користећи ЦСС3 за анимације и атрибуте података за локално складиштење наслова.

Преглед

Ствари које треба знати када користите додатак за опис алата:

• Савети се ослањају на библиотеку треће стране Поппер.јс за позиционирање. Морате укључити поппер.мин.јс пре боотстрап.јс или користити bootstrap.bundle.min.js/ bootstrap.bundle.jsкоји садржи Поппер.јс да би описи функционисали!
• Ако градите наш ЈаваСцрипт из извора, он захтеваutil.js .
• Објашњења се могу укључити из разлога перформанси, тако да их морате сами иницијализирати .
• Објашњења са насловима нулте дужине се никада не приказују.
• Наведите container: 'body'да бисте избегли проблеме са приказивањем у сложенијим компонентама (као што су наше групе за унос, групе дугмади, итд.).
• Покретање описа алатки на скривеним елементима неће радити.
• Објашњења за .disabledили disabledелементе морају бити покренута на елементу омотача.
• Када се активирају са хипервеза које обухватају више редова, описи алата ће бити центрирани. Користите white-space: nowrap;на свом <a>с да бисте избегли ово понашање.
• Објашњења морају бити сакривена пре него што се њихови одговарајући елементи уклоне из ДОМ-а.

Имаш све то? Одлично, да видимо како раде на неким примерима.

Пример: Омогућите савете свуда

Један од начина да се иницијализују сви описи алата на страници био би да их изаберете према њиховом data-toggleатрибуту:

$(function () {
  $('[data-toggle="tooltip"]').tooltip()
})

Примери

Пређите курсором преко линкова испод да бисте видели савете са алаткама:

Пређите курсором преко дугмади у наставку да бисте видели четири упутства за савете: горе, десно, доле и лево.

<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>

И са додатком прилагођеног ХТМЛ-а:

<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>

Употреба

Додатак за опис алата генерише садржај и ознаке на захтев, и подразумевано поставља описе алата након њиховог елемента окидача.

Покрени опис алатке преко ЈаваСцрипт-а:

$('#example').tooltip(options)

$('#example').tooltip({ boundary: 'window' })

Означавање

Потребна ознака за опис алата је само dataатрибут и titleна ХТМЛ елементу желите да имате опис алата. Генерисана ознака описа алата је прилично једноставна, иако захтева позицију (подразумевано, постављену на topдодатак).

<!-- 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>

Опције

Опције се могу пренети преко атрибута података или ЈаваСцрипт-а. За атрибуте података додајте име опције у data-, као у data-animation="".

Методе

$().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')

Догађаји

$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})