جافا سكريبت

اجعل مكونات Bootstrap تنبض بالحياة - الآن مع 13 ملحق jQuery مخصصًا.

انتباه! هذه المستندات مخصصة للإصدار v2.3.2 ، والتي لم تعد مدعومة رسميًا. تحقق من أحدث إصدار من Bootstrap!

فردي أو مجمعة

يمكن تضمين المكونات الإضافية بشكل فردي (على الرغم من أن بعضها يتطلب تبعيات) ، أو كلها مرة واحدة. يحتوي كل من bootstrap.js و bootstrap.min.js على جميع المكونات الإضافية في ملف واحد.

سمات البيانات

يمكنك استخدام جميع ملحقات Bootstrap فقط من خلال واجهة برمجة تطبيقات العلامات دون كتابة سطر واحد من JavaScript. هذه هي واجهة برمجة التطبيقات من الدرجة الأولى من Bootstrap ويجب أن تكون الاعتبار الأول عند استخدام مكون إضافي.

ومع ذلك ، قد يكون من المرغوب في بعض المواقف إيقاف تشغيل هذه الوظيفة. لذلك ، نوفر أيضًا القدرة على تعطيل واجهة برمجة تطبيقات سمة البيانات عن طريق إلغاء ربط جميع الأحداث الموجودة على مساحة اسم الجسم بـ "" واجهة برمجة تطبيقات البيانات ". هذا يشبه هذا:

  1. $ ( "جسم" ). إيقاف ( ".data-api" )

بدلاً من ذلك ، لاستهداف مكون إضافي معين ، ما عليك سوى تضمين اسم المكون الإضافي كمساحة اسم إلى جانب مساحة اسم data-api مثل هذا:

  1. $ ( "جسم" ). متوقف ( ".alert.data-api" )

API برمجي

نعتقد أيضًا أنه يجب أن تكون قادرًا على استخدام جميع ملحقات Bootstrap فقط من خلال JavaScript API. جميع واجهات برمجة التطبيقات العامة هي طرق مفردة وقابلة للتسلسل ، وتعيد المجموعة التي تم التصرف بناءً عليها.

  1. $ ( ".btn.danger" ). زر ( "تبديل" ). addClass ( "سمين" )

يجب أن تقبل جميع التوابع كائن خيارات اختياري ، أو سلسلة تستهدف طريقة معينة ، أو لا شيء (الذي يبدأ مكونًا إضافيًا بسلوك افتراضي):

  1. $ ( "#myModal" ). مشروط () // مهيأ بالافتراضيات
  2. $ ( "#myModal" ). مشروط ({ keyboard : false }) // مهيأ بدون لوحة مفاتيح
  3. $ ( "#myModal" ). modal ( 'show' ) // يهيئ ويستدعي إظهار على الفور

يعرض كل مكون إضافي أيضًا المُنشئ الخام الخاص به في خاصية "المُنشئ" $.fn.popover.Constructor:. إذا كنت ترغب في الحصول على مثيل مكون إضافي معين ، فاسترجعه مباشرةً من عنصر $('[rel=popover]').data('popover'):.

لا تعارض

في بعض الأحيان يكون من الضروري استخدام ملحقات Bootstrap مع أطر عمل أخرى لواجهة المستخدم. في هذه الحالات ، يمكن أن تحدث تضاربات مساحة الاسم أحيانًا. إذا حدث هذا ، فيمكنك الاتصال .noConflictعلى المكون الإضافي الذي ترغب في إرجاع قيمته.

  1. var bootstrapButton = $ . الجبهة الوطنية . زر . noConflict () // إرجاع $ .fn.button إلى القيمة المعينة مسبقًا
  2. $ . الجبهة الوطنية . bootstrapBtn = bootstrapButton // أعط $ (). bootstrapBtn وظيفة التمهيد

الأحداث

يوفر Bootstrap أحداثًا مخصصة لمعظم الإجراءات الفريدة للمكون الإضافي. بشكل عام ، تأتي هذه في صيغة المصدر والماضي - حيث يتم تشغيل المصدر (على سبيل المثال show) في بداية الحدث ، ويتم تشغيل شكل الفاعل الماضي ( shownعلى سبيل المثال) عند الانتهاء من إجراء ما.

توفر جميع أحداث المصدر وظيفة منع التشغيل الافتراضي. يوفر هذا القدرة على إيقاف تنفيذ الإجراء قبل أن يبدأ.

  1. $ ( "#myModal" ). on ( 'show' ، function ( e ) {
  2. إذا (! البيانات ) إرجاع البريد . PreventionDefault () // يوقف عرض الوسائط
  3. })

حول التحولات

للحصول على تأثيرات انتقال بسيطة ، قم بتضمين bootstrap-transfer.js مرة واحدة إلى جانب ملفات JS الأخرى. إذا كنت تستخدم ملف bootstrap.js المترجم (أو المصغر) ، فلا داعي لتضمينه - فهو موجود بالفعل.

استخدم حالات

بعض الأمثلة على البرنامج المساعد الانتقالي:

  • الانزلاق أو التلاشي في الوسائط
  • علامات تبويب تتلاشى
  • تلاشي التنبيهات
  • انزلاق الألواح الدائرية

أمثلة

الوسائط هي مطالبات حوار مبسطة ومرنة مع الحد الأدنى من الوظائف المطلوبة والافتراضيات الذكية.

مثال ثابت

نموذج تم تقديمه مع رأس ونص ومجموعة من الإجراءات في التذييل.

  1. <div class = "modal hide fade" >
  2. <div class = "modal-header" >
  3. <button type = "button" class = "إغلاق" data-رفض = "modal" aria-hidden = "true" > & times؛ </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. <! - مشروط ->
  5. <div id = "myModal" class = "تلاشي إخفاء مشروط" tabindex = "-1" role = " اور " aria-labelledby = " myModalLabel " aria-hidden = " true " >
  6. <div class = "modal-header" >
  7. <button type = "button" class = "close" data-رفض = "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- رفض = "modal" aria-hidden = "true" > إغلاق </ زر>
  15. <button class = "btn btn-primary" > حفظ التغييرات </ زر>
  16. </div>
  17. </div>

إستعمال

عبر سمات البيانات

تنشيط مشروط دون كتابة JavaScript. قم بتعيين data-toggle="modal"عنصر تحكم ، مثل زر ، مع data-target="#foo"أو href="#foo"لاستهداف نمط محدد للتبديل.

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" > نمط التشغيل </ زر>

عبر JavaScript

استدعاء مشروط مع معرف myModalبسطر واحد من JavaScript:

  1. $ ( "#myModal" ). مشروط ( خيارات )

خيارات

يمكن تمرير الخيارات عبر سمات البيانات أو JavaScript. لسمات البيانات ، قم بإلحاق اسم الخيار بـ data-، كما في data-backdrop="".

اسم يكتب إفتراضي وصف
خلفية قيمة منطقية حقيقي يتضمن عنصر خلفية مشروط. بدلاً من ذلك ، حدد staticخلفية لا تغلق النموذج عند النقر.
لوحة المفاتيح قيمة منطقية حقيقي يغلق المشروط عند الضغط على مفتاح الهروب
تبين قيمة منطقية حقيقي يظهر الشكل عند التهيئة.
التحكم عن بعد طريق خاطئة

إذا تم توفير عنوان url بعيد ، فسيتم تحميل المحتوى عبر loadطريقة jQuery وحقنه في ملف .modal-body. إذا كنت تستخدم واجهة برمجة تطبيقات البيانات ، فيمكنك بدلاً من ذلك استخدام hrefالعلامة لتحديد المصدر البعيد. ويرد أدناه مثال على ذلك:

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

طُرق

.modal (خيارات)

ينشط المحتوى الخاص بك كمشروط. يقبل الخيارات الاختيارية object.

  1. $ ( "#myModal" ). مشروط ({
  2. لوحة المفاتيح : خطأ
  3. })

.modal ("تبديل")

يبدل مشروط يدويًا.

  1. $ ( "#myModal" ). مشروط ( "تبديل" )

.modal ("show")

يفتح مشروط يدويا.

  1. $ ( "#myModal" ). مشروط ( "عرض" )

.modal ("إخفاء")

يدويا يخفي مشروط.

  1. $ ( "#myModal" ). مشروط ( "إخفاء" )

الأحداث

تكشف فئة مشروط Bootstrap عن بعض الأحداث للتثبيت في وظائف مشروطة.

حدث وصف
تبين يتم تشغيل هذا الحدث فورًا عند showاستدعاء أسلوب المثيل.
مبين يتم تشغيل هذا الحدث عندما يكون النموذج مرئيًا للمستخدم (سينتظر حتى تكتمل انتقالات css).
يخفي يتم تشغيل هذا الحدث فورًا عند hideاستدعاء أسلوب المثيل.
مختفي يتم تشغيل هذا الحدث عند انتهاء إخفاء النموذج عن المستخدم (سينتظر حتى تكتمل انتقالات css).
  1. $ ( "#myModal" ). on ( 'hidden' ، function () {
  2. // قم بعمل ما…
  3. })

المثال في نافبار

المكون الإضافي ScrollSpy مخصص لتحديث أهداف التنقل تلقائيًا بناءً على موضع التمرير. قم بالتمرير في المنطقة أسفل شريط التنقل وشاهد تغيير الفصل النشط. سيتم أيضًا تمييز العناصر الفرعية المنسدلة.

@سمين

طماق إعلانية ، Keytar ، brunch id art party dolor labore. Pitchfork yr enim lo-fi قبل بيعها بالكامل. حقوق دراجة Tumblr من المزرعة إلى المائدة مهما كانت. كارديغان كوفية كارليس برسمة أنيم. كشك تصوير فيليت سيتان مكسويني 3 وولف مون إيرور. سترة كوسبي lomo jean shorts ، williamsburg hoodie minim qui ربما لم تسمع بها على الأرجح وصندوق الائتمان كارديجان culpa biiodiesel wes anderson Aesthetic. نهيل موشوم الاتهام ، الفضل السخرية وقود الديزل الحيوي كوفية حرفي أولامكو يترتب على ذلك.

mdo

لوح تزلج Veniam Marfa شارب ، Adipisising Fugiat Velit Pitchfork Beard. فريجان بيرد أليكوا كيوبيداتات مكسويني فييرو. Cupidatat four loko nisi، ea helvetica nulla carles. شاحنة طعام سترة كوسبي موشومة ، فينيل ماكسيني غير حر. Lo-fi wes anderson +1 sartorial. تمارين كارليس غير الجمالية هي من الترميم. بروكلين أديبيسيسينج كرافت بيرة نائب مفتاح ديسيرونت.

واحد

Occaecat Goodso aliqua delectus. فاب كرافت بيرة deserunt لوح تزلج عصام. حقوق Lomo للدراجات adipisicing banh mi ، velit ea sunt المستوى التالي من قهوة أحادية المنشأ في ماغنا فينيام. High life id vinyl، echo park socat quis aliquip banh mi مذراة. Vero VHS هو adipisicing. Consectetur nisi DIY حقيبة ساعي صغيرة. Cred ex in ، مستدام delectus consectetur fanny pack iphone.

اثنين

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 ، حقيبة رسول culpa marfa مهما كانت شاحنة الطعام delectus. افتراضات معرف موالفة Sapiente. Locavore sed helvetica cliche المفارقة ، القطط الرعدية التي ربما لم تسمع بها م�� المحتمل أن تكون ذات قلنسوة خالية من الغلوتين. لابور إيليت بلاس قبل بيعها بالكامل ، تيري ريتشاردسون برويدنت برانش نيسكون كويس كنزة كوسبي بارياتور كوفية أوت هيلفيتيكا حرفي. كارديجان كرافت بيرة seitan جاهز فيليت. VHS chambray labouris tempor veniam. الرسوم المتحركة mollit minim Goods 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 ("تحديث")

عند استخدام scrollspy مع إضافة عناصر أو إزالتها من DOM ، ستحتاج إلى استدعاء طريقة التحديث كما يلي:

  1. $ ( '[data-spy = "scroll"]' ). كل ( وظيفة () {
  2. var $ spy = $ ( this ). scrollspy ( "تحديث" )
  3. }) ؛

خيارات

يمكن تمرير الخيارات عبر سمات البيانات أو JavaScript. لسمات البيانات ، قم بإلحاق اسم الخيار بـ data-، كما في data-offset="".

اسم يكتب إفتراضي وصف
عوض رقم 10 بكسل للإزاحة من الأعلى عند حساب موضع التمرير.

الأحداث

حدث وصف
تفعيل يتم تشغيل هذا الحدث عندما يتم تنشيط عنصر جديد بواسطة scrollspy.

علامات التبويب سبيل المثال

أضف وظيفة علامات تبويب سريعة وديناميكية للانتقال عبر أجزاء المحتوى المحلي ، حتى عبر القوائم المنسدلة.

الدنيم الخام ربما لم تسمع به من سراويل الجينز أوستن. Nesciunt tofu stumptown aliqua ، تطهير ريترو سينث ماستر. شارب مبتذل مؤقت ، ويليامسبورغ كارليس نباتي هيلفيتيكا. Reprehenderit جزار الكوفية الرجعية موالفة زاك. Cosby sweater eu banh mi، qui irure terry richardson ex squid. أليكويب بلاسيت سالفيا سيلوم آيفون. سترة من Seitan Aliquip 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' ). انقر ( الوظيفة ( هـ ) {
  2. ه . PreventionDefault () ؛
  3. $ ( هذا ). علامة التبويب ( "إظهار" ) ؛
  4. })

يمكنك تنشيط علامات التبويب الفردية بعدة طرق:

  1. $ ( '#myTab a [href = "# ملف شخصي"]' ). علامة التبويب ( "إظهار" ) ؛ // حدد علامة التبويب بالاسم
  2. $ ( '#myTab a: first' ). علامة التبويب ( "إظهار" ) ؛ // حدد علامة التبويب الأولى
  3. $ ( '#myTab a: last' ). علامة التبويب ( "إظهار" ) ؛ // حدد علامة التبويب الأخيرة
  4. $ ( '#myTab li: eq (2) a' ). علامة التبويب ( "إظهار" ) ؛ // حدد علامة التبويب الثالثة (0 مفهرسة)

وضع علامة على

يمكنك تنشيط علامة تبويب أو التنقل على الأقراص دون كتابة أي JavaScript بمجرد تحديد عنصر data-toggle="tab"أو data-toggle="pill"على أحد العناصر. ستؤدي إضافة الفئات navو إلى علامة التبويب إلى تطبيق نمط علامة تبويب Bootstrap.nav-tabsul

  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>

طُرق

علامة التبويب $ ()

ينشط عنصر علامة تبويب وحاوية محتوى. يجب أن تحتوي علامة التبويب على عقدة حاوية data-targetأو تستهدفها في DOM.href

  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 = "settings" > ... </div>
  13. </div>
  14.  
  15. <script>
  16. $ ( الوظيفة () {
  17. $ ( '#myTab a: last' ). علامة التبويب ( "إظهار" ) ؛
  18. })
  19. </script>

الأحداث

حدث وصف
تبين يتم تشغيل هذا الحدث في علامة التبويب ، ولكن قبل ظهور علامة التبويب الجديدة. استخدم event.targetو event.relatedTargetلاستهداف علامة التبويب النشطة وعلامة التبويب النشطة السابقة (إذا كانت متوفرة) على التوالي.
مبين يتم تشغيل هذا الحدث في علامة التبويب بعد عرض علامة التبويب. استخدم event.targetو event.relatedTargetلاستهداف علامة التبويب النشطة وعلامة التبويب النشطة السابقة (إذا كانت متوفرة) على التوالي.
  1. $ ( 'a [data-toggle = "tab"]' ). تشغيل ( "معروضة" ، الوظيفة ( هـ ) {
  2. ه . الهدف // علامة التبويب المنشط
  3. ه . relatedTarget // علامة التبويب السابقة
  4. })

أمثلة

مستوحى من البرنامج المساعد jQuery.tipsy الممتاز الذي كتبه Jason Frame ؛ تلميحات الأدوات هي نسخة محدثة لا تعتمد على الصور وتستخدم CSS3 للرسوم المتحركة وسمات البيانات لتخزين العنوان المحلي.

لأسباب تتعلق بالأداء ، تم تمكين تلميح الأدوات وواجهة برمجة التطبيقات المنبثقة ، مما يعني أنه يجب عليك تهيئتهما بنفسك .

مرر مؤشر الماوس فوق الروابط أدناه لمشاهدة تلميحات الأدوات:

بنطلون ضيق من المستوى التالي ربما لم تسمع به من قبل. كشك تصوير لحية الدنيم الخام Letterpress حقيبة ساعي نباتية stumptown. سيتان من المزرعة إلى المائدة ، ملابس الكينوا الأمريكية 8 بت التي تنتجها شركة ماكسيني والتي تحتوي على مادة تشامبراي من الفينيل تيري ريتشاردسون. Beard stumptown ، كارديغان بانه مي لومو ثندر كاتس. التوفو وقود الديزل الحيوي ويليامسبورغ مارفا ، أربعة شامبراي نباتي مطهر من لوكو مكسويني. حرفي مثير للسخرية حقًا أيا كان keytar ، البنوك من المزرعة إلى ا��مائدة ، أوستن تويتر ، تتعامل مع القهوة ذات الأصل الفردي الخالي من الدنيم.

أربعة اتجاهات

تلميحات الأدوات في مجموعات الإدخال

عند استخدام التلميحات والأدوات المنبثقة مع مجموعات إدخال Bootstrap ، سيتعين عليك تعيين الخيار container(الموثق أدناه) لتجنب الآثار الجانبية غير المرغوب فيها.


إستعمال

تشغيل تلميح الأداة عبر JavaScript:

  1. $ ( "# مثال" ). تلميح الأدوات ( خيارات )

خيارات

يمكن تمرير الخيارات عبر سمات البيانات أو JavaScript. لسمات البيانات ، قم بإلحاق اسم الخيار بـ data-، كما في data-animation="".

اسم يكتب إفتراضي وصف
الرسوم المتحركة قيمة منطقية حقيقي تطبيق انتقال تلاشي css إلى تلميح الأداة
لغة البرمجة قيمة منطقية خاطئة أدخل html في تلميح الأداة. إذا كانت خاطئة ، textفسيتم استخدام طريقة jquery لإدراج محتوى في dom. استخدم النص إذا كنت قلقًا بشأن هجمات XSS.
تحديد مستوى سلسلة | وظيفة 'أعلى' كيفية وضع تلميح - أعلى | أسفل | غادر | حقا
محدد سلسلة خاطئة إذا تم توفير محدد ، فسيتم تفويض كائنات تلميح الأدوات إلى الأهداف المحددة.
لقب سلسلة | وظيفة " قيمة العنوان الافتراضية إذا كانت علامة `العنوان` غير موجودة
اثار سلسلة "تحوم التركيز" كيف يتم تشغيل التلميح - انقر فوق | تحوم | التركيز | كتيب. لاحظ أن حالة تمرير الزناد متعددة ، مفصولة بمسافة ، أنواع المشغل.
تأخير رقم | هدف 0

التأخير في إظهار تلميح الأداة وإخفائه (بالمللي ثانية) - لا ينطبق على نوع المشغل اليدوي

إذا تم توفير رقم ، فسيتم تطبيق التأخير على كل من الإخفاء / العرض

هيكل الكائن هو:delay: { show: 500, hide: 100 }

وعاء سلسلة | خاطئة خاطئة

لإلحاق تلميح الأداة بعنصر معينcontainer: 'body'

انتباه! يمكن بدلاً من ذلك تحديد خيارات تلميحات الأدوات الفردية من خلال استخدام سمات البيانات.

وضع علامة على

  1. <a href = "#" data-toggle = "tooltip" title = "first tooltip"> مرر الماوس فوقي </a>

طُرق

$ (). تلميح الأدوات (خيارات)

يرفق معالج تلميح بمجموعة عنصر.

.tooltip ("show")

يكشف عن تلميح أداة عنصر.

  1. $ ( "# عنصر" ). تلميح أداة ( "عرض" )

.tooltip ("إخفاء")

يخفي تلميح أداة عنصر.

  1. $ ( "# عنصر" ). تلميح الأدوات ( "إخفاء" )

.tooltip ("تبديل")

يبدل تلميح أداة عنصر.

  1. $ ( "# عنصر" ). تلميح الأدوات ( "تبديل" )

.tooltip ("إتلاف")

يخفي تلميح عنصر ويتلفه.

  1. $ ( "# عنصر" ). تلميح الأدوات ( "تدمير" )

أمثلة

أضف تراكبات صغيرة من المحتوى ، مثل تلك الموجودة على iPad ، إلى أي عنصر يحتوي على معلومات ثانوية. قم بالمرور فوق الزر لتشغيل النافذة المنبثقة. يتطلب تضمين تلميح الأدوات .

انبثاق ثابت

تتوفر أربعة خيارات: محاذاة لأعلى ولليمين ولأسفل ولليسار.

المنبثقة أعلى

Sed posuere consectetur est في لوبورتيس. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover الحق

Sed posuere consectetur est في لوبورتيس. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover أسفل

Sed posuere consectetur est في لوبورتيس. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

غادر Popover

Sed posuere consectetur est في لوبورتيس. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

لا يتم عرض أي ترميز على أنه يتم إنشاء العناصر المنبثقة من جافا سكريبت والمحتوى داخل dataالسمة.

عرض حي

أربعة اتجاهات


إستعمال

تمكين العناصر المنبثقة عبر JavaScript:

  1. $ ( "# مثال" ). popover ( خيارات )

خيارات

يمكن تمرير الخيارات عبر سمات البيانات أو JavaScript. لسمات البيانات ، قم بإلحاق اسم الخيار بـ data-، كما في data-animation="".

اسم يكتب إفتراضي وصف
الرسوم المتحركة قيمة منطقية حقيقي تطبيق انتقال تلاشي css إلى تلميح الأداة
لغة البرمجة قيمة منطقية خاطئة أدخل html في النافذة المنبثقة. إذا كانت خاطئة ، textفسيتم استخدام طريقة jquery لإدراج محتوى في dom. استخدم النص إذا كنت قلقًا بشأن هجمات XSS.
تحديد مستوى سلسلة | وظيفة 'حقا' كيفية وضع المنبثقة - الجزء العلوي | أسفل | غادر | حقا
محدد سلسلة خاطئة إذا تم توفير محدد ، فسيتم تفويض كائنات تلميح الأدوات إلى الأهداف المحددة
اثار سلسلة 'انقر' كيف يتم تشغيل المنبثقة - انقر فوق | تحوم | التركيز | كتيب
لقب سلسلة | وظيفة " قيمة العنوان الافتراضية إذا كانت سمة `العنوان` غير موجودة
المحتوى سلسلة | وظيفة " قيمة المحتوى الافتراضية إذا كانت السمة "data-content" غير موجودة
تأخير رقم | هدف 0

التأخير في إظهار وإخفاء النافذة المنبثقة (بالمللي ثانية) - لا ينطبق على نوع المشغل اليدوي

إذا تم توفير رقم ، فسيتم تطبيق التأخير على كل من الإخفاء / العرض

هيكل الكائن هو:delay: { show: 500, hide: 100 }

وعاء سلسلة | خاطئة خاطئة

لإلحاق العنصر المنبثق بعنصر معينcontainer: 'body'

انتباه! يمكن بدلاً من ذلك تحديد خيارات العناصر المنبثقة الفردية من خلال استخدام سمات البيانات.

وضع علامة على

لأسباب تتعلق بالأداء ، يتم الاشتراك في كل من Tooltip و Popover data-apis. إذا كنت ترغب في استخدامهما ، فما عليك سوى تحديد خيار محدد.

طُرق

$ (). popover (خيارات)

يقوم بتهيئة العناصر المنبثقة لمجموعة عنصر.

.popover ("show")

يكشف عن العناصر المنبثقة.

  1. $ ( "# عنصر" ). popover ( "show" )

.popover ("إخفاء")

يخفي العناصر المنبثقة.

  1. $ ( "# عنصر" ). popover ( "إخفاء" )

.popover ("تبديل")

يبدل العناصر المنبثقة.

  1. $ ( "# عنصر" ). popover ( "تبديل" )

.popover ("إتلاف")

يخفي العنصر المنبثق ويدمره.

  1. $ ( "# عنصر" ). popover ( "تدمير" )

مثال على التنبيهات

أضف وظيفة الرفض إلى جميع رسائل التنبيه باستخدام هذا البرنامج المساعد.

حبوبا المقدس! من الأفضل أن تتحقق من نفسك ، فأنت لا تبدو جيدًا جدًا.

أوه المفاجئة! لديك خطأ!

غير هذا وذاك وحاول مرة أخرى. Duis mollis، est noncommo luctus، nisi erat porttitor ligula، eget lacinia odio sem nec elit. Cras mattis consectetur Purus الجلوس amet fermentum.

قم بهذا الإجراء أو افعل هذا


إستعمال

تفعيل رفض تنبيه عبر JavaScript:

  1. $ ( ".alert" ). تنبيه ()

وضع علامة على

ما عليك سوى الإضافة data-dismiss="alert"إلى زر الإغلاق لإعطاء وظيفة تنبيه قريبة تلقائيًا.

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

طُرق

$ (). alert ()

يلف جميع التنبيهات بوظائف قريبة. لتحريك تنبيهاتك عند إغلاقها ، تأكد من أنها تحتوي على " .fadeو " .inفئة مطبقة عليها بالفعل.

.alert ("close")

يغلق تنبيهًا.

  1. $ ( ".alert" ). تنبيه ( "قريب" )

الأحداث

تكشف فئة التنبيه في Bootstrap عن بعض الأحداث للتثبيت في وظائف التنبيه.

حدث وصف
أغلق يتم تشغيل هذا الحدث فورًا عند closeاستدعاء أسلوب المثيل.
مغلق يتم تشغيل هذا الحدث عند إغلاق التنبيه (سينتظر اكتمال انتقالات css).
  1. $ ( "# تنبيهي" ). ربط ( "مغلق" ، وظيفة () {
  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" > تبديل فردي </ زر>

خانة اختيار

أضف data-toggle="buttons-checkbox"لتبديل نمط مربع الاختيار في مجموعة btn.

  1. <div class = "btn-group" data-toggle = "keys-checkbox" >
  2. <button type = "button" class = "btn btn-primary" > يسار </ زر>
  3. <button type = "button" class = "btn btn-primary" > الأوسط </ زر>
  4. <button type = "button" class = "btn btn-primary" > يمين </ زر>
  5. </div>

مذياع

أضف data-toggle="buttons-radio"لتبديل نمط الراديو في مجموعة btn.

  1. <div class = "btn-group" data-toggle = "keys-radio" >
  2. <button type = "button" class = "btn btn-primary" > يسار </ زر>
  3. <button type = "button" class = "btn btn-primary" > الأوسط </ زر>
  4. <button type = "button" class = "btn btn-primary" > يمين </ زر>
  5. </div>

إستعمال

تمكين الأزرار عبر JavaScript:

  1. $ ( ".nav-tabs" ). زر ()

وضع علامة على

تعد سمات البيانات جزءًا لا يتجزأ من المكون الإضافي للزر. تحقق من رمز المثال أدناه للتعرف على أنواع الترميز المختلفة.

خيارات

لا أحد

طُرق

$ (). زر ("تبديل")

يبدل حالة الدفع. يعطي الزر المظهر الذي تم تنشيطه.

انتباه! يمكنك تمكين التبديل التلقائي لزر باستخدام data-toggleالسمة.
  1. <button type = "button" class = "btn" data-toggle = "button" > </button>

زر $ (). ("تحميل")

يضبط حالة الزر على التحميل - يعطل الزر ويتبادل النص لتحميل النص. يجب تحديد نص التحميل على عنصر الزر باستخدام سمة البيانات data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "تحميل الأشياء ..." > ... </button>
انتباه! يستمر Firefox في حالة التعطيل عبر عمليات تحميل الصفحة . الحل لهذا هو استخدام autocomplete="off".

$ (). زر ("إعادة تعيين")

إعادة تعيين حالة الزر - تبديل النص بالنص الأصلي.

$ (). زر (سلسلة نصية)

إعادة تعيين حالة الزر - لمبادلة النص بأي حالة نصية محددة بالبيانات.

  1. <button type = "button" class = "btn" data-complete-text = "finish!" > ... </button>
  2. <script>
  3. $ ( ".btn" ). زر ( "مكتمل" )
  4. </script>

حول

احصل على أنماط أساسية ودعم مرن للمكونات القابلة للطي مثل الأكورديون والتنقل.

* يتطلب تضمين البرنامج المساعد Transitions.

مثال الأكورديون

باستخدام ملحق الطي ، قمنا ببناء أداة نمط أكورديون بسيطة:

Anim pariatur cliche reprehenderit، enim eiusmod high life accusamus terry richardson ad squid. 3 وولف مون أوفيسيا أوت ، لوح تزلج غير كيوبيداتات ، برنش دولور. شاحنة طعام الكينوا لا تحتاج إلى عمل. برانش 3 وولف مون مؤقت ، سونت أليكوا وضع طائرًا عليها حبار قهوة أحادية المنشأ خالية من افتراضات شورديتش إت. Nihil anim keffiyeh helvetica، craft beer labore يتناسب مع أندرسون كريدي. إعلان نباتي مستثنى نائب جزار لومو. Leggings occaecat Craft من مزرعة البيرة إلى المائدة ، وخامات الدنيم الخام الجمالية التي ربما لم تسمع بها من قبل لاتهامها بـ VHS المستدام.
Anim pariatur cliche reprehenderit، enim eiusmod high life accusamus terry richardson ad squid. 3 وولف مون أوفيسيا أوت ، لوح تزلج غير كيوبيداتات ، برنش دولور. شاحنة طعام الكينوا لا تحتاج إلى عمل. برانش 3 وولف مون مؤقت ، سونت أليكوا وضع طائرًا عليها حبار قهوة أحادية المنشأ خالية من افتراضات شورديتش إت. Nihil anim keffiyeh helvetica، craft beer labore يتناسب مع أندرسون كريدي. إعلان نباتي مستثنى نائب جزار لومو. Leggings occaecat Craft من مزرعة البيرة إلى المائدة ، وخامات الدنيم الخام الجمالية التي ربما لم تسمع بها من قبل لاتهامها بـ VHS المستدام.
Anim pariatur cliche reprehenderit، enim eiusmod high life accusamus terry richardson ad squid. 3 وولف مون أوفيسيا أوت ، لوح تزلج غير كيوبيداتات ، برنش دولور. شاحنة طعام الكينوا لا تحتاج إلى عمل. برانش 3 وولف مون مؤقت ، سونت أليكوا وضع طائرًا عليها حبار قهوة أحادية المنشأ خالية من افتراضات شورديتش إت. Nihil anim keffiyeh helvetica، craft beer labore يتناسب مع أندرسون كريدي. إعلان نباتي مستثنى نائب جزار لومو. Leggings occaecat Craft من مزرعة البيرة إلى المائدة ، وخامات الدنيم الخام الجمالية التي ربما لم تسمع بها من قبل لاتهامها بـ VHS المستدام.
  1. <div class = "أكورديون" id = "أكورديون 2" >
  2. <div class = "accordion-group" >
  3. <div class = "أكورديون-رأس" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne"> _
  5. عنصر المجموعة القابل للطي # 1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "accordion-body collapse in" >
  9. <div class = "أكورديون-داخلي" >
  10. الرسوم المتحركة المبتذلة ...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "accordion-group" >
  15. <div class = "أكورديون-رأس" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo"> _
  17. عنصر المجموعة القابل للطي # 2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "accordion-body collapse" >
  21. <div class = "أكورديون-داخلي" >
  22. الرسوم المتحركة المبتذلة ...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

يمكنك أيضًا استخدام المكون الإضافي بدون ترميز الأكورديون. قم بعمل زر للتبديل بين توسيع وانهيار عنصر آخر.

  1. <button type = "button" class = "btn btn-خطر" data-toggle = "collapse" data-target = "#demo" >
  2. بسيطة قابلة للطي
  3. </button>
  4.  
  5. <div id = "demo" class = "collapse in" > </div>

إستعمال

عبر سمات البيانات

ما عليك سوى إضافة data-toggle="collapse"عنصر data-targetإلى عنصر لتعيين التحكم تلقائيًا في عنصر قابل للطي. تقبل السمة data-targetمحدد css لتطبيق الطي عليه. تأكد من إضافة الفصل collapseإلى العنصر القابل للطي. إذا كنت ترغب في فتحه افتراضيًا ، فأضف فئة إضافية in.

لإضافة إدارة مجموعة تشبه الأكورديون إلى عنصر تحكم قابل للطي ، أضف سمة البيانات data-parent="#selector". الرجوع إلى العرض التوضيحي لرؤية هذا في العمل.

عبر JavaScript

التمكين يدويًا باستخدام:

  1. $ ( ".collapse" ). انهيار ()

خيارات

يمكن تمرير الخيارات عبر سمات البيانات أو JavaScript. لسمات البيانات ، قم بإلحاق اسم الخيار بـ data-، كما في data-parent="".

اسم يكتب إفتراضي وصف
الأبوين محدد خاطئة إذا كان المحدِّد ، فسيتم إغلاق جميع العناصر القابلة للطي ضمن العنصر الرئيسي المحدد عند عرض هذا العنصر القابل للطي. (على غرار سلوك الأكورديون التقليدي)
تبديل قيمة منطقية حقيقي تبديل العنصر القابل للطي عند الاستدعاء

طُرق

.collapse (خيارات)

ينشط المحتوى الخاص بك كعنصر قابل للطي. يقبل الخيارات الاختيارية object.

  1. $ ( '#myCollapsible' ). انهيار ({
  2. تبديل : خطأ
  3. })

.collapse ("تبديل")

تبديل عنصر قابل للطي إلى معروض أو مخفي.

.collapse ("عرض")

يظهر عنصرًا قابلًا للطي.

.collapse ("إخفاء")

يخفي عنصرًا قابلًا للطي.

الأحداث

تعرض فئة طي Bootstrap بعض الأحداث للتثبيت في وظيفة الانهيار.

حدث وصف
تبين يتم تشغيل هذا الحدث فورًا عند showاستدعاء أسلوب المثيل.
مبين يتم تشغيل هذا الحدث عندما يصبح عنصر التصغير مرئيًا للمستخدم (سينتظر حتى تكتمل انتقالات css).
يخفي يتم تشغيل هذا الحدث فورًا عند hideاستدعاء الأسلوب.
مختفي يتم تشغيل هذا الحدث عند إخفاء عنصر تصغير عن المستخدم (سينتظر حتى تكتمل انتقالات css).
  1. $ ( '#myCollapsible' ). on ( 'hidden' ، function () {
  2. // قم بعمل ما…
  3. })

مثال

مكون إضافي أساسي وسهل الامتداد لإنشاء رؤوس كتابة أنيقة بسرعة مع إدخال أي نص في النموذج.

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

ستحتاج إلى التعيين autocomplete="off"لمنع قوائم المتصفح الافتراضية من الظهور فوق القائمة المنسدلة لنوع Bootstrap.


إستعمال

عبر سمات البيانات

أضف سمات البيانات لتسجيل عنصر بوظيفة الكتابة كما هو موضح في المثال أعلاه.

عبر JavaScript

قم باستدعاء رأس الطباعة يدويًا باستخدام:

  1. $ ( ".typeahead" ). نوع ()

خيارات

يمكن تمرير الخيارات عبر سمات البيانات أو JavaScript. لسمات البيانات ، قم بإلحاق اسم الخيار بـ data-، كما في data-source="".

اسم يكتب إفتراضي وصف
مصدر مجموعة وظيفة [] مصدر البيانات المراد الاستعلام عنه. قد يكون مصفوفة من السلاسل النصية أو دالة. تمرر الدالة وسيطتين ، queryالقيمة في حقل الإدخال processوالرد. يمكن استخدام الوظيفة بشكل متزامن عن طريق إرجاع مصدر البيانات مباشرة أو بشكل غير متزامن عبر processوسيطة رد الاتصال الفردية.
العناصر رقم 8 الحد الأقصى لعدد العناصر المراد عرضها في القائمة المنسدلة.
طول دقيقة رقم 1 الحد الأدنى لطول الأحرف المطلوب قبل تشغيل اقتراحات الإكمال التلقائي
المطابق وظيفة حالة الأحرف الطريقة المستخدمة لتحديد ما إذا كان الاستعلام يطابق أحد العناصر. يقبل وسيطة واحدة ، على itemأساسها يتم اختبار الاستعلام. قم بالوصول إلى الاستعلام الحالي باستخدام this.query. إرجاع قيمة منطقية trueإذا كان الاستعلام مطابقًا.
فارز وظيفة تطابق تام ،
حساس لحالة الأحرف ،
غير حساس لحالة الأحرف
الطريقة المستخدمة لفرز نتائج الإكمال التلقائي. يقبل وسيطة واحدة itemsوله نطاق مثيل الكتابة. الرجوع إلى الاستعلام الحالي مع this.query.
محدث وظيفة إرجاع العنصر المحدد الطريقة المستخدمة لإرجاع العنصر المحدد. يقبل وسيطة واحدة ، itemوله نطاق مثيل typeahead.
قلم تمييز وظيفة يبرز جميع التطابقات الافتراضية الطريقة المستخدمة لتسليط الضوء على نتائج الإكمال التلقائي. يقبل وسيطة واحدة itemوله نطاق مثيل الكتابة. يجب أن تعود لغة تأشير النص الفائق.

طُرق

.typeahead (خيارات)

يقوم بتهيئة إدخال باستخدام رأس الطباعة.

مثال

يعد التنقل الفرعي الموجود على اليسار عرضًا توضيحيًا مباشرًا للملحق الإضافي.


إستعمال

عبر سمات البيانات

لإضافة سلوك لصق لأي عنصر بسهولة ، ما عليك سوى إضافة 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 }. استخدم وظيفة عندما تحتاج إلى توفير تعويض ديناميكي (مفيد لبعض التصميمات سريعة الاستجابة).