Sourceපතනයන්
බූට්ස්ට්රැප් පතන ප්ලගිනය සමඟ සබැඳි සහ තවත් බොහෝ දේ ප්රදර්ශනය කිරීම සඳහා සන්දර්භීය ආවරණ ටොගල් කරන්න.
දළ විශ්ලේෂණය
පතනයන් යනු ටොගල් කළ හැකි, සබැඳි ලැයිස්තු සහ තවත් දේ සංදර්ශන කිරීම සඳහා සන්දර්භීය උඩැතිරි වේ. ඒවා ඇතුලත් කර ඇති Bootstrap dropdown JavaScript ප්ලගිනය සමඟ අන්තර්ක්රියාකාරී කර ඇත. ඒවා ටොගල් කරන්නේ ක්ලික් කිරීමෙන් මිස සැරිසැරීමෙන් නොවේ; මෙය හිතාමතා සැලසුම් කිරීමේ තීරණයකි .
ඩ්රොප් ඩවුන් ගොඩනගා ඇත්තේ ගතික ස්ථානගත කිරීම සහ දර්ශන තොට හඳුනාගැනීම සපයන තෙවන පාර්ශවීය පුස්තකාලයක් වන Popper.js මත ය. Bootstrap හි JavaScript වලට පෙර popper.min.js ඇතුළත් කිරීමට හෝ Popper.js අඩංගු bootstrap.bundle.min.js
/ භාවිතා කිරීමට වග බලා ගන්න . bootstrap.bundle.js
ගතික ස්ථානගත කිරීම අවශ්ය නොවන බැවින්, navbar වල පතන ස්ථානගත කිරීමට Popper.js භාවිතා නොවේ.
ඔබ අපගේ ජාවාස්ක්රිප්ට් නිර්මාණය කරන්නේ මූලාශ්රයෙන් නම්, එයට අවශ්ය වේutil.js
.
ප්රවේශ
WAI ARIA ප්රමිතිය සත්ය role="menu"
විජට් එකක් නිර්වචනය කරයි , නමුත් මෙය ක්රියා හෝ ක්රියාකාරකම් අවුලුවන යෙදුම් වැනි මෙනු සඳහා විශේෂිත වේ . ARIA මෙනු වල අඩංගු විය හැක්කේ මෙනු අයිතම, පිරික්සුම් පෙට්ටි මෙනු අයිතම, රේඩියෝ බොත්තම් මෙනු අයිතම, රේඩියෝ බොත්තම් කණ්ඩායම් සහ උප මෙනු පමණි.
අනෙක් අතට, Bootstrap හි පහත වැටීම් සාමාන්ය සහ විවිධ අවස්ථා සහ සලකුණු ව්යුහයන්ට අදාළ වන පරිදි නිර්මාණය කර ඇත. උදාහරණයක් ලෙස, සෙවුම් ක්ෂේත්ර හෝ පිවිසුම් පෝරම වැනි අමතර යෙදවුම් සහ පෝරම පාලන අඩංගු dropdowns සෑදිය හැක. මෙම හේතුව නිසා, Bootstrap සත්ය ARIA මෙනු සඳහා අවශ්ය role
සහ aria-
ගුණාංග කිසිවක් අපේක්ෂා නොකරයි (හෝ ස්වයංක්රීයව එකතු නොකරයි) . කතුවරුන්ට මෙම වඩාත් නිශ්චිත ගුණාංග ඇතුළත් කිරීමට සිදුවනු ඇත.
කෙසේ වෙතත්, Bootstrap බොහෝ සම්මත යතුරුපුවරු මෙනු අන්තර්ක්රියා සඳහා බිල්ට් සහය එක් කරයි, .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
a වෙත එක් කරන්න ..dropdown-menu
දැනුම්දීම! පතන ස්ථාන Popper.js වලට ස්තුති වන්නට (ඒවා navbar එකක අඩංගු වන විට හැර).
ප්රතිචාරාත්මක පෙළගැස්ම
ඔබට ප්රතිචාරාත්මක පෙළගැස්ම භාවිතා කිරීමට අවශ්ය නම්, 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 navbars හි භාවිත නොකරන බැවින්, navbars හි පතන බොත්තම් වෙත ඔබට උපලක්ෂණයක් එක් කිරීමට අවශ්ය නොවන බව සලකන්න.
ඕනෑම පතන මෙනුවක ක්රියා කොටස් ලේබල් කිරීමට ශීර්ෂයක් එක් කරන්න.
බෙදුම්කරුවන්
බෙදුම්කරුවෙකු සමඟ අදාළ මෙනු අයිතමවල කණ්ඩායම් වෙන් කරන්න.
පෙළ
පෙළ සහිත පතන මෙනුවක් තුළ ඕනෑම නිදහස් ආකෘති පෙළක් තබා පරතරය උපයෝගිතා භාවිතා කරන්න . මෙනු පළල සීමා කිරීමට ඔබට අමතර ප්රමාණ විලාසයන් අවශ්ය වනු ඇති බව සලකන්න.
පතන මෙනුවක් තුළ පෝරමයක් දමන්න, නැතහොත් එය පතන මෙනුවක් බවට පත් කරන්න, ඔබට අවශ්ය සෘණ ඉඩ ලබා දීමට ආන්තික හෝ පිරවුම් උපයෝගිතා භාවිතා කරන්න.
පතන විකල්ප
පතන ස්ථානය වෙනස් කිරීමට data-offset
හෝ භාවිතා කරන්න .data-reference
භාවිතය
දත්ත ගුණාංග හෝ ජාවාස්ක්රිප්ට් හරහා, පතන ප්ලගිනය .show
මාපිය ලැයිස්තු අයිතමයේ පන්තිය ටොගල් කිරීමෙන් සැඟවුණු අන්තර්ගතය (ඩ්රොප් ඩවුන් මෙනු) ටොගල් කරයි. යෙදුම් මට්ටමකින් පතන මෙනු වැසීම සඳහා data-toggle="dropdown"
ගුණාංගය රඳා පවතී, එබැවින් එය සැමවිටම භාවිතා කිරීම හොඳ අදහසකි.
ස්පර්ශ-සක්රීය උපාංගවල, පතන විවෘත කිරීම මඟින් මූලද්රව්යයේ ක්ෂණික දරුවන්ට හිස් ( $.noop
) හසුරුවන්නා එක් කරයි. මෙම පිළිගත හැකි අවලස්සන හැක් කිරීම iOS' සිදුවීම් නියෝජිතායතනයේ ඇති විකාරයක් වටා ක්රියා කිරීමට අවශ්ය වන අතර, එසේ නොමැතිනම් පහත වැටීමෙන් පිටත ඕනෑම තැනක තට්ටු කිරීමකින් පතන වැසීමේ කේතය ක්රියාරම්භ කිරීමෙන් වලක්වනු ඇත. පහත වැටීම වැසූ පසු, මෙම අතිරේක හිස් හසුරුවන්න ඉවත් කරනු ලැබේ.mouseover
<body>
mouseover
දත්ත ගුණාංග හරහා
data-toggle="dropdown"
පතන ටොගල් කිරීමට සබැඳියකට හෝ බොත්තමකට එක් කරන්න .
JavaScript හරහා
JavaScript හරහා පතනයන් අමතන්න:
data-toggle="dropdown"
තවමත් අවශ්යයි
ඔබ ජාවාස්ක්රිප්ට් හරහා ඔබගේ පතන අමතා හෝ ඒ වෙනුවට ඩේටා-ඒපී භාවිතා කරන්නේද යන්න නොසලකා, data-toggle="dropdown"
පතන ප්රේරක මූලද්රව්යයේ සැමවිටම සිටීම අවශ්ය වේ.
විකල්ප
දත්ත ගුණාංග හෝ JavaScript හරහා විකල්ප ලබා දිය හැක. දත්ත උපලක්ෂණ සඳහා, විකල්ප නාමය data-
, ලෙසට එකතු කරන්න data-offset=""
.
නම |
ටයිප් කරන්න |
පෙරනිමිය |
විස්තර |
ඕෆ්සෙට් |
අංකය | තන්තුව | කාර්යය |
0 |
එහි ඉලක්කයට සාපේක්ෂව පහත වැටීමේ ඕෆ්සෙට්. ඕෆ්සෙට් තීරණය කිරීම සඳහා ශ්රිතයක් භාවිතා කරන විට, එය එහි පළමු තර්කය ලෙස ඕෆ්සෙට් දත්ත අඩංගු වස්තුවක් ලෙස හැඳින්වේ. ශ්රිතය එකම ව්යුහයක් සහිත වස්තුවක් ආපසු ලබා දිය යුතුය. ප්රේරක මූලද්රව්ය DOM නෝඩය දෙවන තර්කය ලෙස සම්මත වේ. වැඩි විස්තර සඳහා Popper.js හි ඕෆ්සෙට් ලේඛන වෙත යොමු වන්න . |
පෙරළන්න |
බූලියන් |
සැබෑ |
යොමු මූලද්රව්ය මත අතිච්ඡාදනය වීමකදී Dropdown පෙරලීමට ඉඩ දෙන්න. වැඩි විස්තර සඳහා Popper.js හි flip docs වෙත යොමු වන්න . |
මායිම |
තන්තුව | මූලද්රව්යය |
'scrollParent' |
පතන මෙනුවේ පිටාර ගැලීමේ සීමාව. 'viewport' , 'window' , 'scrollParent' , හෝ HTMLElement යොමු (JavaScript පමණි) අගයන් පිළිගනී. වැඩි විස්තර සඳහා Popper.js's preventOverflow docs වෙත යොමු වන්න . |
යොමු කිරීම |
තන්තුව | මූලද්රව්යය |
'ටොගල්' |
පතන මෙනුවේ යොමු අංගය. 'toggle' , 'parent' හෝ HTMLElement යොමුවෙහි අගය��් පිළිගනී . වැඩි විස්තර සඳහා Popper.js හි referenceObject docs වෙත යොමු වන්න . |
ප්රදර්ශනය |
නූල් |
'ගතික' |
පෙරනිමියෙන්, අපි ගතික ස්ථානගත කිරීම සඳහා Popper.js භාවිතා කරමු. සමඟ මෙය අක්රිය කරන්න static . |
popperConfig |
ශුන්ය | වස්තුව |
null |
Bootstrap හි පෙරනිමි Popper.js වින්යාසය වෙනස් කිරීමට, Popper.js හි වින්යාසය බලන්න |
boundary
හැර වෙනත් ඕනෑම අගයකට සකසා ඇති විට 'scrollParent'
, විලාසය position: static
බහාලුමට යොදන බව සලකන්න .dropdown
.
ක්රම
ක්රමය |
විස්තර |
$().dropdown('toggle') |
දී ඇති navbar හෝ ටැබ් කළ සංචාලනයක පතන මෙනුව ටොගල් කරයි. |
$().dropdown('show') |
දී ඇති navbar හෝ ටැබ් කළ සංචාලනයක පතන මෙනුව පෙන්වයි. |
$().dropdown('hide') |
ලබා දී ඇති navbar හෝ ටැබ් කළ සංචාලනයක පතන මෙනුව සඟවයි. |
$().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 සංක්රාන්ති, සම්පූර්ණ කිරීමට බලා සිටිනු ඇත). |