Sourceښکته کول
د بوټسټریپ ډراپ ډاون پلگ ان سره د لینکونو لیستونو او نور ډیر څه ښودلو لپاره متناسب پوښښ بدل کړئ.
کتنه
ډراپ ډاونونه د بدلون وړ دي ، د لینکونو لیستونو ښودلو لپاره متناسب پوښښ او نور ډیر څه. دوی د شامل شوي بوټسټریپ ډراپ ډاون جاواسکریپټ پلگ ان سره متقابل شوي دي. دوی په کلیک کولو سره بدلیږي، نه د هوور کولو له لارې؛ دا یو قصدي ډیزاین پریکړه ده.
ډراپ ډاونونه د دریمې ډلې په کتابتون کې جوړ شوي، Popper.js ، کوم چې متحرک موقعیت او د لید پورټ کشف چمتو کوي. ډاډ ترلاسه کړئ چې د بوټسټریپ جاوا سکریپټ دمخه popper.min.jsbootstrap.bundle.min.js
شامل کړئ یا / bootstrap.bundle.js
کوم چې Popper.js لري. Popper.js په نیوبارونو کې د ډراپ ډاونونو موقعیت لپاره نه کارول کیږي پداسې حال کې چې متحرک موقعیت ته اړتیا نلري.
که تاسو زموږ جاوا سکریپټ د سرچینې څخه جوړ کړئ، دا اړتیا لريutil.js
.
لاسرسی
د WAI ARIA معیار یو ریښتینی role="menu"
ویجټ تعریفوي ، مګر دا د غوښتنلیک په څیر مینو ته ځانګړی دی کوم چې کړنې یا افعال محرک کوي. د ARIA مینو کې یوازې د مینو توکي، د چک بکس مینو توکي، د راډیو تڼۍ مینو توکي، د راډیو بټن ګروپونه، او فرعي مینو شامل دي.
له بلې خوا د بوټسټریپ ډراپ ډاونونه د دې لپاره ډیزاین شوي چې عمومي وي او په مختلف حالتونو او مارک اپ جوړښتونو کې پلي کیږي. د مثال په توګه، دا ممکنه ده چې ډراپ ډاونونه رامینځته کړئ چې اضافي داخلې او فارم کنټرولونه ولري، لکه د لټون ساحې یا د ننوتلو فورمې. د دې دلیل لپاره، بوټسټریپ د ریښتیني ARIA مینو لپاره د اړتیا role
وړ ځانګړتیاو څخه (نه په اتوماتيک ډول اضافه کول) تمه نه کوي . لیکوالان باید دا نور ځانګړي ځانګړتیاوې پخپله پکې شامل کړي.aria-
په هرصورت، بوټسټریپ د ډیری معیاري کیبورډ مینو تعاملاتو لپاره جوړ شوی ملاتړ اضافه کوي ، لکه .dropdown-item
د کرسر کیلي په کارولو سره د انفرادي عناصرو له لارې حرکت کولو وړتیا او مینو د ESCکیلي سره وتړئ.
مثالونه
د ډراپ ډاون ټګل (ستاسو تڼۍ یا لینک) او د ډراپ ډاون مینو دننه وتړئ .dropdown
، یا بل عنصر چې اعلان کوي position: relative;
. ډراپ ډاونونه ستاسو د احتمالي اړتیاو سره د ښه سمون لپاره له عناصرو <a>
یا عناصرو څخه رامینځته کیدی شي.<button>
هر یو .btn
د ځینې مارک اپ بدلونونو سره په ډراپ ډاون ټګل کې بدل کیدی شي. دلته دا دی چې تاسو څنګه کولی شئ دوی د کوم <button>
عناصرو سره کار کولو ته اړ کړئ:
او د <a>
عناصرو سره:
غوره برخه دا ده چې تاسو دا د هر ډول تڼۍ ډول سره هم کولی شئ:
په ورته ډول، د واحد تڼۍ ډراپ ډاونونو په څیر د ورته مارک اپ سره د سپلیټ بټن ډراپ ډاونونه رامینځته کړئ ، مګر .dropdown-toggle-split
د ډراپ ډاون کیریټ شاوخوا د مناسب واټن لپاره اضافه کولو سره.
موږ د دې اضافي ټولګي څخه کار اخلو ترڅو د غالۍ padding
په دواړو اړخونو کې افقی 25٪ کم کړو او margin-left
د منظم تڼۍ ډراپ ډاونونو لپاره اضافه شوي لرې کړئ. دا اضافي بدلونونه د سپلایټ تڼۍ کې کیریټ مرکز ساتي او د اصلي تڼۍ تر څنګ د مناسب اندازې هټ ساحه چمتو کوي.
اندازه کول
د تڼۍ ډراپ ډاونونه د ټولو اندازو بټونو سره کار کوي، په شمول د ډیفالټ او سپلیټ ډراپ ډاون بټونو.
لارښوونې
ډراپ اپ
.dropup
د اصلي عنصر په اضافه کولو سره پورته عناصرو ته د ډراپ ډاون مینو محرک کړئ .
ډراپرایټ
.dropright
د اصلي عنصر په اضافه کولو سره د عناصرو په ښي خوا کې د ډراپ ډاون مینو محرک کړئ .
غورځول
.dropleft
د اصلي عنصر په اضافه کولو سره د عناصرو په ښي خوا کې د ډراپ ډاون مینو محرک کړئ .
په تاریخي ډول د ډراپ ډاون مینو مینځپانګې باید لینکونه وي ، مګر دا نور د v4 سره قضیه نده. اوس تاسو کولی شئ په اختیاري توګه د s <button>
پرځای په خپلو ډراپ ډاونونو کې عناصر وکاروئ .<a>
تاسو کولی شئ د دې سره غیر متقابل ډراپ ډاون توکي هم رامینځته کړئ .dropdown-item-text
. د دودیز CSS یا متن اسانتیاوو سره نور سټایل کولو لپاره وړیا احساس وکړئ.
فعاله
په ډراپ ډاون کې توکي اضافه کړئ .active
ترڅو دوی د فعال په توګه سټایل کړئ .
معلول
په ډراپ ډاون کې توکي اضافه کړئ .disabled
ترڅو دوی د معلول په توګه سټایل کړئ .
په ډیفالټ ډول ، د ډراپ ډاون مینو په اوتومات ډول د پورتنۍ برخې څخه 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"
په navbars کې د ډراپ ډاون بټونو لپاره ځانګړتیا اضافه کړئ، ځکه چې Popper.js په navbars کې نه کارول کیږي.
په هر ډراپ ډاون مینو کې د عملونو برخو لیبل کولو لپاره سرلیک اضافه کړئ.
ویشونکي
د ویشونکي سره د اړوندو مینو توکو جلا ګروپونه.
متن
هر ډول وړیا متن د متن سره د ډراپ ډاون مینو کې ځای په ځای کړئ او د فاصلې اسانتیاوې وکاروئ . په یاد ولرئ چې تاسو احتمال لرئ د مینو عرض محدودولو لپاره اضافي اندازې سټایلونو ته اړتیا ولرئ.
یوه فورمه د ډراپ ډاون مینو کې دننه کړئ، یا یې په ډراپ ډاون مینو کې جوړ کړئ، او د حاشیې یا پیډینګ اسانتیاو څخه کار واخلئ ترڅو دا منفي ځای ورکړئ چې تاسو ورته اړتیا لرئ.
د ښکته کولو اختیارونه
data-offset
د ښکته کولو ځای بدلولو یا بدلولو لپاره وکاروئ data-reference
.
کارول
د ډیټا ځانګړتیاو یا جاواسکریپټ له لارې، د ډراپ ډاون پلگ ان .show
د اصلي لیست توکي کې د ټولګي په بدلولو سره پټ مینځپانګې (ډراپ ډاون مینو) ته بدلون ورکوي. خاصیت د data-toggle="dropdown"
غوښتنلیک په کچه د ډراپ ډاون مینو بندولو لپاره تکیه کوي ، نو دا ښه نظر دی چې تل یې وکاروئ.
په ټچ فعال شوي وسیلو کې ، د ډراپ ډاون خلاصول د عنصر سمدستي ماشومانو ته خالي ( $.noop
) هینډلرونه اضافه کوي. دا منل شوی بد هیک اړین دی چې د iOS د پیښې پلاوي کې د نرۍ په شاوخوا کې کار وکړي ، کوم چې په بل ډول به د ډراپ ډاون څخه بهر هرچیرې د نل د کوډ له رامینځته کولو څخه مخنیوی وکړي چې ډراپ ډاون بندوي. یوځل چې ډراپ ډاون وتړل شي ، دا اضافي خالي هینډلرونه لرې کیږي.mouseover
<body>
mouseover
د معلوماتو ځانګړتیاو له لارې
data-toggle="dropdown"
د ډراپ ډاون بدلولو لپاره لینک یا تڼۍ کې اضافه کړئ .
د جاواسکریپټ له لارې
د جاواسکریپټ له لارې ډراپ ډاون ته زنګ ووهئ:
data-toggle="dropdown"
لا هم اړتیا ده
پرته لدې چې تاسو د جاواسکریپټ له لارې خپل ډراپ ډاون ته زنګ ووهئ یا د دې پرځای د ډیټا-Api وکاروئ ، data-toggle="dropdown"
تل اړین دي چې د ډراپ ډاون محرک عنصر کې شتون ولري.
اختیارونه
اختیارونه د ډیټا ځانګړتیاو یا جاواسکریپټ له لارې لیږدول کیدی شي. د ډیټا ځانګړتیاو لپاره، د اختیار نوم سره ضمیمه کړئ data-
، لکه څنګه چې په کې data-offset=""
.
نوم |
ډول |
ډیفالټ |
تفصیل |
بندول |
شمیره | تار | فعالیت |
0 |
د خپل هدف په پرتله د ښکته کیدو آفسیټ. د لا زیاتو معلوماتو لپاره د Popper.js offset docs ته مراجعه وکړئ . |
فلپ |
بولین |
ریښتیا |
ډراپ ډاون ته اجازه ورکړئ چې د حوالې عنصر باندې د ډیروالي په صورت کې فلیپ شي. د نورو معلوماتو لپاره د Popper.js فلیپ اسنادو ته مراجعه وکړئ . |
سرحد |
تار | عنصر |
'سکرول والدین' |
د ډراپ ډاون مینو د اوور فلو محدودیت حد. د 'viewport' , 'window' , 'scrollParent' , یا د HTMLElement حواله (یوازې جاواسکریپټ) ارزښتونه مني. د لا زیاتو معلوماتو لپاره Popper.js's preventOverflow docs ته مراجعه وکړئ . |
حواله |
تار | عنصر |
'ټوګل' |
د ډراپ ډاون مینو حواله عنصر. 'toggle' د , 'parent' , یا د HTMLElement حواله ارزښتونه مني. د نورو معلوماتو لپاره د Popper.js referenceObject docs ته مراجعه وکړئ . |
ښودنه |
تار |
'متحرک' |
د ډیفالټ په واسطه، موږ د متحرک موقعیت لپاره Popper.js کاروو. دا سره غیر فعال کړئ static . |
په یاد ولرئ کله چې 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 لیږد ته انتظار وباسي). |