قم بتبديل التراكبات السياقية لعرض قوائم الروابط والمزيد باستخدام البرنامج الإضافي المنسدل Bootstrap.
ملخص
القوائم المنسدلة هي تراكبات سياقية قابلة للتبديل لعرض قوائم الروابط والمزيد. لقد تم جعلها تفاعلية مع البرنامج المساعد JavaScript لقائمة Bootstrap المنسدلة. يتم تبديلهم عن طريق النقر وليس بالمرور ؛ هذا قرار تصميم مقصود .
القوائم المنسدلة مبنية على مكتبة طرف ثالث ، Popper.js ، والتي توفر تحديد المواقع الديناميكي واكتشاف منفذ العرض. تأكد من تضمين popper.min.js قبل JavaScript في Bootstrap أو استخدم bootstrap.bundle.min.js/ bootstrap.bundle.jsالذي يحتوي على Popper.js. لا يتم استخدام Popper.js لوضع القوائم المنسدلة في أشرطة التنقل على الرغم من أن تحديد المواقع الديناميكي غير مطلوب.
إذا كنت تقوم ببناء JavaScript من المصدر ، فهذا يتطلبutil.js .
إمكانية الوصول
يحدد معيار WAI ARIArole="menu" عنصر واجهة مستخدم فعليًا ، ولكن هذا خاص بالقوائم الشبيهة بالتطبيقات التي تؤدي إلى تشغيل الإجراءات أو الوظائف. يمكن أن تحتوي قوائم ARIA فقط على عناصر القائمة وعناصر قائمة مربعات الاختيار وعناصر قائمة أزرار الاختيار ومجموعات أزرار الاختيار والقوائم الفرعية.
من ناحية أخرى ، تم تصميم القوائم المنسدلة لـ Bootstrap لتكون عامة وقابلة للتطبيق على مجموعة متنوعة من المواقف وهياكل العلامات. على سبيل المثال ، من الممكن إنشاء قوائم منسدلة تحتوي على مدخلات إضافية وعناصر تحكم في النموذج ، مثل حقول البحث أو نماذج تسجيل الدخول. لهذا السبب ، لا يتوقع Bootstrap (ولا يضيف تلقائيًا) أيًا من السمات والسمات roleالمطلوبة لقوائم ARIAaria- الحقيقية . سيتعين على المؤلفين تضمين هذه السمات الأكثر تحديدًا بأنفسهم.
ومع ذلك ، يضيف Bootstrap دعمًا مضمنًا لمعظم تفاعلات قائمة لوحة المفاتيح القياسية ، مثل القدرة على التنقل عبر .dropdown-itemالعناصر الفردية باستخدام مفاتيح المؤشر وإغلاق القائمة باستخدام ESCالمفتاح.
أمثلة
قم بلف مفتاح تبديل القائمة المنسدلة (الزر أو الارتباط الخاص بك) والقائمة المنسدلة بداخله .dropdown، أو بداخله أي عنصر آخر يتم الإعلان عنه position: relative;. يمكن تشغيل القوائم المنسدلة <a>أو <button>العناصر لتناسب احتياجاتك المحتملة بشكل أفضل.
زر واحد
.btnيمكن تحويل أي منفردة إلى قائمة منسدلة للتبديل مع بعض التغييرات في الترميز. إليك كيف يمكنك وضعها للعمل مع أي من <button>العناصر:
وبالمثل ، قم بإنشاء قوائم منسدلة لأزرار الانقسام بنفس الترميز تقريبًا مثل القوائم المنسدلة ذات الزر الفردي ، ولكن مع إضافة .dropdown-toggle-splitالتباعد المناسب حول علامة الإقحام المنسدلة.
نستخدم هذه الفئة الإضافية لتقليل الأفقي paddingعلى جانبي علامة الإقحام بنسبة 25٪ وإزالة margin-leftما تمت إضافته من أجل القوائم المنسدلة للأزرار العادية. هذه التغييرات الإضافية تحافظ على مركز علامة الإقحام في زر الانقسام وتوفر مساحة ضغط أكثر ملاءمة بجوار الزر الرئيسي.
تاريخيًا ، يجب أن تكون محتويات القائمة المنسدلة عبارة عن روابط ، ولكن لم يعد هذا هو الحال مع الإصدار 4. الآن يمكنك اختياريا استخدام <button>العناصر في القوائم المنسدلة بدلاً من <a>s فقط.
يمكنك أيضًا إنشاء عناصر قائمة منسدلة غير تفاعلية باستخدام .dropdown-item-text. لا تتردد في التصميم بشكل أكبر باستخدام CSS المخصص أو الأدوات المساعدة النصية.
بشكل افتراضي ، يتم وضع القائمة المنسدلة تلقائيًا بنسبة 100٪ من أعلى وعلى طول الجانب الأيسر من القائمة الرئيسية. أضف .dropdown-menu-rightإلى .dropdown-menuاليمين محاذاة القائمة المنسدلة.
انتباه! يتم وضع القوائم المنسدلة بفضل Popper.js (إلا عندما تكون موجودة في شريط التنقل).
محاذاة مستجيبة
إذا كنت تريد استخدام محاذاة سريعة الاستجابة ، فقم بتعطيل تحديد المواقع الديناميكي عن طريق إضافة data-display="static"السمة واستخدام فئات التباينات سريعة الاستجابة.
لمحاذاة القائمة المنسدلة بشكل صحيح.dropdown-menu{-sm|-md|-lg|-xl}-right مع نقطة التوقف المحددة أو الأكبر ، أضف .
لمحاذاة القائمة المنسدلة اليسرى.dropdown-menu-right مع نقطة التوقف المحددة أو أكبر ، قم بإضافة و .dropdown-menu{-sm|-md|-lg|-xl}-left.
لاحظ أنك لست بحاجة إلى إضافة data-display="static"سمة إلى أزرار القائمة المنسدلة في أشرطة التنقل ، حيث لا يتم استخدام Popper.js في أشرطة التنقل.
محتوى القائمة
الرؤوس
أضف رأسًا لتسمية أقسام الإجراءات في أي قائمة منسدلة.
عبر سمات البيانات أو JavaScript ، يقوم المكون الإضافي المنسدل بتبديل المحتوى المخفي (القوائم المنسدلة) عن طريق تبديل .showالفصل في عنصر القائمة الرئيسي. يتم data-toggle="dropdown"الاعتماد على السمة لإغلاق القوائم المنسدلة على مستوى التطبيق ، لذلك من الجيد استخدامها دائمًا.
في الأجهزة التي تعمل باللمس ، يؤدي فتح قائمة منسدلة إلى إضافة معالجات ( $.noop) فارغة mouseoverإلى العناصر الفرعية المباشرة <body>للعنصر. يعد هذا الاختراق القبيح أمرًا ضروريًا للتغلب على مشكلة في تفويض حدث iOS ، والتي من شأنها أن تمنع النقر في أي مكان خارج القائمة المنسدلة من تشغيل الكود الذي يغلق القائمة المنسدلة. بمجرد إغلاق القائمة المنسدلة ، mouseoverتتم إزالة هذه المعالجات الفارغة الإضافية.
عبر سمات البيانات
أضف data-toggle="dropdown"إلى ارتباط أو زر لتبديل القائمة المنسدلة.
عبر JavaScript
استدعاء القوائم المنسدلة عبر JavaScript:
data-toggle="dropdown"لا يزال مطلوبًا
بغض النظر عما إذا كنت تتصل بالقائمة المنسدلة عبر JavaScript أو تستخدم واجهة برمجة التطبيقات data بدلاً من ذلك ، data-toggle="dropdown"يلزم دائمًا أن تكون موجودًا في عنصر تشغيل القائمة المنسدلة.
خيارات
يمكن تمرير الخيارات عبر سمات البيانات أو JavaScript. لسمات البيانات ، قم بإلحاق اسم الخيار بـ data-، كما في data-offset="".
اسم
يكتب
تقصير
وصف
عوض
رقم | سلسلة | وظيفة
0
إزاحة القائمة المنسدلة بالنسبة إلى هدفها.
عند استخدام دالة لتحديد الإزاحة ، يتم استدعاؤها بكائن يحتوي على بيانات الإزاحة كوسيطة أولى لها. يجب أن تقوم الوظيفة بإرجاع كائن بنفس البنية. يتم تمرير عقدة DOM المشغلة كوسيطة ثانية.
اسمح لقلب القائمة المنسدلة في حالة تداخل العنصر المرجعي. لمزيد من المعلومات راجع مستندات flip الخاصة بـ Popper.js .
الحدود
سلسلة | عنصر
"scrollParent"
تجاوز حدود القيد من القائمة المنسدلة. يقبل قيم 'viewport'، 'window'أو 'scrollParent'، أو مرجع HTMLElement (JavaScript فقط). لمزيد من المعلومات ، راجع مستندات منع Popper.js 's PreventionOverflow .
المرجعي
سلسلة | عنصر
"تبديل"
عنصر مرجعي من القائمة المنسدلة. يقبل قيم 'toggle'، 'parent'أو مرجع HTMLElement. لمزيد من المعلومات ، راجع مستندات Popper.js referenceObject .
عرض
سلسلة
'متحرك'
بشكل افتراضي ، نستخدم Popper.js لتحديد المواقع الديناميكي. تعطيل هذا باستخدام static.
popperConfig
فارغ | هدف
لا شيء
لتغيير تكوين Popper.js الافتراضي الخاص بـ Bootstrap ، راجع تكوين Popper.js
لاحظ boundaryأنه عند التعيين على أي قيمة بخلاف ، يتم تطبيق 'scrollParent'النمط على الحاوية.position: static.dropdown
طُرق
طريقة
وصف
$().dropdown('toggle')
لتبديل القائمة المنسدلة لشريط تنقل محدد أو التنقل المبوب.
$().dropdown('show')
يعرض القائمة المنسدلة لشريط التنقل المحدد أو التنقل المبوب.
$().dropdown('hide')
يخفي القائمة المنسدلة لشريط تنقل معين أو تنقل مبوب.
$().dropdown('update')
يحدّث موضع القائمة المنسدلة للعنصر.
$().dropdown('dispose')
يدمر القائمة المنسدلة لعنصر.
الأحداث
يتم تشغيل جميع أحداث القائمة المنسدلة على .dropdown-menuالعنصر الرئيسي للعنصر ولها relatedTargetخاصية قيمتها عنصر الربط. hide.bs.dropdownوالأحداث hidden.bs.dropdownلها clickEventخاصية (فقط عندما يكون نوع الحدث الأصلي click) تحتوي على كائن حدث لحدث النقر.
حدث
وصف
show.bs.dropdown
يتم تشغيل هذا الحدث فورًا عند استدعاء طريقة إظهار المثيل.
shown.bs.dropdown
يتم تشغيل هذا الحدث عندما تصبح القائمة المنسدلة مرئية للمستخدم (سينتظر حتى تكتمل انتقالات CSS).
hide.bs.dropdown
يتم تشغيل هذا الحدث فورًا عند استدعاء طريقة إخفاء المثيل.
hidden.bs.dropdown
يتم تشغيل هذا الحدث عندما تنتهي القائمة المنسدلة من إخفاء المستخدم (سينتظر حتى تكتمل انتقالات CSS).