ޖާވާސްކްރިޕްޓް
ޖޭކުއަރީގައި ބިނާކޮށްފައިވާ އަޅުގަނޑުމެންގެ އިޚްތިޔާރީ ޖާވާސްކްރިޕްޓް ޕްލަގިންސްތަކާއެކު ބޫޓްސްޓްރެޕް ދިރުވާލާށެވެ. ކޮންމެ ޕްލަގިންއަކާ ބެހޭގޮތުން، އަޅުގަނޑުމެންގެ ޑޭޓާއާއި، ޕްރޮގްރާމެޓިކް އެޕީއައި އޮޕްޝަންތަކާއި، އަދިވެސް އެތައް ކަމެއް ދަސްކުރައްވާށެވެ.
ޕްލަގިންތައް ވަކިވަކިން ހިމަނާލެވިދާނެ (ބޫޓްސްޓްރެޕްގެ ވަކިވަކި *.js
ފައިލްތައް ބޭނުންކޮށްގެން)، ނުވަތަ އެއްފަހަރާ ބޭނުންކޮށްގެން bootstrap.js
ނުވަތަ މިނިފައިޑްކޮށް bootstrap.min.js
(އެދެ ފައިލްތައްވެސް ނުހިމަނާ) ޕްލަގިންތައް ހިމަނާލެވިދާނެއެވެ.
ބައެއް ޕްލަގިންސް އާއި ސީއެސްއެސް ކޮމްޕޯނެންޓްތައް ބަރޯސާވެފައިވަނީ އެހެން ޕްލަގިންސް ތަކުގެ މައްޗަށެވެ. ވަކިވަކިން ޕްލަގިންސް ހިމަނާނަމަ، ޑޮކްސްގައި މި ޑިޕެންޑެންސީތައް ޗެކްކުރުން ޔަގީންކުރައްވާށެވެ. އަދި ހުރިހާ ޕްލަގިންތަކެއް ބަރޯސާވެފައިވަނީ ޖޭކުއަރީއަށްކަން ފާހަގަކޮށްލަން (މީގެ މާނައަކީ ޕްލަގިން ފައިލްތަކުގެ ކުރިން ޖޭކުއަރީ ހިމަނަން ޖެހޭނެ ކަމެވެ ). ޖޭކުއަރީގެ ކޮން ވަރޝަންތަކަށް ސަޕޯޓް ކުރެވޭތޯ ބަލަން އަޅުގަނޑުމެންގެ ކޮންސަލްޓް ކުރާށެވެ.package.json
އަޅުގަނޑުމެންގެ ޑްރޮޕްޑައުންސް، ޕޮޕޯވަރސް އަދި ޓޫލްޓިޕްސް ވެސް ބަރޯސާވެފައިވަނީ Popper.js އަށެވެ .
ގާތްގަނޑަކަށް ހުރިހާ ބޫޓްސްޓްރެޕް ޕްލަގިންސް އެއް އެކަނި އެޗްޓީއެމްއެލް މެދުވެރިކޮށް ޑޭޓާ އެޓްރިބިއުޓްތަކާއެކު އެނެބަލްކޮށް ކޮންފިގްރޭޓް ކުރެވޭނެ (ޖާވާސްކްރިޕްޓް ފަންކްޝަނަލިޓީ ބޭނުން ކުރުމަށް އަޅުގަނޑުމެން އިސްކަންދޭ ގޮތް). އެއް އެލިމެންޓެއްގައި ޑޭޓާ އެޓްރިބިއުޓްތަކުގެ އެއް ސެޓް ބޭނުންކުރުން ޔަގީންކުރައްވާ (މިސާލަކަށް، އެއް ބަޓަނަކުން ޓޫލްޓިޕް އަދި މޮޑަލް ޓްރިގަރ ނުކުރެވޭނެއެވެ.)
ނަމަވެސް ބައެއް ހާލަތްތަކުގައި މި ފަންކްޝަނަލިޓީ ޑިސެބިލް ކުރުމަކީ އެދެވިގެން ވެދާނެ ކަމެކެވެ. ޑޭޓާ އެޓްރިބިއުޓް އެޕީއައި ޑިސެބިލް ކުރުމަށްޓަކައި، ޑޮކިއުމަންޓް ނަންސްޕޭސް ކޮށްފައިވާ ހުރިހާ އިވެންޓްތަކެއް އަންބައިންޑް ކުރާށެވެ data-api
:
ނުވަތަ ވަކި ޕްލަގިންއަކަށް ޓާގެޓް ކުރުމަށްޓަކައި، ހަމައެކަނި ޕްލަގިންގެ ނަން ނަންސްޕޭސްއެއްގެ ގޮތުގައި ޑޭޓާ-އޭޕީއައި ނޭމްސްޕޭސްއާއެކު މިގޮތަށް ހިމަނާށެވެ:
ބޫޓްސްޓްރަޕް އިން ގިނަ ޕްލަގިންސްތަކުގެ ޔުނިކް އެކްޝަންތަކަށް ކަސްޓަމް އިވެންޓްތައް ފޯރުކޮށްދެއެވެ. އާންމު ގޮތެއްގައި މިކަންކަން އަންނަނީ އިންފިނިޓިވް އަދި މާޒީގެ ޕާޓިސިޕަލް ފޯމެއްގައި - މިތަނުގައި އިންފިނިޓިވް (ex. show
) ހާދިސާއެއް ފެށުމުން ޓްރިގަރ ކުރެވި، އޭގެ މާޒީ ޕާޓިސިޕަލް ފޯމް (ex. shown
) ޓްރިގަރ ކުރެވެނީ ޢަމަލެއް ފުރިހަމަވުމުންނެވެ.
ހުރިހާ އިންފިނިޓިވް އިވެންޓްތަކުން ވެސް preventDefault()
ފަންކްޝަނަލިޓީ ފޯރުކޮށްދެއެވެ. މިއީ ޢަމަލެއް ފެށުމުގެ ކުރިން އެ ޢަމަލެއް ހިންގުން ހުއްޓުވުމުގެ ޤާބިލުކަން ލިބިގެންދާ ކަމެކެވެ. އިވެންޓް ހެންޑްލަރ އިން ފޯލްސް ރިޓަރން ކުރުމުން ވެސް އޮޓޮމެޓިކުން ގޮވާނެއެވެ preventDefault()
.
އަދި ބޫޓްސްޓްރެޕްގެ ހުރިހާ ޕްލަގިންސްތަކެއް ބޭނުންކުރެވޭނީ ހަމައެކަނި ޖާވާސްކްރިޕްޓް އެޕީއައި މެދުވެރިކޮށް ކަމަށް ވެސް އަޅުގަނޑުމެން ގަބޫލުކުރަމެވެ. ހުރިހާ ޕަބްލިކް އެޕީއައިތަކަކީ އެއް، ޗޭން ކުރެވޭ ގޮތްތަކެއް ކަމަށާއި، އެކްޓް ކުރެވުނު ކަލެކްޝަން ރިޓަރން ކުރާ އެއްޗެކެވެ.
ހުރިހާ މެތޯޑްތަކުންވެސް އިޚްތިޔާރީ އޮޕްޝަންސް އޮބްޖެކްޓެއް، ވަކި މެތޯޑަކަށް ޓާގެޓްކުރާ ސްޓްރިންގްއެއް، ނުވަތަ އެއްވެސް އެއްޗެއް (ޑިފޯލްޓް ސުލޫކާއެކު ޕްލަގިންއެއް އިނިޝިއޭޓްކުރާ) ބަލައިގަންނަންވާނެއެވެ:
ކޮންމެ ޕްލަގިންއަކުން ވެސް އޭގެ ރޯ ކޮންސްޓްރަކްޓަރ Constructor
ޕްރޮޕަޓީއެއްގެ މައްޗަށް ހާމަކުރެއެވެ: $.fn.popover.Constructor
. ވަކި ޕްލަގިން އިންސްޓޭންސްއެއް ހޯދަން ބޭނުންނަމަ، ސީދާ އެލިމެންޓަކުން ހޯދާށެވެ: $('[rel="popover"]').data('popover')
.
ހުރިހާ ޕްރޮގްރާމެޓިކް އެޕީއައި މެތޯޑްތަކަކީ އެސިންކްރޮނަސް މެތޯޑްތަކެއް ކަމަށާއި ޓްރާންސިޝަން ފެށުމުން އެކަމަކު ނިމުމުގެ ކުރިން ކޯލަރަށް އެނބުރި އަންނަ މެތޯޑްތަކެއް ކަމަށެވެ .
ޓްރާންސިޝަން ނިމުމުން ޢަމަލެއް އެގްޒެކެޓް ކުރުމަށްޓަކައި، އެއާ ގުޅޭ އިވެންޓެއް އަޑުއަހާލެވޭނެއެވެ.
މީގެ އިތުރުން ޓްރާންސިޝަން ކޮމްޕޮނެންޓެއްގައި މެތޯޑް ކޯލެއް ކުރާއިރު އަޅާނުލެވޭނެއެވެ .
ޕްލަގިންއެއްގެ ޑިފޯލްޓް ސެޓިންގސް ބަދަލުކުރެވޭނީ ޕްލަގިންގެ Constructor.Default
އޮބްޖެކްޓް ބަދަލުކޮށްގެންނެވެ:
ބައެއް ފަހަރު ބޫޓްސްޓްރެޕް ޕްލަގިންސްތައް އެހެން ޔޫއައި ފްރޭމްވޯކްތަކާއެކު ބޭނުންކުރަން ޖެހެއެވެ. މި ހާލަތްތަކުގައި ދޭތެރެ ދޭތެރެއިން ނޭމްސްޕޭސް ކޮލިޝަންތައް ދިމާވެދާނެ އެވެ. .noConflict
މިހެން ދިމާވެއްޖެނަމަ، އަގު އަނބުރާ ގެންނަން ބޭނުންވާ ޕްލަގިންއަށް ގޮވާލެވިދާނެއެވެ .
VERSION
ބޫޓްސްޓްރެޕްގެ ކޮންމެ ޖީކުއަރީ ޕްލަގިންއެއްގެ ވަރޝަނަށް ޕްލަގިންގެ ކޮންސްޓްރަކްޓަރުގެ ޕްރޮޕަޓީ މެދުވެރިކޮށް ވަދެވޭނެއެވެ . މިސާލަކަށް ޓޫލްޓިޕް ޕްލަގިން އަށް:
ޖާވާސްކްރިޕްޓް ޑިސެބިލް ކޮށްފައި ހުން��ައިރު ބޫޓްސްޓްރެޕްގެ ޕްލަގިންސްތައް ވަކިން ޝަރަފުވެރިކަމާއެކު ފަހަތަށް ނުޖެހެ އެވެ. މި ހާލަތުގައި ޔޫޒަރ އެކްސްޕީރިއަންސްއަށް ފަރުވާތެރިވާނަމަ، ޔޫޒަރުންނަށް <noscript>
ހާލަތު ބަޔާންކޮށްދިނުމަށް (އަދި ޖާވާސްކްރިޕްޓް އަލުން އެނެބަލް ކުރާނެ ގޮތް) ބޭނުންކޮށް، އަދި/ނުވަތަ އަމިއްލަ ކަސްޓަމް ފޯލްބެކްތައް އިތުރުކޮށްލާށެވެ.
ތިންވަނަ ފަރާތެއްގެ ލައިބްރަރީތަކެވެ
ބޫޓްސްޓްރެޕް އިން ޕްރޮޓޯޓައިޕް ނުވަތަ ޖޭކުއަރީ ޔޫއައި ފަދަ ތިންވަނަ ފަރާތެއްގެ ޖާވާސްކްރިޕްޓް ލައިބްރަރީތަކަށް ރަސްމީކޮށް ސަޕޯޓް ނުކުރެއެވެ . ނަމަވެސް .noConflict
އަދި ނަން ޖާގަ ކުރެވިފައިވާ އިވެންޓްތައް، ކޮމްޕެޓިބިލިޓީ މައްސަލަތައް ހުރެދާނެ ކަމަށާއި އެކަންކަން އަމިއްލައަށް ހައްލުކުރަން ޖެހޭ ކަމަށެވެ.
ބޫޓްސްޓްރެޕްގެ ހުރިހާ ޖާވާސްކްރިޕްޓް ފައިލްތަކެއް ޑިޕެންޑް ކޮށްފައި util.js
ހުންނައިރު އެއީ އެހެން ޖާވާސްކްރިޕްޓް ފައިލްތަކާ އެކު ހިމަނަން ޖެހޭ ފައިލްތަކެކެވެ. ކޮމްޕައިލްޑް (ނުވަތަ މިނިފައިޑް) ބޭނުންކުރާނަމަ bootstrap.js
، މިކަން ހިމަނަން ނުޖެހޭނެ—މިހާރުވެސް އެބައޮތެވެ.
util.js
ޔުޓިލިޓީ ފަންކްޝަންތަކާއި އިވެންޓްތަކަށް ބޭނުންވާ އަސާސީ ހެލްޕަރެއްގެ transitionEnd
އިތުރުން ސީއެސްއެސް ޓްރާންސިޝަން އެމިއުލޭޓަރެއް ހިމެނެއެވެ. އެއީ އެހެން ޕްލަގިންތަކުން ސީއެސްއެސް ޓްރާންސިޝަން ސަޕޯޓް ހުރިތޯ ބެލުމަށާއި ހެންގް ޓްރާންސިޝަންތައް ހިފެހެއްޓުމަށް ބޭނުންކުރާ އެއްޗެކެވެ.