ព័ត៌មានជំនួយ
ឯកសារ និងឧទាហរណ៍សម្រាប់ការបន្ថែមព័ត៌មានជំនួយ Bootstrap ផ្ទាល់ខ្លួនជាមួយ CSS និង JavaScript ដោយប្រើ CSS3 សម្រាប់ចលនា និងទិន្នន័យ-គុណលក្ខណៈសម្រាប់ការផ្ទុកចំណងជើងមូលដ្ឋាន។
អ្វីដែលត្រូវដឹងនៅពេលប្រើកម្មវិធីជំនួយជំនួយ៖
- ការណែនាំអំពីឧបករណ៍ ពឹងផ្អែកលើបណ្ណាល័យភាគីទី 3 Popper.js សម្រាប់ការកំណត់ទីតាំង។ អ្នកត្រូវតែរួមបញ្ចូល popper.min.js មុនពេល bootstrap.js ឬប្រើ
bootstrap.bundle.min.js
/bootstrap.bundle.js
ដែលមាន Popper.js ដើម្បីឱ្យព័ត៌មានជំនួយដំណើរការ! - ប្រសិនបើអ្នកកំពុងបង្កើត JavaScript របស់យើងពីប្រភព វា ទាមទារ
util.js
. - ព័ត៌មានជំនួយត្រូវបានជ្រើសរើសសម្រាប់ហេតុផលប្រតិបត្តិការ ដូច្នេះ អ្នកត្រូវតែចាប់ផ្តើម ពួកវា ដោយខ្លួនឯង
- ព័ត៌មានជំនួយដែលមានចំណងជើងប្រវែងសូន្យមិនត្រូវបានបង្ហាញទេ។
- បញ្ជាក់
container: 'body'
ដើម្បីជៀសវាងបញ្ហាក្នុងការបង្ហាញនៅក្នុងសមាសធាតុស្មុគ្រស្មាញ (ដូចជាក្រុមបញ្ចូលរបស់យើង ក្រុមប៊ូតុង។ល។)។ - ការកេះគន្លឹះឧបករណ៍នៅលើធាតុដែលលាក់នឹងមិនដំណើរការទេ។
- ព័ត៌មានជំនួយសម្រាប់
.disabled
ឬdisabled
ធាតុត្រូវតែត្រូវបានកេះនៅលើធាតុរុំ។ - នៅពេលដែលត្រូវបានកេះចេញពីតំណខ្ពស់ដែលលាតសន្ធឹងច្រើនបន្ទាត់ នោះព័ត៌មានជំនួយនឹងត្រូវបានដាក់នៅកណ្តាល។ ប្រើ
white-space: nowrap;
នៅលើរបស់អ្នក<a>
ដើម្បីជៀសវាងអាកប្បកិរិយានេះ។ - ព័ត៌មានជំនួយត្រូវតែលាក់ មុនពេលធាតុដែលត្រូវគ្នារបស់ពួកគេត្រូវបានយកចេញពី DOM ។
ទទួលបានទាំងអស់នោះ? ល្អណាស់ តោះមើលពីរបៀបដែលពួកគេធ្វើការជាមួយនឹងឧទាហរណ៍មួយចំនួន។
វិធីមួយដើម្បីចាប់ផ្តើមព័ត៌មានជំនួយទាំងអស់នៅលើទំព័រមួយគឺជ្រើសរើសពួកវាតាម data-toggle
គុណលក្ខណៈរបស់ពួកគេ៖
ដាក់លើតំណខាងក្រោមដើម្បីមើលព័ត៌មានជំនួយ៖
ខោតឹង កម្រិតបន្ទាប់ keffiyeh អ្នកប្រហែលជា មិនធ្លាប់ឮពីពួកគេ។ ស្តង់រូបថតពុកចង្ការឆៅ denim letterpress vegan messenger bag stumptown ។ Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit សំលៀកបំពាក់អាមេរិច មាន terry richardson vinyl chambray ។ ពុកចង្ការ, cardigans banh mi lomo thundercats. តៅហ៊ូ biodiesel williamsburg marfa, 4 Loko mcsweeney's cleanse vegan chambray ។ សិប្បករដ៏គួរឱ្យអស់សំណើចមួយរូប ដែលមិនថាជា keytar អ្វីក៏ដោយ ធនាគារ scenester farm-to-table banksy Austin twitter គ្រប់គ្រង freegan cred raw denim មេរោគកាហ្វេដើមតែមួយ។
អូសលើប៊ូតុងខាងក្រោម ដើម្បីមើលទិសដៅជំនួយទាំងបួន៖ ខាងលើ ស្តាំ បាត និងឆ្វេង។
ហើយជាមួយនឹងការបន្ថែម HTML ផ្ទាល់ខ្លួន៖
កម្មវិធីជំនួយព័ត៌មានជំនួយបង្កើតមាតិកា និងការសម្គាល់តាមតម្រូវការ ហើយតាមលំនាំដើមដាក់ព័ត៌មានជំនួយបន្ទាប់ពីធាតុគន្លឹះរបស់ពួកគេ។
កេះព័ត៌មានជំនួយតាមរយៈ JavaScript៖
ការសម្គាល់ដែលត្រូវការសម្រាប់ព័ត៌មានជំនួយគឺគ្រាន់តែជា data
គុណលក្ខណៈ និង title
នៅលើធាតុ HTML ដែលអ្នកចង់មានព័ត៌មានជំនួយ។ ការសម្គាល់ដែលបានបង្កើតនៃព័ត៌មានជំនួយគឺសាមញ្ញជាង ទោះបីជាវាទាមទារទីតាំង (តាមលំនាំដើម កំណត់ top
ដោយកម្មវិធីជំនួយ)។
ការធ្វើឱ្យព័ត៌មានជំនួយដំណើរការសម្រាប់អ្នកប្រើប្រាស់ក្តារចុច និងជំនួយបច្ចេកវិទ្យា
អ្នកគួរតែបន្ថែមព័ត៌មានជំនួយទៅធាតុ HTML ដែលជាទម្លាប់ដែលអាចផ្តោតលើក្ដារចុច និងអន្តរកម្ម (ដូចជាតំណ ឬទម្រង់គ្រប់គ្រង)។ ទោះបីជាធាតុ HTML បំពាន (ដូចជា <span>
s) អាចផ្តោតបានដោយការបន្ថែម tabindex="0"
គុណលក្ខណៈក៏ដោយ វានឹងបន្ថែមការបញ្ឈប់ផ្ទាំងដែលអាចរំខាន និងច្របូកច្របល់លើធាតុដែលមិនមានអន្តរកម្មសម្រាប់អ្នកប្រើប្រាស់ក្តារចុច។ លើសពីនេះ បច្ចេកវិទ្យាជំនួយភាគច្រើនបច្ចុប្បន្នមិនប្រកាសអំពីព័ត៌មានជំនួយក្នុងស្ថានភាពនេះទេ។
លើសពីនេះ កុំពឹងផ្អែកទាំងស្រុងទៅលើ hover
គន្លឹះសម្រាប់ព័ត៌មានជំនួយរបស់អ្នក ព្រោះវានឹងធ្វើឱ្យព័ត៌មានជំនួយរបស់អ្នកមិនអាចទៅរួចសម្រាប់អ្នកប្រើប្រាស់ក្តារចុច។
ធាតុដែលមាន disabled
គុណលក្ខណៈមិនមានអន្តរកម្មទេ មានន័យថាអ្នកប្រើមិនអាចផ្ដោតលើអេក្រង់ ឬចុចពួកវាដើម្បីកេះព័ត៌មានជំនួយ (ឬ popover)។ ជាដំណោះស្រាយមួយ អ្នកនឹងចង់កេះព័ត៌មានជំនួយពីក្រដាសរុំ <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=""
.
ឈ្មោះ | ប្រភេទ | លំនាំដើម | ការពិពណ៌នា |
---|---|---|---|
ចលនា | ប៊ូលីន | ពិត | អនុវត្តការផ្លាស់ប្តូរបន្ថយ CSS ទៅព័ត៌មានជំនួយ |
ធុង | ខ្សែអក្សរ | ធាតុ | មិនពិត | មិនពិត | បន្ថែមព័ត៌មានជំនួយទៅធាតុជាក់លាក់មួយ។ ឧទាហរណ៍៖ |
ពន្យាពេល | លេខ | វត្ថុ | 0 | ពន្យារពេលបង្ហាញ និងលាក់ព័ត៌មានជំនួយ (ms) - មិនអនុវត្តចំពោះប្រភេទគន្លឹះដោយដៃទេ។ ប្រសិនបើលេខត្រូវបានផ្គត់ផ្គង់ ការពន្យារពេលត្រូវបានអនុវត្តចំពោះទាំងលាក់/បង្ហាញ រចនាសម្ព័ន្ធវត្ថុគឺ៖ |
html | ប៊ូលីន | មិនពិត | អនុញ្ញាត HTML នៅក្នុងព័ត៌មានជំនួយ។ ប្រសិនបើជាការពិត ស្លាក HTML នៅក្នុងព័ត៌មានជំនួយ ប្រើអត្ថបទប្រសិនបើអ្នកព្រួយបារម្ភអំពីការវាយប្រហារ XSS ។ |
ការដាក់ | ខ្សែអក្សរ | មុខងារ | 'កំពូល' | របៀបកំណត់ទីតាំងឧបករណ៍ជំនួយ - auto | កំពូល | បាត | ឆ្វេង | ត្រឹមត្រូវ។ នៅពេលដែលអនុគមន៍មួយត្រូវបានប្រើដើម្បីកំណត់ការដាក់ វាត្រូវបានហៅដោយប្រើថ្នាំង DOM ជំនួយជាអាគុយម៉ង់ដំបូងរបស់វា និងធាតុដែលបង្កដោយថ្នាំង DOM ជាទីពីររបស់វា។ បរិបទ |
អ្នកជ្រើសរើស | ខ្សែអក្សរ | មិនពិត | មិនពិត | ប្រសិនបើឧបករណ៍ជ្រើសរើសត្រូវបានផ្តល់ឱ្យ វត្ថុជំនួយនឹងត្រូវបានផ្ទេរទៅគោលដៅដែលបានបញ្ជាក់។ នៅក្នុងការអនុវត្ត វាត្រូវបានប្រើដើម្បីបើកមាតិកា HTML ថាមវន្ត ដើម្បីឱ្យមានការបន្ថែម popovers ។ សូមមើល នេះ និង ឧទាហរណ៍ព័ត៌មាន ។ |
គំរូ | ខ្សែអក្សរ | '<div class="tooltip" role="tooltip"><div class="arrow"></div><div class="tooltip-inner"></div></div>' |
មូលដ្ឋាន HTML ដើម្បីប្រើនៅពេលបង្កើតព័ត៌មានជំនួយ។ ព័ត៌មានជំនួយ
ធាតុរុំខាងក្រៅបំផុតគួរតែមាន |
ចំណងជើង | ខ្សែអក្សរ | ធាតុ | មុខងារ | '' | តម្លៃចំណងជើងលំនាំដើម ប្រសិនបើ ប្រសិនបើមុខងារមួយត្រូវបានផ្តល់ឱ្យ វានឹងត្រូវបានគេហៅជាមួយនឹង |
កេះ | ខ្សែអក្សរ | 'ផ្ដោតលើ' | របៀបដែលព័ត៌មានជំនួយត្រូវបានកេះ - ចុច | hover | ផ្តោតអារម្មណ៍ | ហត្ថកម្ម។ អ្នកអាចឆ្លងកាត់គន្លឹះជាច្រើន; បំបែកពួកវាដោយចន្លោះមួយ។
|
អុហ្វសិត | លេខ | ខ្សែអក្សរ | 0 | អុហ្វសិតនៃព័ត៌មានជំនួយទាក់ទងនឹងគោលដៅរបស់វា។ សម្រាប់ព័ត៌មានបន្ថែម សូមមើល ឯកសារអុហ្វសិត របស់ Popper.js ។ |
ទីតាំងធ្លាក់ចុះ | ខ្សែអក្សរ | អារេ | 'ត្រឡប់' | អនុញ្ញាតឱ្យបញ្ជាក់ទីតាំងណាដែល Popper នឹងប្រើនៅពេលត្រលប់ក្រោយ។ សម្រាប់ព័ត៌មានបន្ថែម សូមមើល ឯកសារអាកប្បកិរិយា របស់ Popper.js |
ព្រំដែន | ខ្សែអក្សរ | ធាតុ | 'scrollParent' | ហួសព្រំដែនកំណត់នៃព័ត៌មានជំនួយ។ ទទួលយកតម្លៃនៃ 'viewport' , 'window' , 'scrollParent' , ឬឯកសារយោង HTMLElement (JavaScript តែប៉ុណ្ណោះ)។ សម្រាប់ព័ត៌មានបន្ថែម សូមមើលឯកសារ PreventOverflow របស់ Popper.js ។ |
គុណលក្ខណៈទិន្នន័យសម្រាប់ព័ត៌មានជំនួយបុគ្គល
ជម្រើសសម្រាប់ព័ត៌មានជំនួយបុគ្គលអាចត្រូវបានបញ្ជាក់ជាជម្រើសតាមរយៈការប្រើប្រាស់គុណលក្ខណៈទិន្នន័យ ដូចដែលបានពន្យល់ខាងលើ។
វិធីសាស្រ្ត និងការផ្លាស់ប្តូរអសមកាល
វិធីសាស្រ្ត API ទាំងអស់គឺ អសមកាល ហើយចាប់ផ្តើមការ ផ្លាស់ប្តូរ ។ ពួកគេត្រឡប់ទៅអ្នកហៅចូលវិញភ្លាមៗ នៅពេលដែលការផ្លាស់ប្តូរត្រូវបានចាប់ផ្តើម ប៉ុន្តែ មុនពេលវាបញ្ចប់ ។ លើសពីនេះទៀត ការហៅវិធីសាស្រ្តលើ សមាសភាគការផ្លាស់ប្តូរនឹងត្រូវបានមិនអើពើ ។
ភ្ជាប់ឧបករណ៍ដោះស្រាយព័ត៌មានជំនួយទៅនឹងបណ្តុំធាតុ។
បង្ហាញព័ត៌មានជំនួយរបស់ធាតុមួយ។ ត្រឡប់ទៅអ្នកហៅទូរស័ព្ទវិញ មុនពេលព័ត៌មានជំនួយត្រូវបានបង្ហាញយ៉ាងពិតប្រាកដ (ឧទាហរណ៍ មុនពេល shown.bs.tooltip
ព្រឹត្តិការណ៍កើតឡើង)។ នេះត្រូវបានគេចាត់ទុកថាជាការកេះ "សៀវភៅដៃ" នៃព័ត៌មានជំនួយ។ ព័ត៌មានជំនួយដែលមានចំណងជើងប្រវែងសូន្យមិនត្រូវបានបង្ហាញទេ។
លាក់ព័ត៌មានជំនួយរបស់ធាតុមួយ។ ត្រឡប់ទៅអ្នកហៅទូរសព្ទវិញ មុនពេលព័ត៌មានជំនួយត្រូវបានលាក់ (ឧ. មុនពេល hidden.bs.tooltip
ព្រឹត្តិការណ៍កើតឡើង)។ នេះត្រូវបានគេចាត់ទុកថាជាការកេះ "សៀវភៅដៃ" នៃព័ត៌មានជំនួយ។
បិទបើកព័ត៌មានជំនួយរបស់ធាតុមួយ។ ត្រឡប់ទៅអ្នកហៅទូរសព្ទវិញ មុនពេលព័ត៌មានជំនួយត្រូវបានបង្ហាញ ឬលាក់shown.bs.tooltip
( ឧទាហរណ៍ មុនពេល hidden.bs.tooltip
ព្រឹត្តិការណ៍កើតឡើង)។ នេះត្រូវបានគេចាត់ទុកថាជាការកេះ "សៀវភៅដៃ" នៃព័ត៌មានជំនួយ។
លាក់ និងបំផ្លាញព័ត៌មានជំនួយរបស់ធាតុមួយ។ ព័ត៌មានជំនួយដែលប្រើការផ្ទេរសិទ្ធិ (ដែលត្រូវបានបង្កើតដោយប្រើ ជម្រើសselector
) មិនអាចត្រូវបានបំផ្លាញដោយឡែកៗពីគ្នាលើធាតុកេះបន្តបន្ទាប់ឡើយ ។
ផ្តល់ព័ត៌មានជំនួយរបស់ធាតុមួយ ដែលមានសមត្ថភាពបង្ហាញ។ ព័ត៌មានជំនួយត្រូវបានបើកតាមលំនាំដើម។
ដកសមត្ថភាពសម្រាប់ព័ត៌មានជំនួយរបស់ធាតុដែលត្រូវបង្ហាញ។ ព័ត៌មានជំនួយនឹងអាចបង្ហាញបានលុះត្រាតែវាត្រូវបានបើកដំណើរការឡើងវិញ។
បិទ/បើកសមត្ថភាពសម្រាប់ព័ត៌មានជំនួយរបស់ធាតុដើម្បីបង្ហាញ ឬលាក់។
ធ្វើបច្ចុប្បន្នភាពទីតាំងនៃព័ត៌មានជំនួយរបស់ធាតុមួយ។
ប្រភេទព្រឹត្តិការណ៍ | ការពិពណ៌នា |
---|---|
show.bs.ព័ត៌មានជំនួយ | ព្រឹត្តិការណ៍នេះឆេះភ្លាមៗ នៅពេលដែល show វិធីសាស្ត្រ instance ត្រូវបានហៅ។ |
show.bs.tooltip | ព្រឹត្តិការណ៍នេះត្រូវបានបញ្ឈប់នៅពេលព័ត៌មានជំនួយត្រូវបានធ្វើឱ្យអ្នកប្រើអាចមើលឃើញ (នឹងរង់ចាំការផ្លាស់ប្តូរ CSS ដើម្បីបញ្ចប់)។ |
hide.bs.tooltip | ព្រឹត្តិការណ៍នេះត្រូវបានបញ្ឈប់ភ្លាមៗនៅពេលដែល hide វិធីសាស្ត្រវត្ថុត្រូវបានហៅ។ |
hidden.bs.tooltip | ព្រឹត្តិការណ៍នេះត្រូវបានបណ្តេញចេញ នៅពេលដែលព័ត៌មានជំនួយបានបញ្ចប់ត្រូវបានលាក់ពីអ្នកប្រើប្រាស់ (នឹងរង់ចាំការផ្លាស់ប្តូរ CSS បញ្ចប់)។ |
inserted.bs.tooltip | ព្រឹត្តិការណ៍នេះត្រូវបានបញ្ឈប់បន្ទាប់ពី show.bs.tooltip ព្រឹត្តិការណ៍ នៅពេលដែលគំរូព័ត៌មានជំនួយត្រូវបានបន្ថែមទៅ DOM ។ |