JavaScript

הבא לחיים את הרכיבים של Bootstrap - כעת עם 13 תוספים מותאמים אישית של jQuery.

שימו לב! מסמכים אלה מיועדים לגרסה 2.3.2, שאינה נתמכת עוד רשמית. בדוק את הגרסה האחרונה של Bootstrap!

בודדים או מורכבים

ניתן לכלול תוספים בנפרד (אם כי לחלקם יש תלות נדרשת), או בבת אחת. גם bootstrap.js וגם bootstrap.min.js מכילים את כל התוספים בקובץ בודד.

תכונות נתונים

אתה יכול להשתמש בכל התוספים של Bootstrap אך ורק דרך ממשק ה-API מבלי לכתוב שורה אחת של JavaScript. זהו ה-API המחלקה הראשונה של Bootstrap וצריך להיות השיקול הראשון שלך בעת שימוש בתוסף.

עם זאת, במצבים מסוימים ייתכן שיהיה רצוי לכבות את הפונקציונליות הזו. לכן, אנו מספקים גם את היכולת להשבית את ה-API של תכונת הנתונים על ידי ביטול הכריכה של כל האירועים בגוף עם מרחב השמות עם `'data-api'`. זה נראה כך:

  1. $ ( 'גוף' ). כבוי ( '.data-api' )

לחלופין, כדי למקד לפלאגין ספציפי, פשוט כלול את שם הפלאגין כמרחב שמות יחד עם מרחב השמות של הנתונים-API כך:

  1. $ ( 'גוף' ). כבוי ( '.alert.data-api' )

API פרוגרמטי

אנו גם מאמינים שאתה אמור להיות מסוגל להשתמש בכל התוספים של Bootstrap אך ורק דרך ה-API של JavaScript. כל ממשקי ה-API הציבוריים הם שיטות בודדות, הניתנות לשרשור, ומחזירות את האוסף שננקטו.

  1. $ ( ".btn.danger" ). כפתור ( "להחליף" ). addClass ( "שמן" )

כל השיטות צריכות לקבל אובייקט אופציונלי אופציונלי, מחרוזת המכוונת לשיטה מסוימת, או שום דבר (אשר יוזם תוסף עם התנהגות ברירת מחדל):

  1. $ ( "#myModal" ). modal () // מאותחל עם ברירות מחדל
  2. $ ( "#myModal" ). modal ({ keyboard : false }) // אותחל ללא מקלדת
  3. $ ( "#myModal" ). modal ( 'show' ) // מאתחל ומפעיל את show באופן מיידי

כל תוסף גם חושף את הבנאי הגולמי שלו על מאפיין 'קונסטרוקטור': $.fn.popover.Constructor. אם תרצה לקבל מופע פלאגין מסוים, אחזר אותו ישירות מאלמנט: $('[rel=popover]').data('popover').

אין סכסוך

לפעמים יש צורך להשתמש בתוספים של Bootstrap עם מסגרות משתמש אחרות. בנסיבות אלה, התנגשויות במרחב השמות יכולות להתרחש מדי פעם. אם זה קורה, אתה יכול להתקשר .noConflictלפלאגין שברצונך להחזיר את הערך שלו.

  1. var bootstrapButton = $ . fn . כפתור . noConflict () // החזר את $.fn.button לערך שהוקצה קודם לכן
  2. $ . fn . bootstrapBtn = bootstrapButton // תן $().bootstrapBtn את פונקציונליות האתחול

אירועים

Bootstrap מספק אירועים מותאמים אישית עבור רוב הפעולות הייחודיות של התוסף. בדרך כלל, אלה באים בצורה אינפינטיבית וחלק עבר - כאשר האינפיניטיב (לדוגמה show) מופעל בתחילת אירוע, וצורת חלק העבר שלו (לדוגמה shown) מופעלת עם השלמת פעולה.

כל האירועים האינסופיים מספקים פונקציונליות של preventDefault. זה מספק את היכולת לעצור את ביצוע הפעולה לפני שהיא מתחילה.

  1. $ ( '#myModal' ). on ( 'הצג' , פונקציה ( ה ) {
  2. אם (! נתונים ) מחזירים ה . preventDefault () // מפסיק את הצגת המודאל
  3. })

לגבי מעברים

עבור אפקטי מעבר פשוטים, כלול את bootstrap-transition.js פעם אחת לצד שאר קבצי ה-JS. אם אתה משתמש ב- bootstrap.js המהודר (או ממוזער) , אין צורך לכלול את זה - הוא כבר שם.

מקרי שימוש

כמה דוגמאות לפלאגין המעבר:

  • החלקה או דהייה במודלים
  • דהיית כרטיסיות
  • דעיכת התראות
  • חלונות קרוסלה הזזה

דוגמאות

המודלים הם הודעות דו-שיח יעילות אך גמישות עם הפונקציונליות המינימלית הנדרשת וברירות מחדל חכמות.

דוגמה סטטית

מודל מעובד עם כותרת עליונה, גוף וקבוצת פעולות בכותרת התחתונה.

  1. <div class = "modal hide fade" >
  2. <div class = "modal-header" >
  3. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
  4. <h3> כותרת מודאלית </h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> גוף נאה אחד... </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn" > סגור </a>
  11. <a href = "#" class = "btn btn-primary" > שמור שינויים </a>
  12. </div>
  13. </div>

דמו ישיר

החלף מודאל באמצעות JavaScript על ידי לחיצה על הכפתור למטה. הוא יחליק מטה ויימוג מהחלק העליון של העמוד.

  1. <!-- לחצן להפעלת מודאל -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > הפעל הדגמה </a>
  3.  
  4. <!-- Modal -->
  5. <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labeledby = "myModalLabel" aria-hidden = "true" >
  6. <div class = "modal-header" >
  7. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
  8. <h3 id = "myModalLabel" > כותרת מודאלית </h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> גוף נאה אחד... </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > סגור </button>
  15. <button class = "btn btn-primary" > שמור שינויים </button>
  16. </div>
  17. </div>

נוֹהָג

באמצעות תכונות נתונים

הפעל מודאל מבלי לכתוב JavaScript. הגדר data-toggle="modal"על רכיב בקר, כמו כפתור, יחד עם data-target="#foo"או href="#foo"כדי למקד מודאל ספציפי למעבר.

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" > הפעל מודאלי </button>

דרך JavaScript

התקשר למודאל עם מזהה myModalעם שורה אחת של JavaScript:

  1. $ ( '#myModal' ). מודאלי ( אפשרויות )

אפשרויות

ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-, כמו ב- data-backdrop="".

שֵׁם סוּג בְּרִירַת מֶחדָל תיאור
רקע בוליאני נָכוֹן כולל אלמנט רקע מודאלי. לחלופין, ציין staticעבור רקע שאינו סוגר את המודאל בלחיצה.
מקלדת בוליאני נָכוֹן סוגר את המודאל בעת לחיצה על מקש Escape
הופעה בוליאני נָכוֹן מציג את המודאל בעת אתחול.
מְרוּחָק נָתִיב שֶׁקֶר

אם מסופקת כתובת אתר מרוחקת, התוכן ייטען באמצעות loadהשיטה של ​​jQuery ויוזרק לתוך ה- .modal-body. אם אתה משתמש ב-Data API, אתה יכול לחלופין להשתמש hrefבתג כדי לציין את המקור המרוחק. דוגמה לכך מוצגת להלן:

  1. <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>

שיטות

.modal(אפשרויות)

מפעיל את התוכן שלך כמודל. מקבל אפשרויות אופציונליות object.

  1. $ ( '#myModal' ). מודאלי ({
  2. מקלדת : שקר
  3. })

.modal('toggle')

מחליף מודאל באופן ידני.

  1. $ ( '#myModal' ). מודאלי ( 'להחליף' )

.modal('show')

פותח מודאל באופן ידני.

  1. $ ( '#myModal' ). מודאלי ( 'הצג' )

.modal('hide')

מסתיר באופן ידני מודאל.

  1. $ ( '#myModal' ). מודאלי ( 'להסתיר' )

אירועים

המחלקה המודאלית של Bootstrap חושפת כמה אירועים לחיבור לפונקציונליות מודאלית.

מִקרֶה תיאור
הופעה אירוע זה מופעל מיד כאשר showשיטת המופע נקראת.
מוצג אירוע זה מופעל כאשר המודאל נעשה גלוי למשתמש (יחכה לסיום מעברי css).
להתחבא אירוע זה מופעל מיד כאשר hideשיטת המופע נקראה.
מוּסתָר אירוע זה מופעל כאשר המודאל סיים להיות מוסתר מהמשתמש (יחכה לסיום מעברי css).
  1. $ ( '#myModal' ). on ( 'מוסתר' , function () {
  2. // עשה משהו…
  3. })

דוגמה ב-navbar

התוסף ScrollSpy מיועד לעדכון אוטומטי של יעדי ניווט בהתבסס על מיקום הגלילה. גלול באזור שמתחת לסרגל הניווט וצפה בשינוי הכיתה הפעילה. פריטי המשנה הנפתחים יודגשו גם כן.

@שמן

חותלות מודעה keytar, מזהה בראנץ' מסיבת אמנות dolor labore. Pitchfork yr enim lo-fi לפני שהם אזלו qui. זכויות אופניים מחווה לשולחן בטאמבלר לא משנה מה. קרדיגן אנים כפייה קרלס. תא הצילום של Velit seitan mcsweeney 3 wolf moon irure. קוסבי סוודר lomo jean shorts, Williamsburg hoodie minim qui בטח לא שמעתם עליהם et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil מקועקע accusamus, cred אירוניה ביודיזל keffiyeh אומן ullamco consequat.

@mdo

סקייטבורד שפם של Veniam marfa, זקן קלשון שופע פוגיאט וליט. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. משאית אוכל מקועקעת סוודר קוסבי, ויניל של Mcsweeney's quis non freegan. לו-פי ווס אנדרסון +1 סרטון. קרלס תרגול לא אסתטי quis gentrify. ברוקלין שומנית בירה מלאכה סגן keytar עזוב.

אחד

Occaecat commodo aliqua delectus. Fap craft beer נטוש סקייטבורד ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore קפה ממקור יחיד במגנה ווניאם. High life id ויניל, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. תיק שליח מינימלי Consectetur nisi DIY. Cred לשעבר, בר קיימא delectus consectetur פאני חבילת אייפון.

שתיים

In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.

three

Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica קלישאה אירוניה, חתולים רעמים שבטח לא שמעתם עליהם consequat hoodie ללא גלוטן lo-fi fap aliquip. Labore elit placeat לפני שהם סולד אאוט, טרי ריצ'רדסון פרוידנט בראנץ 'נסciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. קרדיגן craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.


נוֹהָג

באמצעות תכונות נתונים

כדי להוסיף בקלות התנהגות גלילה לניווט בסרגל העליון שלך, פשוט הוסף data-spy="scroll"לרכיב שאתה רוצה לרגל אחריו (בדרך כלל זה יהיה הגוף) data-target=".navbar"וכדי לבחור באיזה ניווט להשתמש. תרצה להשתמש ב- scrollspy עם .navרכיב.

  1. <body data-spy = "scroll" data-target = ".navbar" > ... </body>

דרך JavaScript

התקשר ל- scrollspy באמצעות JavaScript:

  1. $ ( '#navbar' ). scrollspy ()
שימו לב! קישורי Navbar חייבים להיות בעלי יעדי מזהה ניתנים לפתרון. לדוגמה, <a href="#home">home</a>חובה להתאים למשהו בדום כמו <div id="home"></div>.

שיטות

.scrollspy('refresh')

בעת שימוש ב-scrollspy בשילוב עם הוספה או הסרה של אלמנטים מה-DOM, תצטרך לקרוא לשיטת הרענון כך:

  1. $ ( '[data-spy="scroll"]' ). each ( function () {
  2. var $spy = $ ( זה ). scrollspy ( 'רענן' )
  3. });

אפשרויות

ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-, כמו ב- data-offset="".

שֵׁם סוּג בְּרִירַת מֶחדָל תיאור
לְקַזֵז מספר 10 פיקסלים לקיזוז מלמעלה בעת חישוב מיקום הגלילה.

אירועים

מִקרֶה תיאור
לְהַפְעִיל אירוע זה מופעל בכל פעם שפריט חדש מופעל על ידי סרגל הגלילה.

כרטיסיות לדוגמה

הוסף פונקציונליות מהירה ודינאמית של כרטיסיות למעבר דרך חלוניות של תוכן מקומי, אפילו באמצעות תפריטים נפתחים.

ג'ינס גולמי בטח לא שמעתם עליהם מכנסי ג'ינס אוסטין. Nesciunt tofu stumptown aliqua, רטרו סינת' מאסטר ניקוי. שפם קלישאה טמפור, וויליאמסבורג קרלס helvetica טבעונית. Reprehenderit בוצ'ר רטרו keffiyeh לוכד חלומות סינת'. סוודר קוסבי eu banh mi, qui irure טרי ריצ'רדסון לשעבר דיונון. Aliquip placeat salvia cillum אייפון. סייטן אליקוויפ quis קרדיגן ביגוד אמריקאי, בוצ'ר voluptate nisi qui.

Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.


נוֹהָג

אפשר כרטיסיות הניתנות לכרטיסיות באמצעות JavaScript (יש להפעיל כל כרטיסייה בנפרד):

  1. $ ( '#myTab a' ). לחץ ( פונקציה ( e ) {
  2. ה . preventDefault ();
  3. $ ( זה ). tab ( 'הצג' );
  4. })

אתה יכול להפעיל כרטיסיות בודדות בכמה דרכים:

  1. $ ( '#myTab a[href="#profile"]' ). tab ( 'הצג' ); // בחר כרטיסייה לפי שם
  2. $ ( '#myTab a:first' ). tab ( 'הצג' ); // בחר את הכרטיסייה הראשונה
  3. $ ( '#myTab a:last' ). tab ( 'הצג' ); // בחר את הכרטיסייה האחרונה
  4. $ ( '#myTab li:eq(2) a' ). tab ( 'הצג' ); // בחר כרטיסייה שלישית (אינדקס 0)

סימון

אתה יכול להפעיל טאב או ניווט בגלולה מבלי לכתוב שום JavaScript על ידי ציון data-toggle="tab"או data-toggle="pill"על אלמנט. הוספת המחלקות navו nav-tabsלכרטיסייה ulתחיל את סגנון הכרטיסייה Bootstrap.

  1. <ul class = "nav nav-tabs" >
  2. <li><a href = "#home" data-toggle = "tab" > דף הבית </a></li>
  3. <li><a href = "#profile" data-toggle = "tab" > פרופיל </a></li>
  4. <li><a href = "#messages" data-toggle = "tab" > הודעות </a></li>
  5. <li><a href = "#settings" data-toggle = "tab" > הגדרות </a></li>
  6. </ul>

שיטות

$().tab

מפעיל רכיב טאב ומכל תוכן. ל-Tab צריך להיות צומת מיקוד data-targetאו hrefמיקוד לצומת מכיל ב-DOM.

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "active" ><a href = "#home" > דף הבית </a></li>
  3. <li><a href = "#profile" > פרופיל </a></li>
  4. <li><a href = "#messages" > הודעות </a></li>
  5. <li><a href = "#settings" > הגדרות </a></li>
  6. </ul>
  7.  
  8. <div class = "tab-content" >
  9. <div class = "tab-pane active" id = "home" > ... </div>
  10. <div class = "tab-pane" id = "profile" > ... </div>
  11. <div class = "tab-pane" id = "messages" > ... </div>
  12. <div class = "tab-pane" id = "הגדרות" > ... </div>
  13. </div>
  14.  
  15. <script>
  16. $ ( function () {
  17. $ ( '#myTab a:last' ). tab ( 'הצג' );
  18. })
  19. </script>

אירועים

מִקרֶה תיאור
הופעה אירוע זה מופעל בהצגת כרטיסיות, אך לפני שהכרטיסייה החדשה הוצגה. השתמש event.targetובכדי event.relatedTargetלמקד ללשונית הפעילה ולכרטיסייה הפעילה הקודמת (אם זמינה) בהתאמה.
מוצג אירוע זה מופעל בהצגת כרטיסיות לאחר הצגת כרטיסייה. השתמש event.targetובכדי event.relatedTargetלמקד ללשונית הפעילה ולכרטיסייה הפעילה הקודמת (אם זמינה) בהתאמה.
  1. $ ( 'a[data-toggle="tab"]' ). on ( 'מוצג' , function ( e ) {
  2. ה . target // הכרטיסייה מופעלת
  3. ה . relatedTarget // הכרטיסייה הקודמת
  4. })

דוגמאות

בהשראת התוסף המצוין jQuery.tipsy שנכתב על ידי Jason Frame; עצות כלים הן גרסה מעודכנת, שאינה מסתמכת על תמונות, משתמשת ב-CSS3 עבור אנימציות ותכונות נתונים לאחסון כותרות מקומיות.

מטעמי ביצועים, תיאור הכלים ו-Popover Data-APis ניתנים להצטרפות, כלומר עליך לאתחל אותם בעצמך .

רחף מעל הקישורים למטה כדי לראות עצות כלים:

מכנסיים צמודים כאפיה סביר להניח שלא שמעתם עליהם. תא צילום זקן גולמי דנים בדפוס טבעוני תיק שליח stumptown. סייטן מחווה לשולחן, לביגוד אמריקאי קינואה 8 סיביות מבית Mcsweeney's fixie, יש טרי ריצ'רדסון ויניל צ'מברי. Beard stumptown, קרדיגנים banh mi lomo thundercats. טופו ביודיזל ויליאמבורג מרפה, ארבעת לוקו מק'סוויני'ס מנקה שמבריי טבעוני. אומן ממש אירוני , לא משנה מה keytar, scenster farm-to-table banksy Austin Twitter handle freegan cred raw dins קפה ויראלי.

ארבעה כיוונים

עצות כלים בקבוצות קלט

בעת שימוש בטיפים של כלים ופופ-אובר עם קבוצות הקלט של Bootstrap, תצטרך להגדיר את containerהאפשרות (המתועדת למטה) כדי למנוע תופעות לוואי לא רצויות.


נוֹהָג

הפעל את הסבר הכלי באמצעות JavaScript:

  1. $ ( '#example' ). טיפים ( אפשרויות )

אפשרויות

ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-, כמו ב- data-animation="".

שֵׁם סוּג בְּרִירַת מֶחדָל תיאור
אנימציה בוליאני נָכוֹן החל מעבר דהייה של css על הסבר הכלי
html בוליאני שֶׁקֶר הכנס html להסבר הכלי. אם false, השיטה של ​​jquery textתשמש להכנסת תוכן ל-dom. השתמש בטקסט אם אתה מודאג מהתקפות XSS.
מיקום מחרוזת | פוּנקצִיָה 'חלק עליון' כיצד למקם את הסבר הכלי - למעלה | תחתון | שמאל | ימין
בוחר חוּט שֶׁקֶר אם מסופק בורר, אובייקטי תיאור כלים יואצלו ליעדים שצוינו.
כותרת מחרוזת | פוּנקצִיָה '' ערך כותרת ברירת מחדל אם תג 'title' אינו קיים
הדק חוּט 'פוקוס לרחף' כיצד מופעלת הסבר כלים - לחץ על | לרחף | מיקוד | מדריך ל. שים לב שאתה מעביר את הטריגר מרובים, מופרדים בין רווחים, סוגי טריגרים.
לְעַכֵּב מספר | לְהִתְנַגֵד 0

עיכוב הצגה והסתרה של הסבר הכלי (ms) - אינו חל על סוג טריגר ידני

אם מסופק מספר, השהיה מוחל גם על הסתרה/הצגה

מבנה האובייקט הוא:delay: { show: 500, hide: 100 }

מְכוֹלָה מחרוזת | שֶׁקֶר שֶׁקֶר

מוסיף את הסבר הכלי לרכיב מסויםcontainer: 'body'

שימו לב! לחילופין ניתן לציין אפשרויות עבור עצות כלים בודדות באמצעות שימוש בתכונות נתונים.

סימון

  1. <a href = "#" data-toggle = "tooltip" title = "tooltip ראשון" > העבר את העכבר מעלי </a>

שיטות

$().tooltip(options)

מצרף מטפל בתיאור כלים לאוסף אלמנטים.

.tooltip('show')

חושף תיאור כלי של אלמנט.

  1. $ ( '#element' ). הסבר כלים ( 'הצג' )

.tooltip('hide')

מסתיר תיאור כלי של רכיב.

  1. $ ( '#element' ). הסבר כלים ( 'הסתר' )

.tooltip('toggle')

מחליף תיאור כלי של רכיב.

  1. $ ( '#element' ). הסבר כלים ( 'להחליף' )

.tooltip('destroy')

מסתיר והורס את הסבר הכלי של אלמנט.

  1. $ ( '#element' ). טיפים ( 'להרוס' )

דוגמאות

הוסף שכבות-על קטנות של תוכן, כמו אלו באייפד, לכל רכיב לאחסון מידע משני. העבר את העכבר מעל הלחצן כדי להפעיל את הפופ-אובר. דורש הכללה של הסבר כלי .

פופ-אובר סטטי

ארבע אפשרויות זמינות: מיושרות למעלה, ימינה, למטה ושמאלה.

טופ אובר

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

פופאובר נכון

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

תחתית קופץ

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

פופ-אובר שמאלה

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

שום סימון שמוצג כפופ-אובר לא נוצר מ-JavaScript ומתוכן בתוך dataתכונה.

דמו ישיר

ארבעה כיוונים


נוֹהָג

הפעל חלונות קופצים באמצעות JavaScript:

  1. $ ( '#example' ). קופץ ( אפשרויות )

אפשרויות

ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-, כמו ב- data-animation="".

שֵׁם סוּג בְּרִירַת מֶחדָל תיאור
אנימציה בוליאני נָכוֹן החל מעבר דהייה של css על הסבר הכלי
html בוליאני שֶׁקֶר הכנס html לתוך הפופ-אובר. אם false, השיטה של ​​jquery textתשמש להכנסת תוכן ל-dom. השתמש בטקסט אם אתה מודאג מהתקפות XSS.
מיקום מחרוזת | פוּנקצִיָה 'ימין' איך למקם את הפופ-אובר - למעלה | תחתון | שמאל | ימין
בוחר חוּט שֶׁקֶר אם מסופק בורר, אובייקטי תיאור כלים יואצלו ליעדים שצוינו
הדק חוּט 'נְקִישָׁה' כיצד מופעל פופ-אובר - לחץ על | לרחף | מיקוד | מדריך ל
כותרת מחרוזת | פוּנקצִיָה '' ערך ברירת המחדל של כותרת אם תכונת 'title' אינה קיימת
תוֹכֶן מחרוזת | פוּנקצִיָה '' ערך ברירת המחדל של תוכן אם התכונה 'נתונים-תוכן' אינה קיימת
לְעַכֵּב מספר | לְהִתְנַגֵד 0

השהיה בהצגה והסתרה של הפופ-אובר (ms) - לא חל על סוג טריגר ידני

אם מסופק מספר, השהיה מוחל גם על הסתרה/הצגה

מבנה האובייקט הוא:delay: { show: 500, hide: 100 }

מְכוֹלָה מחרוזת | שֶׁקֶר שֶׁקֶר

מוסיף את הפופ-אובר לרכיב מסויםcontainer: 'body'

שימו לב! לחלופין ניתן לציין אפשרויות עבור פופ-אובר בודדים באמצעות שימוש בתכונות נתונים.

סימון

מטעמי ביצועים, ה-Tooltip ו-Popover data-apis ניתנים להצטרפות. אם תרצה להשתמש בהם פשוט ציין אפשרות בורר.

שיטות

$().popover(options)

מאתחל פופ-אובר עבור אוסף אלמנטים.

.popover('show')

חושף פריצת אלמנטים.

  1. $ ( '#element' ). popover ( 'הצג' )

.popover('hide')

מסתיר חלון קופץ של אלמנטים.

  1. $ ( '#element' ). popover ( 'להסתיר' )

.popover('toggle')

מחליף חלון קופץ של רכיבים.

  1. $ ( '#element' ). popover ( 'להחליף' )

.popover('destroy')

מסתיר והורס פופ-אובר של אלמנט.

  1. $ ( '#element' ). popover ( 'להרוס' )

התראות לדוגמה

הוסף פונקציונליות ביטול לכל הודעות ההתראה באמצעות תוסף זה.

גוואקמולי קדוש! הכי טוב תבדוק את עצמך, אתה לא נראה טוב מדי.

אוי! יש לך שגיאה!

שנה את זה ואת זה ונסה שוב. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

בצע פעולה זו או לעשות את זה


נוֹהָג

אפשר ביטול של התראה באמצעות JavaScript:

  1. $ ( ".alert" ). התראה ()

סימון

פשוט הוסף data-dismiss="alert"ללחצן הסגירה שלך כדי לתת פונקציונליות סגירה אוטומטית של התראה.

  1. <a class = "close" data-dismiss = "alert" href = "#" > × </a>

שיטות

$().alert()

עוטף את כל ההתראות עם פונקציונליות קרובה. כדי שההתראות שלך יופעלו כשהן סגורות, ודא שכבר הוחל עליהן את ה- .fadeand class..in

.alert('close')

סוגר התראה.

  1. $ ( ".alert" ). התראה ( 'סגור' )

אירועים

מחלקת ההתראה של Bootstrap חושפת כמה אירועים לחיבור לפונקציונליות ההתראה.

מִקרֶה תיאור
סגור אירוע זה מופעל מיד כאשר closeשיטת המופע נקראת.
סָגוּר אירוע זה מופעל כאשר ההתראה נסגרה (יחכה לסיום מעברי css).
  1. $ ( '#my-alert' ). bind ( 'סגור' , function () {
  2. // עשה משהו…
  3. })

שימושים לדוגמה

עשה יותר עם כפתורים. שליטה במצבי לחצנים או צור קבוצות של לחצנים עבור רכיבים נוספים כמו סרגלי כלים.

ממלכתי

הוסף data-loading-text="Loading..."כדי להשתמש במצב טעינה על כפתור.

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "טוען..." > מצב טעינה </button>

מתג יחיד

הוסף data-toggle="button"כדי להפעיל החלפת מצב בלחצן בודד.

  1. <button type = "button" class = "btn btn-primary" data-toggle = "button" > החלפת מצב יחיד </button>

תיבת סימון

הוסף data-toggle="buttons-checkbox"עבור החלפת סגנון תיבת סימון ב-btn-group.

  1. <div class = "btn-group" data-toggle = "buttons-checkbox" >
  2. <button type = "button" class = "btn btn-primary" > שמאל </button>
  3. <button type = "button" class = "btn btn-primary" > אמצעי </button>
  4. <button type = "button" class = "btn btn-primary" > מימין </button>
  5. </div>

רָדִיוֹ

הוסף data-toggle="buttons-radio"להחלפה בסגנון רדיו ב-btn-group.

  1. <div class = "btn-group" data-toggle = "buttons-radio" >
  2. <button type = "button" class = "btn btn-primary" > שמאל </button>
  3. <button type = "button" class = "btn btn-primary" > אמצעי </button>
  4. <button type = "button" class = "btn btn-primary" > מימין </button>
  5. </div>

נוֹהָג

אפשר לחצנים באמצעות JavaScript:

  1. $ ( '.nav-tabs' ). כפתור ()

סימון

תכונות הנתונים הן חלק בלתי נפרד מהפלאגין של הכפתורים. בדוק את הקוד לדוגמה למטה עבור סוגי הסימון השונים.

אפשרויות

אף אחד

שיטות

$().button('toggle')

מחליף מצב דחיפה. נותן לכפתור את המראה שהוא הופעל.

שימו לב! אתה יכול לאפשר החלפה אוטומטית של כפתור באמצעות data-toggleהתכונה.
  1. <button type = "button" class = "btn" data-toggle = "button" > </button>

$().button('טעינה')

מגדיר את מצב הכפתור לטעינה - משבית כפתור ומחליף טקסט לטעינת טקסט. טעינת טקסט צריכה להיות מוגדרת ברכיב הלחצן באמצעות תכונת הנתונים data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "טוען דברים..." > ... </button>
שימו לב! פיירפוקס מחזיק במצב מושבת בכל טעינות דפים . דרך לעקיפת הבעיה היא להשתמש ב- autocomplete="off".

$().button('reset')

מאפס מצב כפתור - מחליף טקסט לטקסט מקורי.

$().button(string)

מאפס מצב כפתור - מחליף טקסט לכל מצב טקסט מוגדר בנתונים.

  1. <button type = "button" class = "btn" data-complete-text = "סיים!" > ... </button>
  2. <script>
  3. $ ( '.btn' ). כפתור ( 'השלם' )
  4. </script>

על אודות

קבל סגנונות בסיסיים ותמיכה גמישה עבור רכיבים מתקפלים כמו אקורדיונים וניווט.

* מחייב את התוסף Transitions להיכלל.

אקורדיון לדוגמא

באמצעות תוסף ה-Clapse, בנינו ווידג'ט פשוט בסגנון אקורדיון:

Anim pariatur קלישאה reprehenderit, enim eiusmod high life accusamus טרי ריצ'רדסון עד דיונון. 3 wolf moon officia aute, non cupidatat סקייטבורד דולו בראנץ'. משאית אוכל קינואה nesciunt laborum eiusmod. בראנץ' 3 זאב ירח טמפור, sunt aliqua לשים עליו ציפור דיונון קפה ממקור יחיד nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. מודעה טבעונית חוץ מאטליז סגן לומו. חותלות occaecat בירה מלאכה מחווה לשולחן, ג'ינס גולמי סינתטי אסתטי, כנראה שלא שמעתם עליהם accusamus labore VHS בר קיימא.
Anim pariatur קלישאה reprehenderit, enim eiusmod high life accusamus טרי ריצ'רדסון עד דיונון. 3 wolf moon officia aute, non cupidatat סקייטבורד דולו בראנץ'. משאית אוכל קינואה nesciunt laborum eiusmod. בראנץ' 3 זאב ירח טמפור, sunt aliqua לשים עליו ציפור דיונון קפה ממקור יחיד nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. מודעה טבעונית חוץ מאטליז סגן לומו. חותלות occaecat בירה מלאכה מחווה לשולחן, ג'ינס גולמי סינתטי אסתטי, כנראה שלא שמעתם עליהם accusamus labore VHS בר קיימא.
Anim pariatur קלישאה reprehenderit, enim eiusmod high life accusamus טרי ריצ'רדסון עד דיונון. 3 wolf moon officia aute, non cupidatat סקייטבורד דולו בראנץ'. משאית אוכל קינואה nesciunt laborum eiusmod. בראנץ' 3 זאב ירח טמפור, sunt aliqua לשים עליו ציפור דיונון קפה ממקור יחיד nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. מודעה טבעונית חוץ מאטליז סגן לומו. חותלות occaecat בירה מלאכה מחווה לשולחן, ג'ינס גולמי סינתטי אסתטי, כנראה שלא שמעתם עליהם accusamus labore VHS בר קיימא.
  1. <div class = "accordion" id = "accordion2" >
  2. <div class = "accordion-group" >
  3. <div class = "accordion-heading" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
  5. פריט קבוצה מתקפל מס' 1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "התמוטטות הגוף באקורדיון" >
  9. <div class = "accordion-inner" >
  10. קלישאת אנימציה...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "accordion-group" >
  15. <div class = "accordion-heading" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. פריט קבוצה מתקפל מס' 2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "קריסת גוף אקורדיון" >
  21. <div class = "accordion-inner" >
  22. קלישאת אנימציה...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

אתה יכול גם להשתמש בתוסף ללא סימון האקורדיון. הפוך כפתור למעבר בין הרחבה וקריסה של אלמנט אחר.

  1. <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
  2. פשוט מתקפל
  3. </button>
  4.  
  5. <div id = "demo" class = "התמוטט" > </div>

נוֹהָג

באמצעות תכונות נתונים

פשוט הוסף data-toggle="collapse"ו- data-targetto אלמנט כדי להקצות אוטומטית שליטה על אלמנט מתקפל. התכונה data-targetמקבלת בורר css להחיל את הכיווץ עליו. הקפד להוסיף את המחלקה collapseלרכיב הניתן לקיפול. אם תרצה שהיא תיפתח כברירת מחדל, הוסף את המחלקה הנוספת in.

כדי להוסיף ניהול קבוצתי דמוי אקורדיון לשלט מתקפל, הוסף את תכונת הנתונים data-parent="#selector". עיין בהדגמה כדי לראות את זה בפעולה.

דרך JavaScript

הפעל באופן ידני עם:

  1. $ ( ".collapse" ). להתמוטט ()

אפשרויות

ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-, כמו ב- data-parent="".

שֵׁם סוּג בְּרִירַת מֶחדָל תיאור
הוֹרֶה בוחר שֶׁקֶר אם הבורר, כל הרכיבים הניתנים לכיפול תחת האב שצוין ייסגרו כאשר פריט מתקפל זה יוצג. (בדומה להתנהגות האקורדיון המסורתית)
לְמַתֵג בוליאני נָכוֹן מחליפה את הרכיב הניתן לקריסה בעת הפניה

שיטות

.collapse(אפשרויות)

מפעיל את התוכן שלך כאלמנט מתקפל. מקבל אפשרויות אופציונליות object.

  1. $ ( '#myCollapsible' ). לכווץ ({
  2. למתג : שקר
  3. })

.collapse('toggle')

מחליף רכיב שניתן להתכווץ לתצוגה או להסתרה.

.collapse('show')

מציג אלמנט מתקפל.

.collapse('hide')

מסתיר אלמנט מתקפל.

אירועים

מחלקת הקריסה של Bootstrap חושפת כמה אירועים לחיבור לפונקציונליות התמוטטות.

מִקרֶה תיאור
הופעה אירוע זה מופעל מיד כאשר showשיטת המופע נקראת.
מוצג אירוע זה מופעל כאשר רכיב כיווץ נעשה גלוי למשתמש (יחכה לסיום מעברי css).
להתחבא אירוע זה מופעל מיד כאשר hideהשיטה נקראה.
מוּסתָר אירוע זה מופעל כאשר אלמנט כיווץ הוסתר מהמשתמש (יחכה לסיום מעברי css).
  1. $ ( '#myCollapsible' ). on ( 'מוסתר' , function () {
  2. // עשה משהו…
  3. })

דוגמא

תוסף בסיסי, מורחב בקלות ליצירה מהירה של ראשי כתיבה אלגנטיים עם כל קלט טקסט.

  1. <input type = "text" data-provide = "typeahead" >

תרצה להגדיר autocomplete="off"למנוע מתפריטי ברירת מחדל של דפדפן להופיע מעל התפריט הנפתח Bootstrap typeahead.


נוֹהָג

באמצעות תכונות נתונים

הוסף תכונות נתונים כדי לרשום אלמנט עם פונקציונליות typeahead כפי שמוצג בדוגמה למעלה.

דרך JavaScript

התקשר לראש ההקלדה ידנית עם:

  1. $ ( '.typeahead' ). הקלדה ()

אפשרויות

ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-, כמו ב- data-source="".

שֵׁם סוּג בְּרִירַת מֶחדָל תיאור
מָקוֹר מערך, פונקציה [ ] מקור הנתונים שכנגדו יש לבצע שאילתה. יכול להיות מערך של מחרוזות או פונקציה. הפונקציה מועברת שני ארגומנטים, queryהערך בשדה הקלט והקריאה לאחור process. ניתן להשתמש בפונקציה באופן סינכרוני על ידי החזרת מקור הנתונים ישירות או באופן אסינכרוני באמצעות processהארגומנט היחיד של ה-callback.
פריטים מספר 8 המספר המרבי של פריטים להצגה בתפריט הנפתח.
minLength מספר 1 אורך התווים המינימלי הדרוש לפני הפעלת הצעות השלמה אוטומטית
שדכן פוּנקצִיָה חסר רגישות לרישיות השיטה המשמשת כדי לקבוע אם שאילתה תואמת לפריט. מקבל ארגומנט בודד, itemשכנגדו יש לבדוק את השאילתה. גש לשאילתה הנוכחית באמצעות this.query. החזר ערך בוליאני trueאם השאילתה מתאימה.
מְמַיֵן פוּנקצִיָה התאמה מדויקת,
רגישות רישיות,
לא רגישות רישיות
שיטה המשמשת למיון תוצאות השלמה אוטומטית. מקבל ארגומנט בודד itemsויש לו את ההיקף של מופע typeahead. עיין בשאילתה הנוכחית באמצעות this.query.
מעדכן פוּנקצִיָה מחזיר פריט נבחר השיטה המשמשת להחזרת הפריט שנבחר. מקבל ארגומנט בודד, ה- itemand יש את ההיקף של מופע typeahead.
מרקר מדגיש פוּנקצִיָה מדגיש את כל התאמות ברירת המחדל שיטה המשמשת להדגשת תוצאות השלמה אוטומטית. מקבל ארגומנט בודד itemויש לו את ההיקף של מופע typeahead. צריך להחזיר html.

שיטות

.typeahead(Options)

מאתחל קלט עם מקדמה.

דוגמא

הניווט המשנה משמאל הוא הדגמה חיה של תוסף האפיקס.


נוֹהָג

באמצעות תכונות נתונים

כדי להוסיף בקלות התנהגות הדבקה לכל אלמנט, פשוט הוסף data-spy="affix"לרכיב שאתה רוצה לרגל אחריו. לאחר מכן השתמש בהיסטים כדי להגדיר מתי להפעיל ולכבות את ההצמדה של אלמנט.

  1. <div data-spy = "affix" data-offset-top = "200" > ... </div>
שימו לב! עליך לנהל את המיקום של אלמנט מוצמד ואת ההתנהגות של ההורה המיידי שלו. המיקום נשלט על ידי affix, affix-top, ו affix-bottom. זכור לבדוק אם יש הורה שעלול להתמוטט כאשר ההדבקה נכנסת כאשר היא מסירה תוכן מהזרימה הרגילה של הדף.

דרך JavaScript

התקשר לפלאגין האפיק באמצעות JavaScript:

  1. $ ( '#navbar' ). להדביק ()

אפשרויות

ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-, כמו ב- data-offset-top="200".

שֵׁם סוּג בְּרִירַת מֶחדָל תיאור
לְקַזֵז מספר | פונקציה | לְהִתְנַגֵד 10 פיקסלים לקיזוז מהמסך בעת חישוב מיקום הגלילה. אם מסופק מספר בודד, ההיסט יחול הן בכיוון העליון והן בכיוון השמאלי. כדי להאזין לכיוון בודד, או לקיזוזים ייחודיים מרובים, פשוט ספק אובייקט offset: { x: 10 }. השתמש בפונקציה כאשר אתה צריך לספק היסט באופן דינמי (שימושי עבור כמה עיצובים מגיבים).