Bootstrap JS Dropdown
JS المنسدلة (dropdown.js)
القائمة المنسدلة هي قائمة قابلة للتبديل تسمح للمستخدم باختيار قيمة واحدة من قائمة محددة مسبقًا.
للحصول على برنامج تعليمي حول القوائم المنسدلة ، اقرأ البرنامج التعليمي Bootstrap المنسدلة .
فئات البرنامج المساعد المنسدلة
| Class | Description | Example |
|---|---|---|
| .dropdown | Indicates a dropdown menu | |
| .dropdown-menu | Builds the dropdown menu | |
| .dropdown-menu-right | Right-aligns a dropdown menu | |
| .dropdown-header | Adds a header inside the dropdown menu | |
| .dropup | Indicates a dropup menu | |
| .disabled | Disables an item in the dropdown menu | |
| .divider | Separates items inside the dropdown menu with a horizontal line |
عبر data- * السمات
أضف data-toggle="dropdown"إلى رابط أو زر لتبديل القائمة المنسدلة.
مثال
<a href="#" class="dropdown-toggle"
data-toggle="dropdown">Dropdown Example</a>
عبر JavaScript
التمكين يدويًا باستخدام:
مثال
$('.dropdown-toggle').dropdown();
ملاحظة: السمة data-toggle = "dropdown" مطلوبة بغض النظر عما إذا كنت تستدعي طريقة () المنسدلة.
خيارات القائمة المنسدلة
| None |
طرق القائمة المنسدلة
يسرد الجدول التالي جميع طرق القائمة المنسدلة المتاحة.
| Method | Description | Try it |
|---|---|---|
| .dropdown("toggle") | Toggles the dropdown |
الأحداث المنسدلة
يسرد الجدول التالي جميع أحداث القائمة المنسدلة المتاحة.
| Event | Description | Try it |
|---|---|---|
| show.bs.dropdown | Occurs when the dropdown is about to be shown. | |
| shown.bs.dropdown | Occurs when the dropdown is fully shown (after CSS transitions have completed) | |
| hide.bs.dropdown | Occurs when the dropdown is about to be hidden | |
| hidden.bs.dropdown | Occurs when the dropdown is fully hidden (after CSS transitions have completed) |
نصيحة: استخدم event.relatedTarget الخاص بـ jQuery للحصول على العنصر الذي أدى إلى تشغيل القائمة المنسدلة:
مثال
$(".dropdown").on("show.bs.dropdown", function(event){
var x = $(event.relatedTarget).text(); // Get the text of the element
alert(x);
});
مزيد من الأمثلة
تغيير رمز علامة الإقحام رأسًا على عقب
يغير المثال التالي رمز علامة الإقحام من الإشارة إلى الأسفل إلى الأعلى عند النقر على القائمة المنسدلة:
مثال
/* CSS: */
<style>
.caret.caret-up {
border-top-width: 0;
border-bottom: 4px solid #fff;
}
</style>
/* JS: */
<script>
$(document).ready(function(){
$(".dropdown").on("hide.bs.dropdown", function(){
$(".btn").html('Dropdown <span class="caret"></span>');
});
$(".dropdown").on("show.bs.dropdown", function(){
$(".btn").html('Dropdown <span class="caret caret-up"></span>');
});
});
</script>
Navbar مع القائمة المنسدلة
يضيف المثال التالي قائمة منسدلة لزر في شريط التنقل:
مثال
<nav class="navbar navbar-inverse">
<div class="container-fluid">
<div class="navbar-header">
<a class="navbar-brand" href="#">WebSiteName</a>
</div>
<div>
<ul class="nav navbar-nav">
<li class="active"><a href="#">Home</a></li>
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Page 1
<span class="caret"></span></a>
<ul class="dropdown-menu">
<li><a href="#">Page 1-1</a></li>
<li><a href="#">Page 1-2</a></li>
<li><a href="#">Page 1-3</a></li>
</ul>
</li>
<li><a href="#">Page 2</a></li>
<li><a href="#">Page 3</a></li>
</ul>
</div>
</div>
</nav>
يضيف المثال التالي قائمة منسدلة مع نموذج تسجيل الدخول في شريط التنقل:
مثال
<ul class="nav navbar-nav navbar-right">
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Login <span class="glyphicon glyphicon-log-in"></span></a>
<div class="dropdown-menu">
<form id="formlogin" class="form container-fluid">
<div class="form-group">
<label for="usr">Name:</label>
<input type="text" class="form-control" id="usr">
</div>
<div class="form-group">
<label for="pwd">Password:</label>
<input type="password" class="form-control" id="pwd">
</div>
<button type="button" id="btnLogin" class="btn btn-block">Login</button>
</form>
<div class="container-fluid">
<a class="small" href="#">Forgot password?</a>
</div>
</div>
</li>
</ul>
قوائم منسدلة متعددة المستويات
في هذا المثال ، نستخدم jQuery لفتح قوائم منسدلة متعددة المستويات عند النقر:
مثال
<script>
$(document).ready(function(){
$('.dropdown-submenu a.test').on("click", function(e){
$(this).next('ul').toggle();
e.stopPropagation();
e.preventDefault();
});
});
</script>
في هذا المثال ، أنشأنا .dropdown-submenuفئة مخصصة للقوائم المنسدلة متعددة المستويات:
مثال
/* CSS: */
<style>
.dropdown-submenu {
position: relative;
}
.dropdown-submenu .dropdown-menu {
top: 0;
left: 100%;
margin-top: -1px;
}
</style>
/* JS: */
<script>
$(document).ready(function(){
$('.dropdown-submenu a.test').on("click", function(e){
$(this).next('ul').toggle();
e.stopPropagation();
e.preventDefault();
});
});
</script>