Popovers
ឯកសារ និងឧទាហរណ៍សម្រាប់ការបន្ថែម Bootstrap popovers ដូចជាអ្វីដែលរកឃើញនៅក្នុង iOS ទៅធាតុណាមួយនៅលើគេហទំព័ររបស់អ្នក។
ទិដ្ឋភាពទូទៅ
អ្វីដែលត្រូវដឹងនៅពេលប្រើកម្មវិធីជំនួយ popover៖
- Popovers ពឹងផ្អែកលើបណ្ណាល័យភាគីទី 3 Popper សម្រាប់ការកំណត់ទីតាំង។ អ្នកត្រូវតែរួមបញ្ចូល popper.min.js មុនពេល bootstrap.js ឬប្រើ
bootstrap.bundle.min.js
/bootstrap.bundle.js
ដែលមាន Popper ដើម្បីឱ្យ popovers ដំណើរការ! - Popovers ទាមទារ កម្មវិធីជំនួយព័ត៌មានជំនួយ ជាការពឹងផ្អែក។
- Popovers ត្រូវបានជ្រើសរើសសម្រាប់ហេតុផលនៃការអនុវត្ត ដូច្នេះ អ្នកត្រូវតែចាប់ផ្តើម វា ដោយខ្លួនឯង
- ប្រវែងសូន្យ
title
និងcontent
តម្លៃនឹងមិនបង្ហាញការលេចឡើងនោះទេ។ - បញ្ជាក់
container: 'body'
ដើម្បីជៀសវាងបញ្ហាក្នុងការបង្ហាញនៅក្នុងសមាសធាតុស្មុគ្រស្មាញ (ដូចជាក្រុមបញ្ចូលរបស់យើង ក្រុមប៊ូតុង។ល។)។ - ការកេះផ្ទាំងព័ត៌មានលើធាតុលាក់នឹងមិនដំណើរការទេ។
- Popovers
.disabled
ឬdisabled
ធាតុត្រូវតែត្រូវបានកេះនៅលើធាតុរុំ។ - នៅពេលដែលត្រូវបានកេះចេញពីយុថ្កាដែលរុំលើបន្ទាត់ជាច្រើន ផ្ទាំងប៉ុបនឹងស្ថិតនៅចំកណ្តាលរវាងទទឹងទាំងមូលរបស់យុថ្កា។ ប្រើ
.text-nowrap
នៅលើរបស់អ្នក<a>
ដើម្បីជៀសវាងអាកប្បកិរិយានេះ។ - Popovers ត្រូវតែលាក់ មុនពេលធាតុដែលត្រូវគ្នារបស់ពួកគេត្រូវបានយកចេញពី DOM ។
- Popovers អាចត្រូវបានកេះដោយសារធាតុមួយនៅក្នុង DOM ស្រមោល។
prefers-reduced-motion
សំណួរមេឌៀ។ សូមមើល
ផ្នែកចលនាដែលបានកាត់បន្ថយនៃឯកសារភាពងាយស្រួលរបស់យើង ។
បន្តអានដើម្បីមើលពីរបៀបដែល popovers ដំណើរការជាមួយនឹងឧទាហរណ៍មួយចំនួន។
ឧទាហរណ៍៖ បើកការលេចឡើងនៅគ្រប់ទីកន្លែង
វិធីមួយដើម្បីចាប់ផ្តើមការលេចឡើងទាំងអស់នៅលើទំព័រមួយគឺដើម្បីជ្រើសរើសពួកវាតាម data-bs-toggle
គុណលក្ខណៈរបស់ពួកគេ៖
var popoverTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="popover"]'))
var popoverList = popoverTriggerList.map(function (popoverTriggerEl) {
return new bootstrap.Popover(popoverTriggerEl)
})
ឧទាហរណ៍៖ ការប្រើប្រាស់ container
ជម្រើស
នៅពេលដែលអ្នកមានរចនាប័ទ្មមួយចំនួននៅលើធាតុមេដែលជ្រៀតជ្រែកជាមួយ popover មួយ អ្នកនឹងចង់បញ្ជាក់ផ្ទាល់ខ្លួន container
ដើម្បីឱ្យ HTML របស់ popover លេចឡើងនៅក្នុងធាតុនោះជំនួសវិញ។
var popover = new bootstrap.Popover(document.querySelector('.example-popover'), {
container: 'body'
})
ឧទាហរណ៍
<button type="button" class="btn btn-lg btn-danger" data-bs-toggle="popover" title="Popover title" data-bs-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>
ទិសទាំងបួន
មានជម្រើសបួន៖ ខាងលើ ស្តាំ បាត និងតម្រឹមឆ្វេង។ ទិសដៅត្រូវបានឆ្លុះបញ្ចាំងនៅពេលប្រើ Bootstrap ក្នុង RTL ។
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="top" data-bs-content="Top popover">
Popover on top
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="right" data-bs-content="Right popover">
Popover on right
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="bottom" data-bs-content="Bottom popover">
Popover on bottom
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="left" data-bs-content="Left popover">
Popover on left
</button>
ច្រានចោលនៅពេលចុចបន្ទាប់
ប្រើ focus
គន្លឹះដើម្បីច្រានចោលការលេចឡើងនៅលើការចុចបន្ទាប់របស់អ្នកប្រើនៃធាតុផ្សេងគ្នាជាងធាតុបិទបើក។
តម្រូវឱ្យមានការសម្គាល់ជាក់លាក់សម្រាប់ការបដិសេធនៅពេលចុចបន្ទាប់
សម្រាប់ឥរិយាបថឆ្លងកាត់កម្មវិធីរុករក និងឆ្លងវេទិកាត្រឹមត្រូវ អ្នកត្រូវតែប្រើ <a>
ស្លាក មិនមែន ស្លាក <button>
ទេ ហើយអ្នកក៏ត្រូវបញ្ចូល tabindex
គុណលក្ខណៈផងដែរ។
<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-bs-toggle="popover" data-bs-trigger="focus" title="Dismissible popover" data-bs-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
var popover = new bootstrap.Popover(document.querySelector('.popover-dismiss'), {
trigger: 'focus'
})
ធាតុពិការ
ធាតុដែលមាន disabled
គុណលក្ខណៈមិនមានអន្តរកម្មទេ មានន័យថាអ្នកប្រើមិនអាចដាក់ ឬចុចវាដើម្បីបង្កឱ្យលេចចេញ (ឬព័ត៌មានជំនួយ)។ ជាដំណោះស្រាយមួយ អ្នកនឹងចង់កេះ popover ពី wrapper <div>
ឬ <span>
បង្កើត keyboard-focusable ដោយប្រើ tabindex="0"
.
សម្រាប់ការកេះ popover ដែលបានបិទ អ្នកក៏អាចចូលចិត្តដែរ data-bs-trigger="hover focus"
ដូច្នេះ popover លេចឡើងជាមតិកែលម្អដែលមើលឃើញភ្លាមៗចំពោះអ្នកប្រើរបស់អ្នក ព្រោះពួកគេប្រហែលជាមិនរំពឹងថានឹង ចុច លើធាតុដែលបិទ។
<span class="d-inline-block" tabindex="0" data-bs-toggle="popover" data-bs-trigger="hover focus" data-bs-content="Disabled popover">
<button class="btn btn-primary" type="button" disabled>Disabled button</button>
</span>
សាស
អថេរ
$popover-font-size: $font-size-sm;
$popover-bg: $white;
$popover-max-width: 276px;
$popover-border-width: $border-width;
$popover-border-color: rgba($black, .2);
$popover-border-radius: $border-radius-lg;
$popover-inner-border-radius: subtract($popover-border-radius, $popover-border-width);
$popover-box-shadow: $box-shadow;
$popover-header-bg: shade-color($popover-bg, 6%);
$popover-header-color: $headings-color;
$popover-header-padding-y: .5rem;
$popover-header-padding-x: $spacer;
$popover-body-color: $body-color;
$popover-body-padding-y: $spacer;
$popover-body-padding-x: $spacer;
$popover-arrow-width: 1rem;
$popover-arrow-height: .5rem;
$popover-arrow-color: $popover-bg;
$popover-arrow-outer-color: fade-in($popover-border-color, .05);
ការប្រើប្រាស់
បើកដំណើរការ popovers តាមរយៈ JavaScript៖
var exampleEl = document.getElementById('example')
var popover = new bootstrap.Popover(exampleEl, options)
ការធ្វើឱ្យ popovers ដំណើរការសម្រាប់អ្នកប្រើប្រាស់ក្តារចុច និងជំនួយបច្ចេកវិទ្យា
ដើម្បីអនុញ្ញាតឱ្យអ្នកប្រើក្តារចុចធ្វើឱ្យការលេចឡើងរបស់អ្នកសកម្ម អ្នកគួរតែបន្ថែមពួកវាទៅក្នុងធាតុ HTML ដែលតាមទម្លាប់ក្តារចុចអាចផ្តោតបាន និងអន្តរកម្ម (ដូចជាតំណភ្ជាប់ ឬការគ្រប់គ្រងទម្រង់)។ ទោះបីជាធាតុ HTML បំពាន (ដូចជា <span>
s) អាចផ្តោតបានដោយការបន្ថែម tabindex="0"
គុណលក្ខណៈក៏ដោយ វានឹងបន្ថែមការបញ្ឈប់ផ្ទាំងដែលអាចរំខាន និងច្របូកច្របល់លើធាតុដែលមិនអន្តរកម្មសម្រាប់អ្នកប្រើប្រាស់ក្តារចុច ហើយបច្ចេកវិទ្យាជំនួយភាគច្រើនបច្ចុប្បន្នមិនប្រកាសមាតិការបស់ popover ក្នុងស្ថានភាពនេះទេ។ . លើសពីនេះ កុំពឹងផ្អែកទាំងស្រុងទៅលើ hover
ការកេះសម្រាប់ការលេចចេញរបស់អ្នក ព្រោះវានឹងធ្វើឱ្យពួកវាមិនអាចកេះសម្រាប់អ្នកប្រើប្រាស់ក្តារចុចបានទេ។
ខណៈពេលដែលអ្នកអាចបញ្ចូល HTML ដែលមានរចនាសម្ព័ន្ធសម្បូរបែបនៅក្នុង popovers ជាមួយនឹង html
ជម្រើស យើងសូមណែនាំយ៉ាងមុតមាំថាអ្នកជៀសវាងការបន្ថែមមាតិកាច្រើនពេក។ របៀបដែល popovers ដំណើរការនាពេលបច្ចុប្បន្នគឺថា នៅពេលដែលបង្ហាញ មាតិការបស់ពួកគេត្រូវបានចងភ្ជាប់ទៅនឹងធាតុ trigger ជាមួយនឹង aria-describedby
គុណលក្ខណៈ។ ជាលទ្ធផល ខ្លឹមសារទាំងស្រុងនៃ popover នឹងត្រូវបានប្រកាសដល់អ្នកប្រើប្រាស់បច្ចេកវិទ្យាជាជំនួយក្នុងការស្ទ្រីមរយៈពេលវែង និងគ្មានការរំខាន។
បន្ថែមពីលើនេះ ខណៈពេលដែលវាអាចធ្វើទៅបានផងដែរដើម្បីរួមបញ្ចូលការគ្រប់គ្រងអន្តរកម្ម (ដូចជាធាតុទម្រង់ ឬតំណភ្ជាប់) នៅក្នុង popover របស់អ្នក (ដោយបន្ថែមធាតុទាំងនេះទៅក្នុង allowList
គុណលក្ខណៈ និងស្លាកដែលបានអនុញ្ញាត) ត្រូវដឹងថាបច្ចុប្បន្ន popover មិនគ្រប់គ្រងលំដាប់នៃការផ្តោតអារម្មណ៍ក្តារចុចទេ។ នៅពេលដែលអ្នកប្រើក្តារចុចបើកផ្ទាំង popover ការផ្តោតអារម្មណ៍នៅតែមាននៅលើធាតុបង្កហេតុ ហើយជាធម្មតា popover មិនធ្វើតាមគន្លឹះក្នុងរចនាសម្ព័ន្ធឯកសារភ្លាមៗនោះ វាមិនមានការធានាថាការបន្តទៅមុខ/ចុចនោះទេ។TABនឹងផ្លាស់ទីអ្នកប្រើក្តារចុចចូលទៅក្នុង popover ខ្លួនវាផ្ទាល់។ សរុបមក ការបន្ថែមវត្ថុបញ្ជាអន្តរកម្មទៅ popover ទំនងជាធ្វើឱ្យការគ្រប់គ្រងទាំងនេះមិនអាចទៅដល់/មិនអាចប្រើប្រាស់បានសម្រាប់អ្នកប្រើប្រាស់ក្តារចុច និងអ្នកប្រើប្រាស់បច្ចេកវិទ្យាជំនួយ ឬយ៉ាងហោចណាស់ធ្វើឱ្យមានលំដាប់នៃការផ្តោតជារួមដែលមិនសមហេតុផល។ នៅក្នុងករណីទាំងនេះ សូមពិចារណាប្រើប្រអប់ម៉ូឌុលជំនួសវិញ។
ជម្រើស
ជម្រើសអាចត្រូវបានឆ្លងកាត់តាមរយៈគុណលក្ខណៈទិន្នន័យ ឬ JavaScript ។ សម្រាប់គុណលក្ខណៈទិន្នន័យ សូមបន្ថែមឈ្មោះជម្រើសទៅ data-bs-
ដូចក្នុង data-bs-animation=""
. ត្រូវប្រាកដថាផ្លាស់ប្តូរប្រភេទករណីនៃឈ្មោះជម្រើសពី camelCase ទៅ kebab-case នៅពេលឆ្លងកាត់ជម្រើសតាមរយៈគុណលក្ខណៈទិន្នន័យ។ ឧទាហរណ៍ជំនួសឱ្យការប្រើ data-bs-customClass="beautifier"
ប្រើ data-bs-custom-class="beautifier"
។
sanitize
,
sanitizeFn
, និង
allowList
ជម្រើសមិនអាចត្រូវបានផ្គត់ផ្គង់ដោយប្រើលក្ខណៈទិន្នន័យ។
ឈ្មោះ | ប្រភេទ | លំនាំដើម | ការពិពណ៌នា |
---|---|---|---|
animation |
ប៊ូលីន | true |
អនុវត្តការផ្លាស់ប្តូរបន្ថយ CSS ទៅ popover |
container |
ខ្សែអក្សរ | ធាតុ | មិនពិត | false |
បន្ថែម popover ទៅធាតុជាក់លាក់មួយ។ ឧទាហរណ៍៖ |
content |
ខ្សែអក្សរ | ធាតុ | មុខងារ | '' |
តម្លៃមាតិកាលំនាំដើម ប្រសិនបើ ប្រសិនបើមុខងារមួយត្រូវបានផ្តល់ឱ្យ វានឹងត្រូវបានគេហៅជាមួយនឹង |
delay |
លេខ | វត្ថុ | 0 |
ការពន្យាពេលបង្ហាញ និងលាក់ popover (ms) - មិនអនុវត្តចំពោះប្រភេទកេះដោយដៃទេ។ ប្រសិនបើលេខត្រូវបានផ្គត់ផ្គង់ ការពន្យារពេលត្រូវបានអនុវត្តចំពោះទាំងលាក់/បង្ហាញ រចនាសម្ព័ន្ធវត្ថុគឺ៖ |
html |
ប៊ូលីន | false |
បញ្ចូល HTML ទៅក្នុង popover ។ ប្រសិនបើមិនពិត innerText ទ្រព្យសម្បត្តិនឹងត្រូវបានប្រើដើម្បីបញ្ចូលខ្លឹមសារទៅក្នុង DOM ។ ប្រើអត្ថបទប្រសិនបើអ្នកព្រួយបារម្ភអំពីការវាយប្រហារ XSS ។ |
placement |
ខ្សែអក្សរ | មុខងារ | 'right' |
របៀបដាក់ popover - auto | កំពូល | បាត | ឆ្វេង | ត្រឹមត្រូវ។ នៅពេលដែលអនុគមន៍មួយត្រូវបានប្រើដើម្បីកំណត់ការដាក់ វាត្រូវបានហៅជាមួយថ្នាំង DOM popover ជាអាគុយម៉ង់ដំបូងរបស់វា និងធាតុបង្កកថ្នាំង DOM ជាលើកទីពីររបស់វា។ បរិបទ |
selector |
ខ្សែអក្សរ | មិនពិត | false |
ប្រសិនបើឧបករណ៍ជ្រើសរើសត្រូវបានផ្តល់ឱ្យ វត្ថុ popover នឹងត្រូវបានផ្ទេរទៅគោលដៅដែលបានបញ្ជាក់។ នៅក្នុងការអនុវត្ត វាត្រូវបានប្រើដើម្បីបើកមាតិកា HTML ថាមវន្ត ដើម្បីឱ្យមានការបន្ថែម popovers ។ សូមមើល នេះ និង ឧទាហរណ៍ព័ត៌មាន ។ |
template |
ខ្សែអក្សរ | '<div class="popover" role="tooltip"><div class="popover-arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
មូលដ្ឋាន HTML ដើម្បីប្រើនៅពេលបង្កើត popover ។ Popover's Popover's
ធាតុរុំខាងក្រៅបំផុតគួរតែមាន |
title |
ខ្សែអក្សរ | ធាតុ | មុខងារ | '' |
តម្លៃចំណងជើងលំនាំដើម ប្រសិនបើ ប្រសិនបើមុខងារមួយត្រូវបានផ្តល់ឱ្យ វានឹងត្រូវបានគេហៅជាមួយនឹង |
trigger |
ខ្សែអក្សរ | 'click' |
របៀបដែល popover ត្រូវបានកេះ - ចុច | hover | ផ្តោតអារម្មណ៍ | ហត្ថកម្ម។ អ្នកអាចឆ្លងកាត់គន្លឹះជាច្រើន; បំបែកពួកវាដោយចន្លោះមួយ។ manual មិនអាចត្រូវបានរួមបញ្ចូលជាមួយកេះផ្សេងទៀត។ |
fallbackPlacements |
អារេ | ['top', 'right', 'bottom', 'left'] |
កំណត់ការដាក់ជំនួសដោយផ្ដល់បញ្ជីនៃការដាក់ក្នុងអារេ (តាមលំដាប់តាមចំណូលចិត្ត)។ សម្រាប់ព័ត៌មានបន្ថែម សូមមើល ឯកសារអាកប្បកិរិយា របស់ Popper |
boundary |
ខ្សែអក្សរ | ធាតុ | 'clippingParents' |
ព្រំដែនកំណត់លើសចំណុះនៃការលេចចេញ (អនុវត្តតែចំពោះឧបករណ៍កែប្រែទប់ស្កាត់ការលើសចំណុះរបស់ Popper ប៉ុណ្ណោះ)។ តាមលំនាំដើម វាជា 'clippingParents' និងអាចទទួលយកឯកសារយោង HTMLElement (តាមរយៈ JavaScript តែប៉ុណ្ណោះ)។ សម្រាប់ព័ត៌មានបន្ថែម សូមមើល ឯកសារ detectOverflow របស់ Popper ។ |
customClass |
ខ្សែអក្សរ | មុខងារ | '' |
បន្ថែមថ្នាក់ទៅ popover នៅពេលដែលវាត្រូវបានបង្ហាញ។ ចំណាំថាថ្នាក់ទាំងនេះនឹងត្រូវបានបន្ថែមបន្ថែមលើថ្នាក់ណាមួយដែលបានបញ្ជាក់នៅក្នុងគំរូ។ ដើម្បីបន្ថែមថ្នាក់ច្រើន សូមបំបែកវាដោយដកឃ្លា៖ អ្នកក៏អាចឆ្លងកាត់មុខងារដែលគួរត្រឡប់ខ្សែតែមួយដែលមានឈ្មោះថ្នាក់បន្ថែម។ |
sanitize |
ប៊ូលីន | true |
បើក ឬបិទការធ្វើអនាម័យ។ ប្រសិនបើបានធ្វើឱ្យសកម្ម 'template' ហើយ ជម្រើស 'content' នឹង 'title' ត្រូវបានសម្អាត។ សូមមើល ផ្នែកអនាម័យនៅក្នុងឯកសារ JavaScript របស់យើង ។ |
allowList |
វត្ថុ | តម្លៃលំនាំដើម | វត្ថុដែលមានគុណលក្ខណៈ និងស្លាកដែលបានអនុញ្ញាត |
sanitizeFn |
null | មុខងារ | null |
នៅទីនេះអ្នកអាចផ្គត់ផ្គង់មុខងារអនាម័យផ្ទាល់ខ្លួនរបស់អ្នក។ វាអាចមានប្រយោជន៍ ប្រសិនបើអ្នកចូលចិត្តប្រើបណ្ណាល័យដែលខិតខំប្រឹងប្រែងដើម្បីអនុវត្តអនាម័យ។ |
offset |
អារេ | ខ្សែអក្សរ | មុខងារ | [0, 8] |
អុហ្វសិតនៃ popover ទាក់ទងទៅនឹងគោលដៅរបស់វា។ អ្នកអាចឆ្លងខ្សែក្នុងគុណលក្ខណៈទិន្នន័យដែលមានតម្លៃបំបែកដោយសញ្ញាក្បៀសដូចជា៖ នៅពេលដែលអនុគមន៍មួយត្រូវបានប្រើដើម្បីកំណត់អុហ្វសិត វាត្រូវបានហៅជាមួយវត្ថុដែលមានការដាក់ popper ឯកសារយោង និង popper rects ជាអាគុយម៉ង់ដំបូងរបស់វា។ ថ្នាំង DOM ធាតុកេះត្រូវបានឆ្លងកាត់ជាអាគុយម៉ង់ទីពីរ។ អនុគមន៍ត្រូវតែត្រឡប់អារេដែលមានលេខពីរ៖ . សម្រាប់ព័ត៌មានបន្ថែម សូមមើល ឯកសារអុហ្វសិត របស់ Popper ។ |
popperConfig |
null | វត្ថុ | មុខងារ | null |
ដើម្បីផ្លាស់ប្តូរការកំណត់ Popper លំនាំដើមរបស់ Bootstrap សូមមើល ការកំណត់រចនាសម្ព័ន្ធរបស់ Popper ។ នៅពេលដែលមុខងារមួយត្រូវបានប្រើដើម្បីបង្កើតការកំណត់រចនាសម្ព័ន្ធ Popper វាត្រូវបានហៅជាមួយវត្ថុដែលមានការកំណត់រចនាសម្ព័ន្ធ Popper លំនាំដើមរបស់ Bootstrap ។ វាជួយអ្នកប្រើ និងបញ្ចូលលំនាំដើមជាមួយការកំណត់ផ្ទាល់ខ្លួនរបស់អ្នក។ មុខងារត្រូវតែត្រឡប់វត្ថុកំណត់រចនាសម្ព័ន្ធសម្រាប់ Popper ។ |
គុណលក្ខណៈទិន្នន័យសម្រាប់ popovers បុគ្គល
ជម្រើសសម្រាប់ popovers បុគ្គលអាចត្រូវបានបញ្ជាក់ជាជម្រើសតាមរយៈការប្រើប្រាស់គុណលក្ខណៈទិន្នន័យ ដូចដែលបានពន្យល់ខាងលើ។
ការប្រើប្រាស់មុខងារជាមួយpopperConfig
var popover = new bootstrap.Popover(element, {
popperConfig: function (defaultBsPopperConfig) {
// var newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
វិធីសាស្រ្ត
វិធីសាស្រ្ត និងការផ្លាស់ប្តូរអសមកាល
វិធីសាស្រ្ត API ទាំងអស់គឺ អសមកាល ហើយចាប់ផ្តើមការ ផ្លាស់ប្តូរ ។ ពួកគេត្រឡប់ទៅអ្នកហៅចូលវិញភ្លាមៗ នៅពេលដែលការផ្លាស់ប្តូរត្រូវបានចាប់ផ្តើម ប៉ុន្តែ មុនពេលវាបញ្ចប់ ។ លើសពីនេះទៀត ការហៅវិធីសាស្រ្តលើ សមាសភាគការផ្លាស់ប្តូរនឹងត្រូវបានមិនអើពើ ។
បង្ហាញ
បង្ហាញការលេចឡើងនៃធាតុមួយ។ ត្រឡប់ទៅអ្នកហៅទូរសព្ទវិញមុនពេលលេចចេញត្រូវបានបង្ហាញយ៉ាងពិតប្រាកដ (ឧ. មុន shown.bs.popover
ព្រឹត្តិការណ៍កើតឡើង)។ នេះត្រូវបានគេចាត់ទុកថាជា "សៀវភៅដៃ" ការបង្កឱ្យមានការលេចចេញ។ Popovers ដែលចំណងជើង និងខ្លឹមសារមានប្រវែងសូន្យមិនត្រូវបានបង្ហាញទេ។
myPopover.show()
លាក់
លាក់ការលេចឡើងនៃធាតុមួយ។ ត្រឡប់ទៅអ្នកហៅទូរសព្ទវិញមុនពេលលេចឮថាពិតជាត្រូវបានលាក់ (ឧ. មុន hidden.bs.popover
ព្រឹត្តិការណ៍កើតឡើង)។ នេះត្រូវបានគេចាត់ទុកថាជា "សៀវភៅដៃ" ការបង្កឱ្យមានការលេចចេញ។
myPopover.hide()
បិទបើក
បិទ/បើកការលេចចេញរបស់ធាតុមួយ។ ត្រឡប់ទៅកាន់អ្នកហៅទូរសព្ទវិញ មុនពេលការលេចចេញត្រូវបានបង្ហាញ ឬ លាក់ (ឧទាហរណ៍ មុនពេល ព្រឹត្តិការណ៍កើតឡើង)។ នេះត្រូវបានគេចាត់ទុកថាជា "សៀវភៅដៃ" ការបង្កឱ្យមានការលេចចេញ។shown.bs.popover
hidden.bs.popover
myPopover.toggle()
បោះចោល
លាក់ និងបំផ្លាញការលេចឡើងនៃធាតុមួយ (លុបទិន្នន័យដែលបានរក្សាទុកនៅលើធាតុ DOM) ។ Popovers ដែលប្រើការធ្វើប្រតិភូកម្ម (ដែលត្រូវបានបង្កើតដោយប្រើ ជម្រើសselector
) មិនអាចត្រូវបំផ្លាញដោយឡែកៗពីគ្នាលើធាតុនៃកត្តា តំណពូជ នោះទេ។
myPopover.dispose()
បើក
ផ្តល់លទ្ធភាពបង្ហាញវត្តមានរបស់ធាតុ។ Popovers ត្រូវបានបើកតាមលំនាំដើម។
myPopover.enable()
បិទ
លុបសមត្ថភាពសម្រាប់ការបង្ហាញរបស់ធាតុដែលលេចឡើង។ Popover នឹងអាចបង្ហាញបានលុះត្រាតែវាត្រូវបានបើកឡើងវិញ។
myPopover.disable()
បិទបើក
បិទ/បើកសមត្ថភាពសម្រាប់ការបង្ហាញឬលាក់របស់ធាតុ។
myPopover.toggleEnabled()
ធ្វើបច្ចុប្បន្នភាព
ធ្វើបច្ចុប្បន្នភាពទីតាំងនៃការលេចឡើងនៃធាតុមួយ។
myPopover.update()
getInstance
វិធីសាស្ត្រ ឋិតិវន្ត ដែលអនុញ្ញាតឱ្យអ្នកទទួលបានឧទាហរណ៍ popover ដែលភ្ជាប់ជាមួយធាតុ DOM
var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getInstance(exampleTriggerEl) // Returns a Bootstrap popover instance
getOrCreateInstance
វិធីសាស្ត្រ ឋិតិវន្ត ដែលអនុញ្ញាតឱ្យអ្នកទទួលបានឧទាហរណ៍ popover ដែលភ្ជាប់ជាមួយធាតុ DOM ឬបង្កើតថ្មីមួយក្នុងករណីដែលវាមិនត្រូវបានចាប់ផ្តើម
var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap popover instance
ព្រឹត្តិការណ៍
ប្រភេទព្រឹត្តិការណ៍ | ការពិពណ៌នា |
---|---|
show.bs.popover | ព្រឹត្តិការណ៍នេះឆេះភ្លាមៗ នៅពេលដែល show វិធីសាស្ត្រ instance ត្រូវបានហៅ។ |
បង្ហាញ.bs.popover | ព្រឹត្តិការណ៍នេះត្រូវបានបញ្ឈប់នៅពេលដែលផ្ទាំងព័ត៌មានត្រូវបានធ្វើឱ្យអ្នកប្រើមើលឃើញ (នឹងរង់ចាំការផ្លាស់ប្តូរ CSS ដើម្បីបញ្ចប់)។ |
hide.bs.popover | ព្រឹត្តិការណ៍នេះត្រូវបានបញ្ឈប់ភ្លាមៗនៅពេលដែល hide វិធីសាស្ត្រវត្ថុត្រូវបានហៅ។ |
លាក់.bs.popover | ព្រឹត្តិការណ៍នេះត្រូវបានបញ្ឈប់នៅពេលដែល popover បានបញ្ចប់ត្រូវបានលាក់ពីអ្នកប្រើប្រាស់ (នឹងរង់ចាំការផ្លាស់ប្ដូរ CSS ដើម្បីបញ្ចប់)។ |
បញ្ចូល.bs.popover | ព្រឹត្តិការណ៍នេះត្រូវបានបញ្ឈប់បន្ទាប់ពី show.bs.popover ព្រឹត្តិការណ៍នៅពេលដែលគំរូ popover ត្រូវបានបន្ថែមទៅ DOM ។ |
var myPopoverTrigger = document.getElementById('myPopover')
myPopoverTrigger.addEventListener('hidden.bs.popover', function () {
// do something...
})