הבא לחיים את הרכיבים של Bootstrap - כעת עם 13 תוספי jQuery מותאמים אישית.
ניתן לכלול תוספים בנפרד (אם כי לחלקם יש תלות נדרשת), או בבת אחת. גם bootstrap.js וגם bootstrap.min.js מכילים את כל התוספים בקובץ אחד.
אתה יכול להשתמש בכל התוספים של Bootstrap אך ורק דרך ממשק ה-API מבלי לכתוב שורה אחת של JavaScript. זהו ה-API המחלקה הראשונה של Bootstrap וצריך להיות השיקול הראשון שלך בעת שימוש בתוסף.
עם זאת, במצבים מסוימים ייתכן שיהיה רצוי לכבות את הפונקציונליות הזו. לכן, אנו מספקים גם את היכולת להשבית את ה-API של תכונת הנתונים על ידי ביטול הכריכה של כל האירועים בגוף עם מרחב השמות עם `'data-api'`. זה נראה כך:
- $ ( 'גוף' ). כבוי ( '.data-api' )
לחלופין, כדי למקד לפלאגין ספציפי, פשוט כלול את שם הפלאגין כמרחב שמות יחד עם מרחב השמות של הנתונים-API כך:
- $ ( 'גוף' ). כבוי ( '.alert.data-api' )
אנו גם מאמינים שאתה אמור להיות מסוגל להשתמש בכל התוספים של Bootstrap אך ורק דרך ה-API של JavaScript. כל ממשקי ה-API הציבוריים הם שיטות בודדות, הניתנות לשרשרת, ומחזירות את האוסף שנעשה עליו.
- $ ( ".btn.danger" ). כפתור ( "להחליף" ). addClass ( "שמן" )
כל השיטות צריכות לקבל אובייקט אופציונלי אופציונלי, מחרוזת המכוונת לשיטה מסוימת, או שום דבר (אשר יוזם תוסף עם התנהגות ברירת מחדל):
- $ ( "#myModal" ). modal () // מאותחל עם ברירות מחדל
- $ ( "#myModal" ). modal ({ keyboard : false }) // אותחל ללא מקלדת
- $ ( "#myModal" ). modal ( 'show' ) // מאתחל ומפעיל את show באופן מיידי
כל תוסף גם חושף את הבנאי הגולמי שלו על מאפיין 'קונסטרוקטור': $.fn.popover.Constructor
. אם תרצה לקבל מופע פלאגין מסוים, אחזר אותו ישירות מאלמנט: $('[rel=popover]').data('popover')
.
לפעמים יש צורך להשתמש בתוספים של Bootstrap עם מסגרות משתמש אחרות. בנסיבות אלה, התנגשויות במרחב השמות יכולות להתרחש מדי פעם. אם זה קורה, אתה יכול להתקשר .noConflict
לפלאגין שברצונך להחזיר את הערך שלו.
- var bootstrapButton = $ . fn . כפתור . noConflict () // החזר את $.fn.button לערך שהוקצה קודם לכן
- $ . fn . bootstrapBtn = bootstrapButton // תן $().bootstrapBtn את פונקציונליות האתחול
Bootstrap מספק אירועים מותאמים אישית עבור רוב הפעולות הייחודיות של התוסף. בדרך כלל, אלה באים בצורה אינפינטיבית וחלק עבר - כאשר האינפיניטיב (לדוגמה show
) מופעל בתחילת אירוע, וצורת חלק העבר שלו (לדוגמה shown
) מופעלת עם השלמת פעולה.
כל האירועים האינסופיים מספקים פונקציונליות של preventDefault. זה מספק את היכולת לעצור את ביצוע הפעולה לפני שהיא מתחילה.
- $ ( '#myModal' ). on ( 'הצג' , פונקציה ( ה ) {
- אם (! נתונים ) מחזירים ה . preventDefault () // מפסיק את הצגת המודאל
- })
עבור אפקטי מעבר פשוטים, כלול את bootstrap-transition.js פעם אחת לצד שאר קבצי ה-JS. אם אתה משתמש ב- bootstrap.js המהודר (או ממוזער) , אין צורך לכלול את זה - הוא כבר שם.
כמה דוגמאות לפלאגין המעבר:
המודלים הם הודעות דו-שיח יעילות אך גמישות עם הפונקציונליות המינימלית הנדרשת וברירות מחדל חכמות.
מודל מעובד עם כותרת עליונה, גוף וקבוצת פעולות בכותרת התחתונה.
גוף אחד משובח…
- <div class = "modal hide fade" >
- <div class = "modal-header" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3> כותרת מודאלית </h3>
- </div>
- <div class = "modal-body" >
- <p> גוף נאה אחד... </p>
- </div>
- <div class = "modal-footer" >
- <a href = "#" class = "btn" > סגור </a>
- <a href = "#" class = "btn btn-primary" > שמור שינויים </a>
- </div>
- </div>
החלף מודאל באמצעות JavaScript על ידי לחיצה על הכפתור למטה. הוא יחליק מטה ויימוג מהחלק העליון של העמוד.
- <!-- לחצן להפעלת מודאל -->
- <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > הפעל הדגמה </a>
- <!-- Modal -->
- <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labeledby = "myModalLabel" aria-hidden = "true" >
- <div class = "modal-header" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3 id = "myModalLabel" > כותרת מודאלית </h3>
- </div>
- <div class = "modal-body" >
- <p> גוף נאה אחד... </p>
- </div>
- <div class = "modal-footer" >
- <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > סגור </button>
- <button class = "btn btn-primary" > שמור שינויים </button>
- </div>
- </div>
הפעל מודאל מבלי לכתוב JavaScript. הגדר data-toggle="modal"
על רכיב בקר, כמו כפתור, יחד עם data-target="#foo"
או href="#foo"
כדי למקד מודאל ספציפי למעבר.
- <button type = "button" data-toggle = "modal" data-target = "#myModal" > הפעל מודאלי </button>
התקשר למודאל עם מזהה myModal
עם שורה אחת של JavaScript:
- $ ( '#myModal' ). מודאלי ( אפשרויות )
ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-
, כמו ב- data-backdrop=""
.
שֵׁם | סוּג | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
רקע | בוליאני | נָכוֹן | כולל אלמנט רקע מודאלי. לחלופין, ציין static עבור רקע שאינו סוגר את המודאל בלחיצה. |
מקלדת | בוליאני | נָכוֹן | סוגר את המודאל בעת לחיצה על מקש Escape |
הופעה | בוליאני | נָכוֹן | מציג את המודאל בעת אתחול. |
מְרוּחָק | נָתִיב | שֶׁקֶר | אם מסופקת כתובת אתר מרוחקת, התוכן ייטען באמצעות
|
מפעיל את התוכן שלך כמודל. מקבל אפשרויות אופציונליות object
.
- $ ( '#myModal' ). מודאלי ({
- מקלדת : שקר
- })
מחליף מודאל באופן ידני.
- $ ( '#myModal' ). מודאלי ( 'להחליף' )
פותח מודאל באופן ידני.
- $ ( '#myModal' ). מודאלי ( 'הצג' )
מסתיר באופן ידני מודאל.
- $ ( '#myModal' ). מודאלי ( 'להסתיר' )
המחלקה המודאלית של Bootstrap חושפת כמה אירועים לחיבור לפונקציונליות מודאלית.
מִקרֶה | תיאור |
---|---|
הופעה | אירוע זה מופעל מיד כאשר show שיטת המופע נקראת. |
מוצג | אירוע זה מופעל כאשר המודאל נעשה גלוי למשתמש (יחכה לסיום מעברי css). |
להתחבא | אירוע זה מופעל מיד כאשר hide שיטת המופע נקראה. |
מוּסתָר | אירוע זה מופעל כאשר המודאל סיים להיות מוסתר מהמשתמש (יחכה לסיום מעברי css). |
- $ ( '#myModal' ). on ( 'מוסתר' , function () {
- // עשה משהו…
- })
הוסף תפריטים נפתחים כמעט לכל דבר עם התוסף הפשוט הזה, כולל סרגל הניווט, הכרטיסיות והכדורים.
הוסף data-toggle="dropdown"
לקישור או כפתור כדי להחליף תפריט נפתח.
- <div class = "dropdown" >
- <a class = "dropdown-toggle" data-toggle = "dropdown" href = "#" > מפעיל נפתח </a>
- <ul class = "dropdown-menu" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
כדי לשמור על כתובות אתרים שלמות, השתמש data-target
בתכונה במקום href="#"
.
- <div class = "dropdown" >
- <a class = "dropdown-toggle" id = "dLabel" role = "button" data-toggle = "dropdown" data-target = "#" href = "/page.html" >
- להפיל
- <b class = "caret" ></b>
- </a>
- <ul class = "dropdown-menu" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
התקשר לתפריטים הנפתחים באמצעות JavaScript:
- $ ( '.dropdown-toggle' ). תפריט נפתח ()
אף אחד
ממשק API פרוגרמטי להחלפת תפריטים עבור סרגל ניווט נתון או ניווט עם כרטיסיות.
התוסף 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.
סקייטבורד שפם של 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. סקייטבורד עזוב בירה מלאכת יד 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.
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
רכיב.
- <body data-spy = "scroll" data-target = ".navbar" > ... </body>
התקשר ל- scrollspy באמצעות JavaScript:
- $ ( '#navbar' ). scrollspy ()
<a href="#home">home</a>
חובה להתאים למשהו בדום כמו
<div id="home"></div>
.
בעת שימוש ב-scrollspy בשילוב עם הוספה או הסרה של אלמנטים מה-DOM, תצטרך לקרוא לשיטת הרענון כך:
- $ ( '[data-spy="scroll"]' ). each ( function () {
- var $spy = $ ( זה ). scrollspy ( 'רענן' )
- });
ניתן להעביר אפשרויות באמצעות תכונות נתונים או 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.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
אפשר כרטיסיות הניתנות לכרטיסיות באמצעות JavaScript (יש להפעיל כל כרטיסייה בנפרד):
- $ ( '#myTab a' ). לחץ ( פונקציה ( e ) {
- ה . preventDefault ();
- $ ( זה ). tab ( 'הצג' );
- })
אתה יכול להפעיל כרטיסיות בודדות בכמה דרכים:
- $ ( '#myTab a[href="#profile"]' ). tab ( 'הצג' ); // בחר כרטיסייה לפי שם
- $ ( '#myTab a:first' ). tab ( 'הצג' ); // בחר את הכרטיסייה הראשונה
- $ ( '#myTab a:last' ). tab ( 'הצג' ); // בחר את הכרטיסייה האחרונה
- $ ( '#myTab li:eq(2) a' ). tab ( 'הצג' ); // בחר כרטיסייה שלישית (אינדקס 0)
אתה יכול להפעיל טאב או ניווט בגלולה מבלי לכתוב שום JavaScript על ידי ציון data-toggle="tab"
או data-toggle="pill"
על אלמנט. הוספת המחלקות nav
ו nav-tabs
לכרטיסייה ul
תחיל את סגנון הכרטיסייה Bootstrap.
- <ul class = "nav nav-tabs" >
- <li><a href = "#home" data-toggle = "tab" > דף הבית </a></li>
- <li><a href = "#profile" data-toggle = "tab" > פרופיל </a></li>
- <li><a href = "#messages" data-toggle = "tab" > הודעות </a></li>
- <li><a href = "#settings" data-toggle = "tab" > הגדרות </a></li>
- </ul>
מפעיל רכיב טאב ומכל תוכן. ל-Tab צריך להיות צומת מיקוד data-target
או href
מיקוד לצומת מכיל ב-DOM.
- <ul class = "nav nav-tabs" id = "myTab" >
- <li class = "active" ><a href = "#home" > דף הבית </a></li>
- <li><a href = "#profile" > פרופיל </a></li>
- <li><a href = "#messages" > הודעות </a></li>
- <li><a href = "#settings" > הגדרות </a></li>
- </ul>
- <div class = "tab-content" >
- <div class = "tab-pane active" id = "home" > ... </div>
- <div class = "tab-pane" id = "profile" > ... </div>
- <div class = "tab-pane" id = "messages" > ... </div>
- <div class = "tab-pane" id = "הגדרות" > ... </div>
- </div>
- <script>
- $ ( פונקציה () {
- $ ( '#myTab a:last' ). tab ( 'הצג' );
- })
- </script>
מִקרֶה | תיאור |
---|---|
הופעה | אירוע זה מופעל בהצגת כרטיסיות, אך לפני שהכרטיסייה החדשה הוצגה. השתמש event.target ובכדי event.relatedTarget למקד ללשונית הפעילה ולכרטיסייה הפעילה הקודמת (אם זמינה) בהתאמה. |
מוצג | אירוע זה מופעל בהצגת כרטיסיות לאחר הצגת כרטיסייה. השתמש event.target ובכדי event.relatedTarget למקד ללשונית הפעילה ולכרטיסייה הפעילה הקודמת (אם זמינה) בהתאמה. |
- $ ( 'a[data-toggle="tab"]' ). on ( 'מוצג' , function ( e ) {
- ה . target // הכרטיסייה מופעלת
- ה . relatedTarget // הכרטיסייה הקודמת
- })
בהשראת התוסף המצוין 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 dim קפה ויראלי.
בעת שימוש בטיפים של כלים ופופ-אובר עם קבוצות הקלט של Bootstrap, תצטרך להגדיר את container
האפשרות (המתועדת למטה) כדי למנוע תופעות לוואי לא רצויות.
הפעל את הסבר הכלי באמצעות JavaScript:
- $ ( '#example' ). טיפים ( אפשרויות )
ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-
, כמו ב- data-animation=""
.
שֵׁם | סוּג | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
אנימציה | בוליאני | נָכוֹן | החל מעבר דהייה של css על הסבר הכלי |
html | בוליאני | שֶׁקֶר | הכנס html להסבר הכלי. אם false, השיטה של jquery text תשמש להכנסת תוכן ל-dom. השתמש בטקסט אם אתה מודאג מהתקפות XSS. |
מיקום | מחרוזת | פוּנקצִיָה | 'חלק עליון' | כיצד למקם את הסבר הכלי - למעלה | תחתון | שמאל | ימין |
בוחר | חוּט | שֶׁקֶר | אם מסופק בורר, אובייקטי תיאור כלים יואצלו ליעדים שצוינו. |
כותרת | מחרוזת | פוּנקצִיָה | '' | ערך כותרת ברירת מחדל אם תג 'title' אינו קיים |
הדק | חוּט | 'פוקוס לרחף' | כיצד מופעלת הסבר כלים - לחץ על | לרחף | מיקוד | מדריך ל. שים לב שאתה מעביר את הטריגר מרובים, מופרדים בין רווחים, סוגי טריגרים. |
לְעַכֵּב | מספר | לְהִתְנַגֵד | 0 | עיכוב הצגה והסתרה של הסבר הכלי (ms) - אינו חל על סוג טריגר ידני אם מסופק מספר, השהיה מוחל גם על הסתרה/הצגה מבנה האובייקט הוא: |
מְכוֹלָה | מחרוזת | שֶׁקֶר | שֶׁקֶר | מוסיף את הסבר הכלי לרכיב מסוים |
- <a href = "#" data-toggle = "tooltip" title = "tooltip ראשון" > העבר את העכבר מעלי </a>
מצרף מטפל בתיאור כלים לאוסף אלמנטים.
חושף תיאור כלי של אלמנט.
- $ ( '#element' ). הסבר כלים ( 'הצג' )
מסתיר תיאור כלי של אלמנט.
- $ ( '#element' ). הסבר כלים ( 'הסתר' )
מחליף תיאור כלי של רכיב.
- $ ( '#element' ). הסבר כלים ( 'להחליף' )
מסתיר והורס את הסבר הכלי של אלמנט.
- $ ( '#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:
- $ ( '#example' ). קופץ ( אפשרויות )
ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-
, כמו ב- data-animation=""
.
שֵׁם | סוּג | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
אנימציה | בוליאני | נָכוֹן | החל מעבר דהייה של css על הסבר הכלי |
html | בוליאני | שֶׁקֶר | הכנס HTML לתוך הפופ-אובר. אם false, השיטה של jquery text תשמש להכנסת תוכן ל-dom. השתמש בטקסט אם אתה מודאג מהתקפות XSS. |
מיקום | מחרוזת | פוּנקצִיָה | 'ימין' | איך למקם את הפופ-אובר - למעלה | תחתון | שמאל | ימין |
בוחר | חוּט | שֶׁקֶר | אם מסופק בורר, אובייקטי תיאור כלים יואצלו ליעדים שצוינו |
הדק | חוּט | 'נְקִישָׁה' | כיצד מופעל פופ-אובר - לחץ על | לרחף | מיקוד | מדריך ל |
כותרת | מחרוזת | פוּנקצִיָה | '' | ערך ברירת המחדל של כותרת אם תכונת 'title' אינה קיימת |
תוֹכֶן | מחרוזת | פוּנקצִיָה | '' | ערך ברירת המחדל של תוכן אם התכונה 'נתונים-תוכן' אינה קיימת |
לְעַכֵּב | מספר | לְהִתְנַגֵד | 0 | עיכוב הצגת והסתרת הפופ-אובר (ms) - אינו חל על סוג טריגר ידני אם מסופק מספר, השהיה מוחל גם על הסתרה/הצגה מבנה האובייקט הוא: |
מְכוֹלָה | מחרוזת | שֶׁקֶר | שֶׁקֶר | מוסיף את הפופ-אובר לרכיב מסוים |
מטעמי ביצועים, ה-Tooltip ו-Popover data-apis ניתנים להצטרפות. אם תרצה להשתמש בהם פשוט ציין אפשרות בורר.
מאתחל פופ-אובר עבור אוסף אלמנטים.
חושף פריצת אלמנטים.
- $ ( '#element' ). popover ( 'הצג' )
מסתיר חלון קופץ של אלמנטים.
- $ ( '#element' ). popover ( 'להסתיר' )
מחליף חלון קופץ של רכיבים.
- $ ( '#element' ). popover ( 'להחליף' )
מסתיר והורס פופ-אובר של אלמנט.
- $ ( '#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:
- $ ( ".alert" ). התראה ()
פשוט הוסף data-dismiss="alert"
ללחצן הסגירה שלך כדי לתת פונקציונליות סגירה אוטומטית של התראה.
- <a class = "close" data-dismiss = "alert" href = "#" > × </a>
עוטף את כל ההתראות עם פונקציונליות קרובה. כדי שההתראות שלך יופעלו כשהן סגורות, ודא שכבר הוחל עליהן את ה- .fade
and class..in
סוגר התראה.
- $ ( ".alert" ). התראה ( 'סגור' )
מחלקת ההתראה של Bootstrap חושפת כמה אירועים לחיבור לפונקציונליות ההתראה.
מִקרֶה | תיאור |
---|---|
סגור | אירוע זה מופעל מיד כאשר close שיטת המופע נקראת. |
סָגוּר | אירוע זה מופעל כאשר ההתראה נסגרה (יחכה לסיום מעברי css). |
- $ ( '#my-alert' ). bind ( 'סגור' , function () {
- // עשה משהו…
- })
קבל סגנונות בסיסיים ותמיכה גמישה עבור רכיבים מתקפלים כמו אקורדיונים וניווט.
* מחייב את התוסף Transitions להיכלל.
באמצעות תוסף ה-Clapse, בנינו ווידג'ט פשוט בסגנון אקורדיון:
- <div class = "accordion" id = "accordion2" >
- <div class = "accordion-group" >
- <div class = "accordion-heading" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
- פריט קבוצה מתקפל מס' 1
- </a>
- </div>
- <div id = "collapseOne" class = "התמוטטות הגוף באקורדיון" >
- <div class = "accordion-inner" >
- קלישאת אנימציה...
- </div>
- </div>
- </div>
- <div class = "accordion-group" >
- <div class = "accordion-heading" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
- פריט קבוצה מתקפל מס' 2
- </a>
- </div>
- <div id = "collapseTwo" class = "קריסת גוף אקורדיון" >
- <div class = "accordion-inner" >
- קלישאת אנימציה...
- </div>
- </div>
- </div>
- </div>
- ...
אתה יכול גם להשתמש בתוסף ללא סימון האקורדיון. הפוך כפתור למעבר בין הרחבה וקריסה של אלמנט אחר.
- <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
- פשוט מתקפל
- </button>
- <div id = "demo" class = "התמוטט" > … </div>
פשוט הוסף data-toggle="collapse"
ו- data-target
to אלמנט כדי להקצות אוטומטית שליטה על אלמנט מתקפל. התכונה data-target
מקבלת בורר css להחיל את הכיווץ עליו. הקפד להוסיף את המחלקה collapse
לרכיב הניתן לקיפול. אם תרצה שהיא תיפתח כברירת מחדל, הוסף את המחלקה הנוספת in
.
כדי להוסיף ניהול קבוצתי דמוי אקורדיון לשלט מתקפל, הוסף את תכונת הנתונים data-parent="#selector"
. עיין בהדגמה כדי לראות את זה בפעולה.
הפעל באופן ידני עם:
- $ ( ".collapse" ). להתמוטט ()
ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-
, כמו ב- data-parent=""
.
שֵׁם | סוּג | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
הוֹרֶה | בוחר | שֶׁקֶר | אם הבורר, כל הרכיבים הניתנים לכיפול תחת האב שצוין ייסגרו כאשר פריט מתקפל זה יוצג. (בדומה להתנהגות האקורדיון המסורתית) |
לְמַתֵג | בוליאני | נָכוֹן | מחליפה את הרכיב הניתן לקריסה בעת הפניה |
מפעיל את התוכן שלך כאלמנט מתקפל. מקבל אפשרויות אופציונליות object
.
- $ ( '#myCollapsible' ). לכווץ ({
- למתג : שקר
- })
מחליף רכיב שניתן להתכווץ לתצוגה או להסתרה.
מציג אלמנט מתקפל.
מסתיר אלמנט מתקפל.
מחלקת הקריסה של Bootstrap חושפת כמה אירועים לחיבור לפונקציונליות התמוטטות.
מִקרֶה | תיאור |
---|---|
הופעה | אירוע זה מופעל מיד כאשר show שיטת המופע נקראת. |
מוצג | אירוע זה מופעל כאשר רכיב כיווץ נעשה גלוי למשתמש (יחכה לסיום מעברי css). |
להתחבא | אירוע זה מופעל מיד כאשר hide השיטה נקראה. |
מוּסתָר | אירוע זה מופעל כאשר אלמנט כיווץ הוסתר מהמשתמש (יחכה לסיום מעברי css). |
- $ ( '#myCollapsible' ). on ( 'מוסתר' , function () {
- // עשה משהו…
- })
מצגת השקופיות למטה מציגה תוסף ורכיב גנרי לרכיבה על אופניים דרך אלמנטים כמו קרוסלה.
- <div id = "myCarousel" class = "שקופית קרוסלה" >
- <ol class = "קרוסלה-אינדיקטורים" >
- <li data-target = "#myCarousel" data-slide-to = "0" class = "active" ></li>
- <li data-target = "#myCarousel" data-slide-to = "1" ></li>
- <li data-target = "#myCarousel" data-slide-to = "2" ></li>
- </ol>
- <!-- פריטי קרוסלה -->
- <div class = "carousel-inner" >
- <div class = "פריט פעיל" > … </div>
- <div class = "item" > … </div>
- <div class = "item" > … </div>
- </div>
- <!-- ניווט קרוסלה -->
- <a class = "carousel-control left" href = "#myCarousel" data-slide = "prev" > ‹ </a>
- <a class = "carousel-control right" href = "#myCarousel" data-slide = "הבא" > › </a>
- </div>
השתמש בתכונות נתונים כדי לשלוט בקלות במיקום הקרוסלה. data-slide
מקבל את מילות המפתח prev
או next
, אשר משנה את מיקום השקף ביחס למיקום הנוכחי שלו. לחלופין, השתמש data-slide-to
כדי להעביר אינדקס שקופיות גולמי לקרוסלה data-slide-to="2"
, אשר קפיצה היא מיקום השקופית לאינדקס מסוים שמתחיל ב- 0
.
התקשר לקרוסלה באופן ידני עם:
- $ ( '.carousel' ). קרוסלה ()
ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScriptz. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-
, כמו ב- data-interval=""
.
שֵׁם | סוּג | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
הַפסָקָה | מספר | 5000 | משך הזמן שיש לעכב בין רכיבה אוטומטית של פריט. אם לא נכון, הקרוסלה לא תעבור אוטומטית. |
הַפסָקָה | חוּט | "לְרַחֵף" | משהה את רכיבת הקרוסלה ב-mouseenter ומחדש את רכיבת הקרוסלה ב-mouseleave. |
מאתחל את הקרוסלה עם אפשרויות אופציונליות object
ומתחיל לרכוב על אופניים בין פריטים.
- $ ( '.carousel' ). קרוסלה ({
- מרווח : 2000
- })
עובר במחזוריות בין פריטי הקרוסלה משמאל לימין.
מונע מהקרוסלה לרכוב על אופניים דרך פריטים.
מעביר את הקרוסלה למסגרת מסוימת (מבוסס 0, בדומה למערך).
עובר אל הפריט הקודם.
עוברים לפריט הבא.
כיתת הקרוסלה של Bootstrap חושפת שני אירועים לחיבור לפונקציונליות הקרוסלה.
מִקרֶה | תיאור |
---|---|
שקופית | אירוע זה מופעל מיד כאשר slide שיטת המופע מופעלת. |
החליק | אירוע זה מופעל כאשר הקרוסלה השלימה את מעבר השקופיות שלה. |
תוסף בסיסי, מורחב בקלות ליצירה מהירה של ראשי כתיבה אלגנטיים עם כל קלט טקסט.
- <input type = "text" data-provide = "typeahead" >
תרצה להגדיר autocomplete="off"
למנוע מתפריטי ברירת מחדל של דפדפן להופיע מעל התפריט הנפתח Bootstrap typeahead.
הוסף תכונות נתונים כדי לרשום אלמנט עם פונקציונליות typeahead כפי שמוצג בדוגמה למעלה.
התקשר לראש ההקלדה ידנית עם:
- $ ( '.typeahead' ). הקלדה ()
ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-
, כמו ב- data-source=""
.
שֵׁם | סוּג | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
מָקוֹר | מערך, פונקציה | [ ] | מקור הנתונים שכנגדו יש לבצע שאילתה. יכול להיות מערך של מחרוזות או פונקציה. הפונקציה מועברת שני ארגומנטים, query הערך בשדה הקלט והקריאה לאחור process . ניתן להשתמש בפונקציה באופן סינכרוני על ידי החזרת מקור הנתונים ישירות או באופן אסינכרוני באמצעות process הארגומנט היחיד של ה-callback. |
פריטים | מספר | 8 | המספר המרבי של פריטים להצגה בתפריט הנפתח. |
minLength | מספר | 1 | אורך התווים המינימלי הדרוש לפני הפעלת הצעות השלמה אוטומטית |
שדכן | פוּנקצִיָה | חסר רגישות לרישיות | השיטה המשמשת כדי לקבוע אם שאילתה תואמת לפריט. מקבל ארגומנט בודד, item שכנגדו יש לבדוק את השאילתה. גש לשאילתה הנוכחית באמצעות this.query . החזר ערך בוליאני true אם השאילתה מתאימה. |
מְמַיֵן | פוּנקצִיָה | התאמה מדויקת, רגישות רישיות, לא רגישות רישיות |
שיטה המשמשת למיון תוצאות השלמה אוטומטית. מקבל ארגומנט בודד items ויש לו את ההיקף של מופע typeahead. עיין בשאילתה הנוכחית באמצעות this.query . |
מעדכן | פוּנקצִיָה | מחזיר פריט נבחר | השיטה המשמשת להחזרת הפריט שנבחר. מקבל ארגומנט בודד, ה- item and יש את ההיקף של מופע typeahead. |
מרקר מדגיש | פוּנקצִיָה | מדגיש את כל התאמות ברירת המחדל | שיטה המשמשת להדגשת תוצאות השלמה אוטומטית. מקבל ארגומנט בודד item ויש לו את ההיקף של מופע typeahead. צריך להחזיר html. |
מאתחל קלט עם מקדמה.
הניווט המשנה משמאל הוא הדגמה חיה של תוסף האפיקס.
כדי להוסיף בקלות התנהגות הדבקה לכל אלמנט, פשוט הוסף data-spy="affix"
לרכיב שאתה רוצה לרגל אחריו. לאחר מכן השתמש בהיסטים כדי להגדיר מתי להפעיל ולכבות את ההצמדה של אלמנט.
- <div data-spy = "affix" data-offset-top = "200" > ... </div>
affix
,
affix-top
, ו
affix-bottom
. זכור לבדוק אם יש הורה שעלול להתמוטט כאשר ההדבקה נכנסת כאשר היא מסירה תוכן מהזרימה הרגילה של הדף.
התקשר לפלאגין האפיק באמצעות JavaScript:
- $ ( '#navbar' ). להדביק ()
ניתן להעביר אפשרויות באמצעות תכונות נתונים או JavaScript. עבור תכונות נתונים, הוסף את שם האפשרות ל- data-
, כמו ב- data-offset-top="200"
.
שֵׁם | סוּג | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
לְקַזֵז | מספר | פונקציה | לְהִתְנַגֵד | 10 | פיקסלים לקיזוז מהמסך בעת חישוב מיקום הגלילה. אם מסופק מספר בודד, ההיסט יחול הן בכיוון העליון והן בכיוון השמאלי. כדי להאזין לכיוון בודד, או לקיזוזים ייחודיים מרובים, פשוט ספק אובייקט offset: { x: 10 } . השתמש בפונקציה כאשר אתה צריך לספק היסט באופן דינמי (שימושי עבור כמה עיצובים מגיבים). |