ޓޫލްޓިޕްސް އެވެ
އެނިމޭޝަންތަކަށް ސީއެސްއެސް3 ބޭނުންކޮށްގެން ސީއެސްއެސް އަދި ޖާވާސްކްރިޕްޓާއެކު ކަސްޓަމް ބޫޓްސްޓްރަޕް ޓޫލްޓިޕްސް އިތުރުކުރުމަށް ލިޔެކިޔުންތަކާއި މިސާލުތައް އަދި ލޯކަލް ޓައިޓަލް ސްޓޯރޭޖަށް ޑޭޓާ-ބީއެސް-އެޓްރިބިއުޓްސް.
އޯވަރވިއު
ޓޫލްޓިޕް ޕްލަގިން ބޭނުންކުރާއިރު އެނގެން ޖެހޭ ކަންތައްތައް:
- ޓޫލްޓިޕްސް ޕޮޒިޝަން ކުރުމަށް ބަރޯސާވެފައިވަނީ ތިންވަނަ ފަރާތެއްގެ ލައިބްރަރީ ޕޮޕަރ އަށެވެ. ކުރިން popper.min.js ހިމަނަންވާނެ
bootstrap.js
, ނުވަތަbootstrap.bundle.min.js
ޕޮޕަރ ހިމެނޭ އެއްޗެއް ބޭނުންކުރަންވާނެއެވެ. - ޓޫލްޓިޕްސް އަކީ ޕާފޯމަންސް ސަބަބުތަކާހުރެ އޮޕްޓް-އިން އެއްޗެއް ކަމުން އަމިއްލައަށް އިނިޝިއަލައިޒް ކުރަން ޖެހެއެވެ .
- ޒީރޯ ދިގުމިނުގެ ސުރުޚީތައް ހުންނަ ޓޫލްޓިޕްތައް ދުވަހަކުވެސް ނުފެނެއެވެ.
container: 'body'
މިއަށްވުރެ ކޮމްޕްލެކްސް ކޮމްޕޯނެންޓްތަކުގައި (އަޅުގަނޑުމެންގެ އިންޕުޓް ގްރޫޕްތަކާއި، ބަޓަން ގްރޫޕްތައް ފަދަ) ރެންޑަރިންގ މައްސަލަތަކުން ސަލާމަތްވުމަށް ކަނޑައަޅާށެވެ .- ފޮރުވިފައިވާ އެލިމެންޓްތަކުގެ މައްޗަށް ޓޫލްޓިޕްސް ޓްރިގަރ ކުރުމުން ފައިދާއެއް ނުވާނެއެވެ.
- ޓޫލްޓިޕްސް ފޯރ
.disabled
ނުވަތަdisabled
އެލިމެންޓްސް ޓްރިގަރ ކުރަންވާނީ ރެޕަރ އެލިމެންޓެއްގެ މައްޗަށެވެ. - އެތައް ލައިނެއް ފުޅާވެފައިވާ ހައިޕަރލިންކްތަކުން ޓްރިގަރ ކުރާއިރު، ޓޫލްޓިޕްސް ސެންޓަރ ވާނެއެވެ. މި ސުލޫކުން ސަލާމަތްވުމަށްޓަކައި
white-space: nowrap;
އޮން ޔޫއާރ ސް ބޭނުން ކުރާށެވެ .<a>
- ޓޫލްޓިޕްތައް ފޮރުވަން ޖެހޭނީ އެތަކެތީގެ އެލިމެންޓްތައް ޑީއޯއެމް އިން ނައްތާލުމުގެ ކުރިންނެވެ.
- ޓޫލްޓިޕްސް ޓްރިގަރ ކުރެވޭނީ ޝެޑޯ ޑޮމް އެއްގެ ތެރޭގައި ހުންނަ އެލިމެންޓެއްގެ ސަބަބުންނެވެ.
އެ ހުރިހާ ކަމެއް ލިބިއްޖެތަ؟ މޮޅު، ބައެއް މިސާލުތަކާއެކު އެމީހުން މަސައްކަތްކުރާ ގޮތް ބަލާލަމާ ހިނގާށެވެ.
prefers-reduced-motion
މީޑިއާ ކިއުއަރީގެ މައްޗަށެވެ. އަޅުގަނޑުމެންގެ އެކްސެސިބިލިޓީ ޑޮކިއުމަންޓޭޝަންގެ ރިޑޫސްޑް މޮޝަން ބައި ބައްލަވާށެވެ
.
މިސާލުތަކެވެ
ޓޫލްޓިޕްސް އެނެބަލް ކުރުން
މަތީގައި ދެންނެވި ފަދައިން ޓޫލްޓިޕްތައް ބޭނުން ކުރުމުގެ ކުރިން އިނިޝިއަލައިޒް ކުރަން ޖެހެއެވެ. ޞަފްޙާއެއްގައިވާ ހުރިހާ ޓޫލްޓިޕްތަކެއް އިނިޝިއަލައިޒް ކުރެވޭނެ އެއް ގޮތަކީ، އެ ޓޫލްޓިޕްތައް data-bs-toggle
އެޓްރިބިއުޓް އަށް ބަލައިގެން ހޮވުމެވެ، މިފަދައިން:
const tooltipTriggerList = document.querySelectorAll('[data-bs-toggle="tooltip"]')
const tooltipList = [...tooltipTriggerList].map(tooltipTriggerEl => new bootstrap.Tooltip(tooltipTriggerEl))
ލިންކްތަކުގައި ޓޫލްޓިޕްސް
ޓޫލްޓިޕްސް ބަލާލުމަށް ތިރީގައިވާ ލިންކްތަކުގެ މައްޗަށް ހޯވަރ ކޮށްލައްވާ:
ޓޫލްޓިޕްތަކާއެކު ބައެއް އިންލައިން ލިންކްތައް ދައްކާލުމަށް ޕްލޭސްހޯލްޑަރ ޓެކްސްޓް . މިއީ މިހާރު ހަމައެކަނި ފިލާއެއް، ކިލަރއެއް ނެތް. ކޮންޓެންޓް މިތަނުގައި ބަހައްޓާފައިވަނީ ހަމައެކަނި ހަގީގީ ލިޔުމެއްގެ ޙާޟިރީ ނަކަލު ކުރުމަށްޓަކައެވެ . އަދި އެ ހުރިހާ ކަމެއް ހަމައެކަނި ތިބާއަށް ޙަޤީޤީ ދުނިޔޭގެ ޙާލަތްތަކުގައި ބޭނުންކުރާއިރު ޓޫލްޓިޕްތައް ފެންނާނެ ގޮތުގެ ޚިޔާލެއް ދިނުމަށްޓަކައެވެ. އެހެންވީމާ އިރާދަކުރެއްވިއްޔާ މިހާރު ތިޔަބޭފުޅުންނަށް ފެނިވަޑައިގެންފައިވާނެ ލިންކްތަކުގައިވާ މި ޓޫލްޓިޕްތައް އަމަލީ ގޮތުން މަސައްކަތް ކުރެވޭނެ ގޮތް، އެއްފަހަރު އަމިއްލަ ސައިޓެއްގައި ނުވަތަ ޕްރޮޖެކްޓެއްގައި އެ ޓޫލްޓިޕްތައް ބޭނުން ކުރެއްވުމުން .
<p class="muted">Placeholder text to demonstrate some <a href="#" data-bs-toggle="tooltip" data-bs-title="Default tooltip">inline links</a> with tooltips. This is now just filler, no killer. Content placed here just to mimic the presence of <a href="#" data-bs-toggle="tooltip" data-bs-title="Another tooltip">real text</a>. And all that just to give you an idea of how tooltips would look when used in real-world situations. So hopefully you've now seen how <a href="#" data-bs-toggle="tooltip" data-bs-title="Another one here too">these tooltips on links</a> can work in practice, once you use them on <a href="#" data-bs-toggle="tooltip" data-bs-title="The last tip!">your own</a> site or project.
</p>
title
ނުވަތަ
data-bs-title
ތިމާގެ އެޗްޓީއެމްއެލްގައި ބޭނުން ކުރާށެވެ. title
ބޭނުންކުރާއިރު، ޕޮޕަރ އިން
data-bs-title
އެލިމެންޓް ރެންޑަރ ކުރާއިރު
އޮޓޮމެޓިކުން
ބަދަލުކުރާނެއެވެ.ކަސްޓަމް ޓޫލްޓިޕްސް
v5.2.0 ގައި އިތުރުކޮށްފައިވެއެވެސީއެސްއެސް ވެރިއޭބަލްސް ބޭނުންކޮށްގެން ޓޫލްޓިޕްތަކުގެ ސިފަ ކަސްޓަމައިޒް ކުރެވިދާނެއެވެ . އަހަރެމެންގެ ކަސްޓަމް ފެންނަ ފެނުމަށް ސްކޯޕް ކުރުމަށް ކަސްޓަމް ކްލާސް އެއް ސެޓްކޮށް، data-bs-custom-class="custom-tooltip"
ލޯކަލް ސީއެސްއެސް ވެރިއޭބަލް އެއް އޮވަރރައިޑް ކުރުމަށް ބޭނުން ކުރަމެވެ.
.custom-tooltip {
--bs-tooltip-bg: var(--bs-primary);
}
<button type="button" class="btn btn-secondary"
data-bs-toggle="tooltip" data-bs-placement="top"
data-bs-custom-class="custom-tooltip"
data-bs-title="This top tooltip is themed via CSS variables.">
Custom tooltip
</button>
މިސްރާބުތައް
ތިރީގައިވާ ބަޓަންތަކުގެ މައްޗަށް ހޯވަރ ކޮށްލުމުން ޓޫލްޓިޕްސްގެ ހަތަރު މިސްރާބު ފެންނާނެއެވެ: މަތީ، ވާތް، ތިރީ، އަދި ވާތު. އާރުޓީއެލްގައި ބޫޓްސްޓްރެޕް ބޭނުންކުރާއިރު މިސްރާބުތައް ލޯގަނޑުން ފެނެއެވެ.
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="top" data-bs-title="Tooltip on top">
Tooltip on top
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="right" data-bs-title="Tooltip on right">
Tooltip on right
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="bottom" data-bs-title="Tooltip on bottom">
Tooltip on bottom
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="left" data-bs-title="Tooltip on left">
Tooltip on left
</button>
އަދި ކަސްޓަމް އެޗްޓީއެމްއެލް އިތުރުކޮށްގެން:
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-html="true" data-bs-title="<em>Tooltip</em> <u>with</u> <b>HTML</b>">
Tooltip with HTML
</button>
އެސްވީޖީއަކާއެކު:
ސީއެސްއެސް އެވެ
ވެރިއޭބަލްސް އެވެ
v5.2.0 ގައި އިތުރުކޮށްފައިވެއެވެބޫޓްސްޓްރެޕްގެ ތަރައްގީވަމުން އަންނަ ސީއެސްއެސް ވެރިއޭބަލްސް އެޕްރޯޗްގެ ބައެއްގެ ގޮތުގައި، ޓޫލްޓިޕްތަކުގައި މިހާރު ލޯކަލް ސީއެސްއެސް ވެރިއޭބަލްސް އޮން ބޭނުންކޮށްގެން .tooltip
ރިއަލް ޓައިމް ކަސްޓަމައިޒޭޝަން އިތުރުކޮށްދެއެވެ. ސީއެސްއެސް ވެރިއޭބަލްތަކަށް ވެލިއުތައް ސެޓް ކުރެވެނީ ސާސް މެދުވެރިކޮށް ކަމުން ސާސް ކަސްޓަމައިޒޭޝަން އަދިވެސް ސަޕޯޓް ކުރެވެއެވެ.
--#{$prefix}tooltip-zindex: #{$zindex-tooltip};
--#{$prefix}tooltip-max-width: #{$tooltip-max-width};
--#{$prefix}tooltip-padding-x: #{$tooltip-padding-x};
--#{$prefix}tooltip-padding-y: #{$tooltip-padding-y};
--#{$prefix}tooltip-margin: #{$tooltip-margin};
@include rfs($tooltip-font-size, --#{$prefix}tooltip-font-size);
--#{$prefix}tooltip-color: #{$tooltip-color};
--#{$prefix}tooltip-bg: #{$tooltip-bg};
--#{$prefix}tooltip-border-radius: #{$tooltip-border-radius};
--#{$prefix}tooltip-opacity: #{$tooltip-opacity};
--#{$prefix}tooltip-arrow-width: #{$tooltip-arrow-width};
--#{$prefix}tooltip-arrow-height: #{$tooltip-arrow-height};
ސާސް ވެރިއޭބަލްސް އެވެ
$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: null; // TODO: remove this in v6
$tooltip-arrow-width: .8rem;
$tooltip-arrow-height: .4rem;
// fusv-disable
$tooltip-arrow-color: null; // Deprecated in Bootstrap 5.2.0 for CSS variables
// fusv-enable
ބޭނުން ކުރުން
ޓޫލްޓިޕް ޕްލަގިން އިން ޑިމާންޑް ކުރުމުން ކޮންޓެންޓާއި މާކަޕް އުފައްދާއިރު، ޑިފޯލްޓްކޮށް ޓޫލްޓިޕްތައް އެމީހުންގެ ޓްރިގަރ އެލިމެންޓްގެ ފަހަތުގައި ބެހެއްޓޭނެއެވެ.
ޖާވާސްކްރިޕްޓް މެދުވެރިކޮށް ޓޫލްޓިޕް ޓްރިގަރ ކުރާށެވެ:
const exampleEl = document.getElementById('example')
const tooltip = new bootstrap.Tooltip(exampleEl, options)
އޯވަރފްލޯ auto
އާއި ...scroll
ޓޫލްޓިޕް ޕޮޒިޝަން އޮޓޮމެޓިކުން ބަދަލުވާން މަސައްކަތް ކުރަނީ ބެލެނިވެރި ކޮންޓެއިނަރެއްގައި އަޅުގަނޑުމެންގެ overflow: auto
, އެކަމަކު އަދިވެސް އަސްލު ޕްލޭސްމަންޓްގެ ޕޮޒިޝަން ބެހެއްޓޭ. މިކަން ހައްލުކުރުމަށްޓަކައި، ޑިފޯލްޓް ވެލިއު އޯވަރރައިޑް ކުރުމަށް އޮޕްޝަން (އޮޕްޝަން ބޭނުންކޮށްގެން ފްލިޕް މޮޑިފައިއަރ އަށް ) އެއްވެސް HTMLElement އަށް ސެޓް ކުރާށެވެ، , ފަދައިން :overflow: scroll
.table-responsive
boundary
popperConfig
'clippingParents'
document.body
const tooltip = new bootstrap.Tooltip('#example', {
boundary: document.body // or document.querySelector('#boundary')
})
މާކަޕް
ޓޫލްޓިޕަކަށް ބޭނުންވާ މާކަޕަކީ ހަމައެކަނި data
އެޓްރިބިއުޓެއް ކަމަށާއި title
އެޗްޓީއެމްއެލް އެލިމެންޓްގައި ޓޫލްޓިޕް އެއް ހުންނަން ބޭނުންވާ ކަމަށް ވެސް ވިދާޅުވި އެވެ. ޓޫލްޓިޕްގެ ޖެނެރޭޓް ކުރެވޭ މާކަޕް އަކީ ތަންކޮޅެއް ސާދާ އެއްޗެއް ނަމަވެސް، އެއަށް ޕޮޒިޝަނެއް ބޭނުންވާ ނަމަވެސް (ޑިފޯލްޓްކޮށް، top
ޕްލަގިން އިން ސެޓް ކޮށްފައި ހުންނަނީ) އެވެ.
ކީބޯޑާއި އެސިސްޓިވް ޓެކްނޮލޮޖީ ބޭނުންކުރާ ފަރާތްތަކަށް ޓޫލްޓިޕްސް ފައިދާހުރި ގޮތަކަށް ހެދުން
އެޗްޓީއެމްއެލް އެލިމެންޓްތަކަށް އިތުރުކުރަންވާނީ ހަމައެކަނި ސަގާފީ ގޮތުން ކީބޯޑަށް ފޯކަސް ކުރެވޭ އަދި އިންޓަރެކްޓިވް (ލިންކް ނުވަތަ ފޯމް ކޮންޓްރޯލް ފަދަ) އެލިމެންޓްތަކަށެވެ. އެޓްރިބިއުޓް އިތުރުކޮށްގެން އަމިއްލައަށް އެޗްޓީއެމްއެލް އެލިމެންޓްތައް ( <span>
s ފަދަ) ފޯކަސް ކުރެވޭ ގޮތަށް ހެދިދާނެ ނަމަވެސް tabindex="0"
، މިއީ ކީބޯޑް ބޭނުންކުރާ ފަރާތްތަކަށް ނޮން އިންޓަރެކްޓިވް އެލިމެންޓްތަކުގައި އުނދަގޫ އަދި އޮޅުން ބޮޅުން ބޮޑު ޓެބް ސްޓޮޕްތައް އިތުރުވާނެ ކަމެކެވެ. މީގެ އިތުރުން، ތިބާގެ ޓޫލްޓިޕްގެ ޓްރިގަރއެއްގެ ގޮތުގައި ހަމައެކަނި ބަރޯސާ ނުވާށެވެ hover
، މިއީ ކީބޯޑް ބޭނުންކުރާ ފަރާތްތަކަށް ތިބާގެ ޓޫލްޓިޕްތައް ޓްރިގަރ ކުރުން މުސްތަޙީލު ވެގެންދާނެ ކަމެކެވެ.
<!-- HTML to write -->
<a href="#" data-bs-toggle="tooltip" data-bs-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>
ނުކުޅެދުންތެރިކަން ހުންނަ އެލިމެންޓްތަކެވެ
އެޓްރިބިއުޓް އެކުލެވޭ އެލިމެންޓްތަކަކީ disabled
އިންޓަރެކްޓިވް އެއްޗެހި ނޫން، މާނައަކީ ޓޫލްޓިޕް (ނުވަތަ ޕޮޕޯވަރ) ޓްރިގަރ ކުރުމަށް ޔޫޒަރުންނަށް ފޯކަސް، ހޯވަރ، ނުވަތަ ކްލިކް ނުކުރެވޭނެއެވެ. ވޯކްއަރައުންޑެއްގެ ގޮތުގައި، ތިބާ ބޭނުންވާނީ ރެޕަރަކުން ޓޫލްޓިޕް ޓްރިގަރ ކުރަން <div>
ނުވަތަ <span>
, އެންމެ ރަނގަޅީ ކީބޯޑަށް ފޯކަސް ކުރެވޭ ގޮތަށް ހަދާފައި ބޭނުންކޮށްގެން tabindex="0"
.
<span class="d-inline-block" tabindex="0" data-bs-toggle="tooltip" data-bs-title="Disabled tooltip">
<button class="btn btn-primary" type="button" disabled>Disabled button</button>
</span>
އިޚްތިޔާރުތައް
ޑޭޓާ އެޓްރިބިއުޓްސް ނުވަތަ ޖާވާސްކްރިޕްޓް މެދުވެރިކޮށް އޮޕްޝަންތައް ފާސްކުރެވޭތީ data-bs-
، ގައިވާ ފަދައިން އޮޕްޝަން ނަމެއް އަށް އިތުރުކުރެވިދާނެއެވެ data-bs-animation="{value}"
. ޑޭޓާ އެޓްރިބިއުޓްސް މެދުވެރިކޮށް އޮޕްޝަންތައް ފާސްކުރާއިރު އޮޕްޝަން ނަމުގެ ކޭސް ޓައިޕް “ camelCase ” އިން “ kebab -case ” އަށް ބަދަލުކުރުން ޔަގީންކުރައްވާށެވެ. މިސާލަކަށް data-bs-custom-class="beautifier"
ގެ ބަދަލުގައި ބޭނުން ކުރާށެވެ data-bs-customClass="beautifier"
.
ބޫޓްސްޓްރެޕް 5.2.0 އިން ފެށިގެން، ހުރިހާ ކޮމްޕޯނެންޓްތަކުންވެސް ޖޭއެސްއޯއެން ސްޓްރިންގއެއްގެ ގޮތުގައި ސާދާ ކޮމްޕޮނެންޓް ކޮންފިގްރޭޝަން ބެހެއްޓޭނެ އެކްސްޕެރިމެންޓަލް ރިޒާވްޑް ޑޭޓާ އެޓްރިބިއުޓަކަށް ސަޕޯޓްކުރެއެވެ. data-bs-config
އެލިމެންޓެއްގައި data-bs-config='{"delay":0, "title":123}'
އަދި data-bs-title="456"
އެޓްރިބިއުޓްސް ހުންނައިރު، ފައިނަލް title
ވެލިއު ވާނީ 456
އަދި ވަކި ޑޭޓާ އެޓްރިބިއުޓްސް އިން ދީފައިވާ ވެލިއުތައް އޯވަރރައިޑް ވާނެއެވެ data-bs-config
. މީގެ އިތުރުން މިހާރު ހުރި ޑޭޓާ އެޓްރިބިއުޓްތަކުގައި ޖޭއެސްއޯއެން ވެލިއުތައް ބެހެއްޓޭނެއެވެ data-bs-delay='{"show":0,"hide":150}'
.
sanitize
,
sanitizeFn
, އަދި
allowList
އޮޕްޝަންތައް ސަޕްލައި ނުކުރެވޭނެކަން ފާހަގަކޮށްލެވެއެވެ.
ނަން | ވައްތަރު | ޑީފޯލްޓް | ތަފްޞީލު |
---|---|---|---|
allowList |
އެއްޗެއް | ޑިފޯލްޓް ވެލިއު | ހުއްދަ ލިބިފައިވާ އެޓްރިބިއުޓްތަކާއި ޓެގްތައް ހިމެނޭ އެއްޗެއް. |
animation |
ބޫލިއަން އެވެ | true |
ޓޫލްޓިޕް އަށް ސީއެސްއެސް ފޭޑް ޓްރާންސިޝަން އެއް އެޕްލައި ކުރާށެވެ. |
boundary |
ސްޓްރިންގް، އެލިމެންޓް | 'clippingParents' |
ޓޫލްޓިޕްގެ އޯވަރފްލޯ ކޮންސްޓްރެއިންޓް ބައުންޑަރީ (އެޕްލައި ކުރެވެނީ ހަމައެކަނި ޕޮޕަރގެ preventOverflow މޮޑިފައިޓަރ އަށް). ބައި ޑިފޯލްޓްކޮށް، އެއީ 'clippingParents' އެޗްޓީއެމްއެލްއެލިމެންޓް ރެފަރެންސެއް (އެކަނި ޖާވާސްކްރިޕްޓް މެދުވެރިކޮށް) ބަލައިގަނެވޭނެ އަދި ބަލައިގަނެވޭނެ އެއްޗެކެވެ. އިތުރު މަޢުލޫމާތު ހޯދުމަށް ޕޮޕަރގެ ޑިޓެކްޓްއޮވަރފްލޯ ޑޮކްސް އަށް ރިޢާޔަތް ކުރައްވާށެވެ . |
container |
ސްޓްރިންގް، އެލިމެންޓް، ފޯލްސް | false |
ވަކި އެލިމެންޓަކަށް ޓޫލްޓިޕް އިތުރުކުރެއެވެ. މިސާލު: container: 'body' . މި އިޚްތިޔާރަކީ ޚާއްޞަކޮށް ބޭނުންތެރި އިޚްތިޔާރަކީ ޓްރިގަރިންގ އެލިމެންޓް ކައިރީގައި ޑޮކިއުމަންޓްގެ ފްލޯގައި ޓޫލްޓިޕް ބެހެއްޓޭނެ ގޮތް ހެދުމެވެ - މިއީ ވިންޑޯ ރީސައިޒް ކުރާއިރު ޓޫލްޓިޕް ޓްރިގަރިންގ އެލިމެންޓާ ދުރަށް ފްލޯޓް ނުކުރެވޭނެ ގޮތެކެވެ. |
customClass |
ސްޓްރިންގް، ފަންކްޝަން | '' |
ޓޫލްޓިޕް ދައްކާއިރު ކްލާސްތައް އިތުރުކުރުން. މި ކްލާސްތައް ޓެމްޕްލޭޓްގައި ކަނޑައެޅިފައިވާ އެއްވެސް ކްލާހެއްގެ އިތުރުން އިތުރުކުރެވޭނެކަން ފާހަގަކޮށްލެވެއެވެ. އެތައް ކްލާހެއް އިތުރުކުރުމަށްޓަކައި، އެ ކްލާސްތައް ވަކިކޮށް ޖާގަ ދީގެން: 'class-1 class-2' . އަދި އިތުރު ކްލާސް ނަންތައް ހިމެނޭ އެއް ސްޓްރިންގް ރިޓަރން ކުރަންޖެހޭ ފަންކްޝަނެއް ވެސް ޕާސް ކުރެވިދާނެއެވެ. |
delay |
ނަންބަރު، އެއްޗެއް | 0 |
ޓޫލްޓިޕް (ms) ދައްކައި ފޮރުވުން ލަސްކުރުން—މެނުއަލް ޓްރިގަރ ޓައިޕް އަށް ނުހިނގާނެއެވެ. ނަންބަރެއް ފޯރުކޮށްދީފިނަމަ، ފޮރުވާ/ދައްކާ ދެ ގޮތަށް ވެސް ޑިލޭ ޖަހައެވެ. އެއްޗެއްގެ އޮނިގަނޑަކީ: delay: { "show": 500, "hide": 100 } . |
fallbackPlacements |
އެރޭ އެވެ | ['top', 'right', 'bottom', 'left'] |
އެރޭގައި ޕްލޭސްމަންޓްތަކުގެ ލިސްޓެއް ފޯރުކޮށްދީގެން (އިސްކަންދޭ ތަރުތީބުން) ފޯލްބެކް ޕްލޭސްމަންޓްތައް މާނަކުރުން. އިތުރު މަޢުލޫމާތު ހޯދުމަށް ޕޮޕަރގެ ސުލޫކު ޑޮކްސް އަށް ރިޢާޔަތް ކުރައްވާށެވެ . |
html |
ބޫލިއަން އެވެ | false |
ޓޫލްޓިޕްގައި އެޗްޓީއެމްއެލް އަށް ހުއްދަ ދޭށެވެ. ތެދެއްނަމަ ޓޫލްޓިޕްގެ އެޗްޓީއެމްއެލް ޓެގްތައް ޓޫލްޓިޕްގައި title ރެންޑަރ ކުރެވޭނެއެވެ. ދޮގު ނަމަ، innerText ޕްރޮޕަޓީ ބޭނުންކޮށްގެން ޑީއޯއެމް އަށް ކޮންޓެންޓް ވައްދާނެއެވެ. އެކްސްއެސްއެސް ހަމަލާތަކާ މެދު ކަންބޮޑުވާނަމަ ޓެކްސްޓް ބޭނުން ކުރާށެވެ. |
offset |
އެރޭ، ސްޓްރިންގް، ފަންކްޝަން | [0, 0] |
ޓޫލްޓިޕް އޭގެ ޓާގެޓަށް ނިސްބަތްކޮށް އޮފްސެޓް ކުރުން. ކޮމާ ވަކިކޮށްފައިވާ އަގުތަކާއެކު ޑޭޓާ އެޓްރިބިއުޓްތަކުގައި ސްޓްރިންގއެއް ޕާސްކުރެވިދާނެއެވެ: data-bs-offset="10,20" . އޮފްސެޓް ކަނޑައެޅުމަށް ފަންކްޝަނެއް ބޭނުންކުރާއިރު، އެއަށް ގޮވަނީ އޭގެ ފުރަތަމަ އަރގިއުމެންޓްގެ ގޮތުގައި ޕޮޕަރ ޕްލޭސްމަންޓާއި، ރެފަރެންސް، އަދި ޕޮޕަރ ރެކްޓްސް ހިމެނޭ އޮބްޖެކްޓަކުންނެވެ. ދެވަނަ އަރގިއުމެންޓްގެ ގޮތުގައި ޓްރިގަރިންގ އެލިމެންޓް ޑީއޯއެމް ނޯޑް ފާސްކުރެއެވެ. ފަންކްޝަން ރިޓަރން ކުރަން ޖެހޭނީ ދެ ނަންބަރެއް ހިމެނޭ އެރޭއެއް: skidding , distance . އިތުރު މަޢުލޫމާތު ހޯދުމަށް ޕޮޕަރގެ އޮފްސެޓް ޑޮކްސް އަށް ރިޢާޔަތް ކުރައްވާށެވެ . |
placement |
ސްޓްރިންގް، ފަންކްޝަން | 'top' |
ޓޫލްޓިޕް ޕޮޒިޝަން ކުރާނެ ގޮތް: އޮޓޯ، މަތީ، ތިރީ، ކަނާތް، ވާތް. auto ކަނޑައެޅިއްޖެނަމަ، އެއީ ޑައިނަމިކް ގޮތެއްގައި ޓޫލްޓިޕް ރީއޮރިއެންޓް ކުރާނެއެވެ . ޕްލޭސްމަންޓް ކަނޑައެޅުމަށް ފަންކްޝަނެއް ބޭނުންކުރާއިރު، އެ ފަންކްޝަނަށް ގޮވާލަނީ އޭގެ ފުރަތަމަ އަރގިއުމެންޓްގެ ގޮތުގައި ޓޫލްޓިޕް ޑީއޯއެމް ނޯޑް އަދި ދެވަނަ އަރގިއުމެންޓްގެ ގޮތުގައި ޓްރިގަރިންގ އެލިމެންޓް ޑީއޯއެމް ނޯޑް ހިފައިގެންނެވެ. ކޮންޓެކްސްޓް this ސެޓްކޮށްފައިވަނީ ޓޫލްޓިޕް އިންސްޓޭންސް އަށެވެ. |
popperConfig |
null، އޮބްޖެކްޓް، ފަންކްޝަން | null |
ބޫޓްސްޓްރެޕްގެ ޑިފޯލްޓް ޕޮޕަރ ކޮންފިގް ބަދަލުކުރުމަށްޓަކައި، ޕޮޕަރގެ ކޮންފިގްރޭޝަން ބައްލަވާށެވެ . ޕޮޕަރ ކޮންފިގްރޭޝަން އުފެއްދުމަށް ފަންކްޝަނެއް ބޭނުންކުރާއިރު، އެއަށް ގޮވަނީ ބޫޓްސްޓްރެޕްގެ ޑިފޯލްޓް ޕޮޕަރ ކޮންފިގްރޭޝަން ހިމެނޭ އޮބްޖެކްޓަކުންނެވެ. އެއީ ޑިފޯލްޓް ބޭނުންކޮށް އަމިއްލަ ކޮންފިގްރޭޝަން އާއި އެއްކޮށްލުމަށް އެހީތެރިވެދޭ އެއްޗެކެވެ. ފަންކްޝަން އިން ޕޮޕަރ އަށް ކޮންފިގްރޭޝަން އޮބްޖެކްޓެއް ރިޓަރން ކުރަން ޖެހެއެވެ. |
sanitize |
ބޫލިއަން އެވެ | true |
ސެނިޓައިޒޭޝަން އެނެބަލް ނުވަތަ ޑިސެބަލް ކުރުން. If activated 'template' , 'content' އަދި 'title' އޮޕްޝަންތައް ސެނިޓައިޒް ކުރެވޭނެއެވެ. |
sanitizeFn |
null، ފަންކްޝަން | null |
މިތަނުން އަމިއްލައަށް ސެނިޓައިޒް ފަންކްޝަން ސަޕްލައި ކުރެވޭނެއެވެ. މިއީ ސެނިޓައިޒޭޝަން ކުރުމަށް ޚާއްޞަ ލައިބްރަރީއެއް ބޭނުން ކުރަން އިސްކަންދޭނަމަ ބޭނުންތެރި ކަމަކަށް ވެދާނެއެވެ. |
selector |
ސްޓްރިންގް، ދޮގު | false |
ސެލެކްޓަރެއް ފޯރުކޮށްދީފިނަމަ، ޓޫލްޓިޕް އޮބްޖެކްޓްތައް ކަނޑައެޅިފައިވާ ޓާގެޓްތަކަށް ޑެލިގޭޓް ކުރެވޭނެއެވެ. ޢަމަލީގޮތުން ބަލާއިރު، މިއީ ޑައިނަމިކް ގޮތެއްގައި އިތުރުކުރެވޭ ޑީއޯއެމް އެލިމެންޓްތަކަށް ( jQuery.on ސަޕޯޓް) ޓޫލްޓިޕްސް ވެސް އަމަލުކުރުމަށް ބޭނުންކުރާ އެއްޗެކެވެ. މި މައްސަލައާއި މަޢުލޫމާތު ގިނަ މިސާލެއް ބައްލަވާށެވެ . |
template |
ސްޓްރިންގ | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
ޓޫލްޓިޕް އުފައްދާއިރު ބޭނުންކުރާނެ އެޗްޓީއެމްއެލް ބޭސްކުރުން. ޓޫލްޓިޕްގެ title ތެރެއަށް އިންޖެކްޓް ކުރެވޭނެއެވެ .tooltip-inner . .tooltip-arrow ޓޫލްޓިޕްގެ ތިރިއަށް ވެގެންދާނެއެވެ. އެންމެ ބޭރުގައި ހުންނަ ރެޕަރ އެލިމެންޓްގައި .tooltip ކްލާސް އަދި role="tooltip" . |
title |
ސްޓްރިންގް، އެލިމެންޓް، ފަންކްޝަން | '' |
title އެޓްރިބިއުޓް ނެތްނަމަ ޑިފޯލްޓް ޓައިޓަލް ވެލިއު . ފަންކްޝަނެއް ދީފިނަމަ، އެއަށް ގޮވާނީ އޭގެ this ރެފަރެންސް ސެޓްކޮށްގެން ޕޮޕޯވަރ އެޓޭޗްކޮށްފައިވާ އެލިމެންޓަށް ސެޓްކޮށްގެންނެވެ. |
trigger |
ސްޓްރިންގ | 'hover focus' |
ޓޫލްޓިޕް ޓްރިގަރ ކުރާ ގޮތް: ކްލިކް، ހޯވަރ، ފޯކަސް، މެނުއަލް. އެތައް ޓްރިގަރެއް ފާސްވެދާނެ؛ އެތަކެތި ވަކިކޮށް ޖާގައެއް ދީގެންނެވެ. 'manual' ޓޫލްޓިޕް ޕްރޮގްރާމެޓިކަލީ ޓްރިގަރ ވާނީ .tooltip('show') , .tooltip('hide') އަދި .tooltip('toggle') މެތޯޑްސް މެދުވެރިކޮށްކަން އަންގައިދެއެވެ؛ މި އަގު އެހެން އެއްވެސް ޓްރިގަރަކާ ގުޅުވައި ނުލެވޭނެއެވެ. 'hover' އަމިއްލައަށް ކީބޯޑް މެދުވެރިކޮށް ޓްރިގަރ ނުކުރެވޭ ޓޫލްޓިޕްތައް އުފެދިގެންދާނެ ކަމަށާއި، ބޭނުންކުރަންވާނީ ކީބޯޑް ބޭނުންކުރާ ފަރާތްތަކަށް އެއް މައުލޫމާތު ފޯރުކޮށްދިނުމަށް ބަދަލު ގޮތްތަކެއް ހުރިނަމަ އެކަންޏެވެ. |
ވަކިވަކި ޓޫލްޓިޕްތަކަށް ޑޭޓާ އެޓްރިބިއުޓްސް
ވަކިވަކި ޓޫލްޓިޕްތަކުގެ އިޚްތިޔާރުތައް، މަތީގައި ބަޔާންކޮށްފައިވާ ފަދައިން، ޑޭޓާ އެޓްރިބިއުޓްތައް ބޭނުންކުރުމުގެ ތެރެއިން ބަދަލު ގޮތަކަށް ކަނޑައެޅިދާނެއެވެ.
ފަންކްޝަން ބޭނުންކޮށްގެން ބޭނުންކޮށްގެންpopperConfig
const tooltip = new bootstrap.Tooltip(element, {
popperConfig(defaultBsPopperConfig) {
// const newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
ގޮތްތައް
އެސިންކްރޮނަސް މެތޯޑްސް އާއި ޓްރާންސިޝަންސް
ހުރިހާ އެޕީއައި މެތޯޑްތަކަކީ އެސިންކްރޮނަސް މެތޯޑްތަކެއް ކަމުން ޓްރާންސިޝަނެއް ފެށެއެވެ . އެމީހުން އެނބުރި ގުޅާ މީހާއަށް ޓްރާންސިޝަން ފެށުނުހާ އަވަހަކަށް އެކަމަކު ނިމުމުގެ ކުރިން . މީގެ އިތުރުން ޓްރާންސިޝަން ކޮމްޕޮނެންޓެއްގައި މެތޯޑް ކޯލެއް ކުރާއިރު އަޅާނުލެވޭނެއެވެ .
އިތުރު މަޢުލޫމާތު ހޯދުމަށް އަޅުގަނޑުމެންގެ ޖާވާސްކްރިޕްޓް ޑޮކިއުމަންޓޭޝަން ބައްލަވާށެވެ .
ގޮތް | ތަފްޞީލު |
---|---|
disable |
އެލިމެންޓެއްގެ ޓޫލްޓިޕް ދައްކާނެ ޤާބިލުކަން ނައްތާލައެވެ. ޓޫލްޓިޕް ދައްކާލެވޭނީ އަލުން އެނެބަލް ކޮށްފިނަމައެވެ. |
dispose |
އެލިމެންޓެއްގެ ޓޫލްޓިޕް ފޮރުވައި ނައްތާލައެވެ (ޑޮމް އެލިމެންޓުގައި ރައްކާކޮށްފައިވާ ޑޭޓާ ނައްތާލައެވެ). ޑެލިގޭޝަން ބޭނުންކުރާ ޓޫލްޓިޕްތައް (އެއީ އޮޕްޝަން ބޭނުންކޮށްގެން އުފައްދާފައިވާ ތަކެތިselector ) ޑެސެންޑެންޓް ޓްރިގަރ އެލިމެންޓްތަކުގައި ވަކިވަކިން ނައްތާލެވޭކަށް ނެތެވެ. |
enable |
އެލިމެންޓެއްގެ ޓޫލްޓިޕް އަށް ދައްކާނެ ޤާބިލުކަން ލިބިދެއެވެ. ޓޫލްޓިޕްސް ޑިފޯލްޓްކޮށް އެނެބަލް ކޮށްފައި ހުރެއެވެ. |
getInstance |
ޑޮމް އެލިމެންޓަކާ ގުޅިފައިވާ ޓޫލްޓިޕް އިންސްޓޭންސް ހޯދުމަށް، ނުވަތަ އިނިޝިއަލައިޒް ނުކުރެވުނު ހާލަތެއްގައި އާ އެއްޗެއް އުފެއްދުމުގެ ފުރުސަތު ލިބޭ ސްޓޭޓިކް މެތޯޑެކެވެ. |
getOrCreateInstance |
ޑޮމް އެލިމެންޓަކާ ގުޅިފައިވާ ޓޫލްޓިޕް އިންސްޓޭންސް ހޯދުމަށް، ނުވަތަ އިނިޝިއަލައިޒް ނުކުރެވުނު ހާލަތެއްގައި އާ އެއްޗެއް އުފެއްދުމުގެ ފުރުސަތު ލިބޭ ސްޓޭޓިކް މެތޯޑެކެވެ. |
hide |
އެލިމެންޓެއްގެ ޓޫލްޓިޕް ފޮރުވައެވެ. ޓޫލްޓިޕް ހަގީގަތުގައި ފޮރުވުމުގެ ކުރިން (އެބަހީ hidden.bs.tooltip އިވެންޓް ހިނގުމުގެ ކުރިން) ކޯލަރަށް އެނބުރި ދެއެވެ. މިއީ ޓޫލްޓިޕްގެ “މެނުއަލް” ޓްރިގަރިންގ އެއް ކަމުގައި ބެލެވެއެވެ. |
setContent |
ޓޫލްޓިޕްގެ ކޮންޓެންޓް އިނިޝިއަލައިޒް ކުރުމަށްފަހު ބަދަލުކުރެވޭނެ ގޮތެއް ދެއެވެ. |
show |
އެލިމެންޓެއްގެ ޓޫލްޓިޕް ހާމަކުރެއެވެ. ޓޫލްޓިޕް ހަގީގަތުގައި ދައްކާލުމުގެ ކުރިން (އެބަހީ shown.bs.tooltip އިވެންޓް ހިނގުމުގެ ކުރިން) ކޯލަރަށް އެނބުރި ދެއެވެ. މިއީ ޓޫލްޓިޕްގެ “މެނުއަލް” ޓްރިގަރިންގ އެއް ކަމުގައި ބެލެވެއެވެ. ޒީރޯ ދިގުމިނުގެ ސުރުޚީތައް ހުންނަ ޓޫލްޓިޕްތައް ދުވަހަކުވެސް ނުފެނެއެވެ. |
toggle |
އެލިމެންޓެއްގެ ޓޫލްޓިޕް ޓޮގްލް ކުރެއެވެ. ޓޫލްޓިޕް ހަގީގަތުގައި ދައްކާ ނުވަތަ ފޮރުވުމުގެ ކުރިން (އެބަހީ shown.bs.tooltip ނުވަތަ hidden.bs.tooltip އިވެންޓް ހިނގުމުގެ ކުރިން) ކޯލަރަށް އެނބުރިދެއެވެ. މިއީ ޓޫލްޓިޕްގެ “މެނުއަލް” ޓްރިގަރިންގ އެއް ކަމުގައި ބެލެވެއެވެ. |
toggleEnabled |
އެލިމެންޓެއްގެ ޓޫލްޓިޕް ދައްކާ ނުވަތަ ފޮރުވުމުގެ ޤާބިލުކަން ޓޮގްލް ކުރެއެވެ. |
update |
އެލިމެންޓެއްގެ ޓޫލްޓިޕްގެ މަޤާމު އަޕްޑޭޓް ކުރެއެވެ. |
const tooltip = bootstrap.Tooltip.getInstance('#example') // Returns a Bootstrap tooltip instance
// setContent example
tooltip.setContent({ '.tooltip-inner': 'another title' })
setContent
މެތޯޑުން
object
އަރގިއުމެންޓެއް ބަލައިގަންނައިރު، ކޮންމެ ޕްރޮޕަޓީ-ކީއަކީ
string
ޕޮޕޯވަރ ޓެމްޕްލޭޓްގެ ތެރޭގައި ސައްހަ ސެލެކްޓަރެއް، އަދި ގުޅުންހުރި ކޮންމެ ޕްރޮޕަޓީ-ވެލިއުއަކީ
string
|
element
|
function
|
null
އިވެންޓްސް
ހަރަކާތް | ތަފްޞީލު |
---|---|
hide.bs.tooltip |
މި އިވެންޓް ވަގުތުން ފަޔަރ ކުރެވެނީ hide އިންސްޓޭންސް މެތޯޑަށް ގޮވާ ނިމުމުންނެވެ. |
hidden.bs.tooltip |
މި އިވެންޓް ފަޔަރ ކުރެވެނީ ޕޮޕޯވަރ ޔޫޒަރަށް ފޮރުވުން ނިމުމުން (ސީއެސްއެސް ޓްރާންސިޝަންތައް ފުރިހަމަވާންދެން މަޑުކުރާނެ) އެވެ. |
inserted.bs.tooltip |
މި އިވެންޓް ފަޔަރ ކުރެވެނީ show.bs.tooltip އިވެންޓަށްފަހު ޓޫލްޓިޕް ޓެމްޕްލޭޓް ޑީއޯއެމްއަށް އިތުރުކޮށްފައިވުމުންނެވެ. |
show.bs.tooltip |
މި އިވެންޓް ވަގުތުން ފަޔަރ ވެގެން ދަނީ show އިންސްޓޭންސް މެތޯޑް ގޮވާލުމުންނެވެ. |
shown.bs.tooltip |
މި އިވެންޓް ފަޔަރ ކުރެވެނީ ޕޮޕޯވަރ ޔޫޒަރަށް ފެންނަ ގޮތަށް ހެދުމުން (ސީއެސްއެސް ޓްރާންސިޝަންތައް ފުރިހަމަވާންދެން މަޑުކުރާނެ) އެވެ. |
const myTooltipEl = document.getElementById('myTooltip')
const tooltip = bootstrap.Tooltip.getOrCreateInstance(myTooltipEl)
myTooltipEl.addEventListener('hidden.bs.tooltip', () => {
// do something...
})
tooltip.hide()