דראָפּדאָוונס
טאַגאַל קאָנטעקסטואַל אָוווערלייז פֿאַר ווייַז רשימות פון פֿאַרבינדונגען און מער מיט די באָאָטסטראַפּ דראָפּדאָוון פּלוגין.
איבערבליק
דראָפּדאָוונס זענען טאַגאַלאַבאַל, קאָנטעקסטואַל אָוווערלייז פֿאַר ווייַז רשימות פון לינקס און מער. זיי זענען ינטעראַקטיוו מיט די אַרייַנגערעכנט Bootstrap דראָפּדאָוון דזשאַוואַסקריפּט פּלוגין. זיי זענען טאַגאַלד דורך קליקינג, נישט דורך כאַווערינג; דאָס איז אַ ינטענשאַנאַל פּלאַן באַשלוס .
דראָפּדאָוונס זענען געבויט אויף אַ דריט טיילווייַז ביבליאָטעק, פּאָפּער , וואָס גיט דינאַמיש פּאַזישאַנינג און וויופּאָרט דיטעקשאַן. זייט זיכער צו אַרייַננעמען popper.min.js איידער Bootstrap ס דזשאַוואַסקריפּט אָדער נוצן bootstrap.bundle.min.js
/ bootstrap.bundle.js
וואָס כּולל פּאָפּער. פּאָפּער איז נישט געניצט צו שטעלן דראָפּדאָוונס אין נאַוובאַרס, כאָטש דינאַמיש פּאַזישאַנינג איז נישט פארלאנגט.
אַקסעסאַביליטי
די WAI ARIA נאָרמאַל דיפיינז אַ פאַקטיש role="menu"
ווידזשיט , אָבער דאָס איז ספּעציפיש פֿאַר אַפּלאַקיישאַן-ווי מעניוז וואָס צינגל אַקשאַנז אָדער פאַנגקשאַנז. ARIA מעניוז קענען בלויז אַנטהאַלטן מעניו זאכן, טשעקקבאָקס מעניו זאכן, ראַדיאָ קנעפּל מעניו זאכן, ראַדיאָ קנעפּל גרופּעס און סאַב-מעניוז.
די דראָפּדאָוונס פון Bootstrap, אויף די אנדערע האַנט, זענען דיזיינד צו זיין דזשאַנעריק און אָנווענדלעך צו אַ פאַרשיידנקייַט פון סיטואַטיאָנס און מאַרקאַפּ סטראַקטשערז. פֿאַר בייַשפּיל, עס איז מעגלעך צו שאַפֿן דראָפּדאָוונס וואָס אַנטהאַלטן נאָך ינפּוץ און פאָרעם קאָנטראָלס, אַזאַ ווי זוכן פעלדער אָדער לאָגין פארמען. פֿאַר דעם סיבה, Bootstrap קען נישט דערוואַרטן (און ניט אויטאָמאַטיש לייגן) קיין פון די role
און aria-
אַטריביוץ פארלאנגט פֿאַר אמת ARIA מעניוז. מחברים וועלן האָבן צו אַרייַננעמען די מער ספּעציפיש אַטריביוץ זיך.
אָבער, Bootstrap לייגט אַ געבויט-אין שטיצן פֿאַר רובֿ נאָרמאַל קלאַוויאַטור מעניו ינטעראַקשאַנז, אַזאַ ווי די פיייקייט צו מאַך דורך יחיד .dropdown-item
עלעמענטן ניצן די לויפֿער שליסלען און פאַרמאַכן די מעניו מיט די ESCשליסל.
ביישפילן
ייַנוויקלען די טאַגאַל פון די דראָפּדאָוון (דיין קנעפּל אָדער לינק) און די דראָפּדאָוון מעניו אין .dropdown
, אָדער אן אנדער עלעמענט וואָס דערקלערט position: relative;
. דראָפּדאָוונס קענען זיין טריגערד פֿון <a>
אָדער <button>
עלעמענטן צו בעסער פּאַסיק דיין פּאָטענציעל באדערפענישן. די ביישפילן געוויזן דאָ נוצן סעמאַנטיק <ul>
עלעמענטן ווו צונעמען, אָבער מנהג מאַרקאַפּ איז געשטיצט.
איין קנעפּל
יעדער איינער .btn
קענען זיין פארוואנדלען אין אַ דראָפּדאָוון טאַגאַל מיט עטלעכע מאַרקאַפּ ענדערונגען. דאָ ס ווי איר קענען שטעלן זיי צו אַרבעטן מיט יעדער <button>
עלעמענטן:
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuButton1" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown button
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenuButton1">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
</ul>
</div>
און מיט <a>
עלעמענטן:
<div class="dropdown">
<a class="btn btn-secondary dropdown-toggle" href="#" role="button" id="dropdownMenuLink" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown link
</a>
<ul class="dropdown-menu" aria-labelledby="dropdownMenuLink">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
</ul>
</div>
דער בעסטער טייל איז אַז איר קענען טאָן דאָס מיט קיין וואַריאַנט פון קנעפּלעך:
<!-- Example single danger button -->
<div class="btn-group">
<button type="button" class="btn btn-danger dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Action
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
<li><hr class="dropdown-divider"></li>
<li><a class="dropdown-item" href="#">Separated link</a></li>
</ul>
</div>
שפּאַלטן קנעפּל
סימילאַרלי, שאַפֿן שפּאַלטן קנעפּל דראָפּדאָוונס מיט כמעט דער זעלביקער מאַרקאַפּ ווי איין קנעפּל דראָפּדאָוונס, אָבער מיט די אַדישאַן פון .dropdown-toggle-split
די רעכט ספּייסינג אַרום די דראָפּדאָוון קאַרעט.
מיר נוצן דעם עקסטרע קלאַס צו רעדוצירן די האָריזאָנטאַל padding
אויף יעדער זייַט פון די קאַרעט מיט 25% און באַזייַטיקן די margin-left
וואָס איז צוגעגעבן פֿאַר רעגולער קנעפּל דראָפּדאָוונס. די עקסטרע ענדערונגען האַלטן די קאַרעט סענטערד אין די שפּאַלטן קנעפּל און צושטעלן אַ מער אַפּראָופּרייטלי סייזד שלאָגן געגנט ווייַטער צו די הויפּט קנעפּל.
<!-- Example split danger button -->
<div class="btn-group">
<button type="button" class="btn btn-danger">Action</button>
<button type="button" class="btn btn-danger dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
<span class="visually-hidden">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
<li><hr class="dropdown-divider"></li>
<li><a class="dropdown-item" href="#">Separated link</a></li>
</ul>
</div>
סייזינג
קנעפּל דראָפּדאָוונס אַרבעט מיט קנעפּלעך פון אַלע סיזעס, אַרייַנגערעכנט פעליקייַט און שפּאַלטן דראָפּדאָוון קנעפּלעך.
<!-- Large button groups (default and split) -->
<div class="btn-group">
<button class="btn btn-secondary btn-lg dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
Large button
</button>
<ul class="dropdown-menu">
...
</ul>
</div>
<div class="btn-group">
<button class="btn btn-secondary btn-lg" type="button">
Large split button
</button>
<button type="button" class="btn btn-lg btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
<span class="visually-hidden">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu">
...
</ul>
</div>
<div class="btn-group">
<button class="btn btn-secondary btn-sm dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
Small button
</button>
<ul class="dropdown-menu">
...
</ul>
</div>
<div class="btn-group">
<button class="btn btn-secondary btn-sm" type="button">
Small split button
</button>
<button type="button" class="btn btn-sm btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
<span class="visually-hidden">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu">
...
</ul>
</div>
טונקל דראָפּדאָוונס
אַפּט אין דאַרקער דראָפּדאָוונס צו גלייַכן אַ טונקל נאַוובאַר אָדער מנהג סטיל דורך אַדינג .dropdown-menu-dark
אַ יגזיסטינג .dropdown-menu
. קיין ענדערונגען זענען פארלאנגט צו די דראָפּדאָוון זאכן.
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuButton2" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown button
</button>
<ul class="dropdown-menu dropdown-menu-dark" aria-labelledby="dropdownMenuButton2">
<li><a class="dropdown-item active" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
<li><hr class="dropdown-divider"></li>
<li><a class="dropdown-item" href="#">Separated link</a></li>
</ul>
</div>
און שטעלן עס צו נוצן אין אַ נאַוובאַר:
<nav class="navbar navbar-expand-lg navbar-dark bg-dark">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavDarkDropdown" aria-controls="navbarNavDarkDropdown" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="navbarNavDarkDropdown">
<ul class="navbar-nav">
<li class="nav-item dropdown">
<a class="nav-link dropdown-toggle" href="#" id="navbarDarkDropdownMenuLink" role="button" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown
</a>
<ul class="dropdown-menu dropdown-menu-dark" aria-labelledby="navbarDarkDropdownMenuLink">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
</ul>
</li>
</ul>
</div>
</div>
</nav>
אינסטרוקציעס
RTL
אינסטרוקציעס זענען שפּיגל ווען איר נוצן Bootstrap אין RTL, טייַטש .dropstart
וועט זיין געוויזן אויף די רעכט זייַט.
דראָפּופּ
צינגל דראָפּדאָוון מעניוז אויבן עלעמענטן דורך אַדינג .dropup
צו די פאָטער עלעמענט.
<!-- Default dropup button -->
<div class="btn-group dropup">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Dropup
</button>
<ul class="dropdown-menu">
<!-- Dropdown menu links -->
</ul>
</div>
<!-- Split dropup button -->
<div class="btn-group dropup">
<button type="button" class="btn btn-secondary">
Split dropup
</button>
<button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
<span class="visually-hidden">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu">
<!-- Dropdown menu links -->
</ul>
</div>
דראָפּרייט
צינגל דראָפּדאָוון מעניוז אין די רעכט פון די עלעמענטן דורך אַדינג .dropend
צו די פאָטער עלעמענט.
<!-- Default dropend button -->
<div class="btn-group dropend">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Dropright
</button>
<ul class="dropdown-menu">
<!-- Dropdown menu links -->
</ul>
</div>
<!-- Split dropend button -->
<div class="btn-group dropend">
<button type="button" class="btn btn-secondary">
Split dropend
</button>
<button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
<span class="visually-hidden">Toggle Dropright</span>
</button>
<ul class="dropdown-menu">
<!-- Dropdown menu links -->
</ul>
</div>
דראָפּלעפט
צינגל דראָפּדאָוון מעניוז אין די לינקס פון די עלעמענטן דורך אַדינג .dropstart
צו די פאָטער עלעמענט.
<!-- Default dropstart button -->
<div class="btn-group dropstart">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Dropstart
</button>
<ul class="dropdown-menu">
<!-- Dropdown menu links -->
</ul>
</div>
<!-- Split dropstart button -->
<div class="btn-group">
<div class="btn-group dropstart" role="group">
<button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" data-bs-toggle="dropdown" aria-expanded="false">
<span class="visually-hidden">Toggle Dropstart</span>
</button>
<ul class="dropdown-menu">
<!-- Dropdown menu links -->
</ul>
</div>
<button type="button" class="btn btn-secondary">
Split dropstart
</button>
</div>
מעניו זאכן
איר קענען נוצן <a>
אָדער <button>
עלעמענטן ווי דראָפּדאָוון זאכן.
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenu2" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenu2">
<li><button class="dropdown-item" type="button">Action</button></li>
<li><button class="dropdown-item" type="button">Another action</button></li>
<li><button class="dropdown-item" type="button">Something else here</button></li>
</ul>
</div>
איר קענען אויך שאַפֿן ניט-ינטעראַקטיוו דראָפּדאָוון זאכן מיט .dropdown-item-text
. פילן פריי צו סטיל ווייַטער מיט מנהג CSS אָדער טעקסט יוטילאַטיז.
<ul class="dropdown-menu">
<li><span class="dropdown-item-text">Dropdown item text</span></li>
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
</ul>
אַקטיוו
לייג .active
צו זאכן אין די דראָפּדאָוון צו סטיל זיי ווי אַקטיוו . צו קאַנוויי די אַקטיוו שטאַט צו אַסיסטיוו טעקנאַלאַדזשיז, נוצן די aria-current
אַטריביוט - ניצן די page
ווערט פֿאַר דעם קראַנט בלאַט אָדער true
פֿאַר די קראַנט נומער אין אַ גאַנג.
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Regular link</a></li>
<li><a class="dropdown-item active" href="#" aria-current="true">Active link</a></li>
<li><a class="dropdown-item" href="#">Another link</a></li>
</ul>
פאַרקריפּלט
לייג .disabled
צו זאכן אין די דראָפּדאָוון צו סטיל זיי ווי פאַרקריפּלט .
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Regular link</a></li>
<li><a class="dropdown-item disabled">Disabled link</a></li>
<li><a class="dropdown-item" href="#">Another link</a></li>
</ul>
מעניו אַליינמאַנט
דורך פעליקייַט, אַ דראָפּדאָוון מעניו איז אויטאָמאַטיש פּאַזישאַנד 100% פון די שפּיץ און צוזאמען די לינקס זייַט פון זיין פאָטער. איר קענען טוישן דעם מיט די דירעקטיאָנאַל .drop*
קלאסן, אָבער איר קענען אויך קאָנטראָלירן זיי מיט נאָך מאָדיפיער קלאסן.
לייג .dropdown-menu-end
צו אַ .dropdown-menu
רעכט ייַנרייען די דראָפּדאָוון מעניו. אינסטרוקציעס זענען שפּיגל ווען ניצן Bootstrap אין RTL, טייַטש .dropdown-menu-end
וועט זיין געוויזן אויף די לינקס זייַט.
<div class="btn-group">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Right-aligned menu example
</button>
<ul class="dropdown-menu dropdown-menu-end">
<li><button class="dropdown-item" type="button">Action</button></li>
<li><button class="dropdown-item" type="button">Another action</button></li>
<li><button class="dropdown-item" type="button">Something else here</button></li>
</ul>
</div>
אָפּרופיק אַליינמאַנט
אויב איר ווילן צו נוצן אָפּרופיק אַליינמאַנט, דיסייבאַל דינאַמיש פּאַזישאַנינג דורך אַדינג די data-bs-display="static"
אַטריביוט און נוצן די אָפּרופיק ווערייישאַן קלאסן.
צו ייַנרייען רעכט די דראָפּדאָוון מעניו מיט די געגעבן ברייקפּוינט אָדער גרעסער, לייגן .dropdown-menu{-sm|-md|-lg|-xl|-xxl}-end
.
<div class="btn-group">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" data-bs-display="static" aria-expanded="false">
Left-aligned but right aligned when large screen
</button>
<ul class="dropdown-menu dropdown-menu-lg-end">
<li><button class="dropdown-item" type="button">Action</button></li>
<li><button class="dropdown-item" type="button">Another action</button></li>
<li><button class="dropdown-item" type="button">Something else here</button></li>
</ul>
</div>
צו ייַנרייען לינקס די דראָפּדאָוון מעניו מיט די געגעבן ברייקפּוינט אָדער גרעסער, לייגן .dropdown-menu-end
און .dropdown-menu{-sm|-md|-lg|-xl|-xxl}-start
.
<div class="btn-group">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" data-bs-display="static" aria-expanded="false">
Right-aligned but left aligned when large screen
</button>
<ul class="dropdown-menu dropdown-menu-end dropdown-menu-lg-start">
<li><button class="dropdown-item" type="button">Action</button></li>
<li><button class="dropdown-item" type="button">Another action</button></li>
<li><button class="dropdown-item" type="button">Something else here</button></li>
</ul>
</div>
באַמערקונג אַז איר טאָן ניט דאַרפֿן צו לייגן אַ data-bs-display="static"
אַטריביוט צו דראָפּדאָוון קנעפּלעך אין נאַוובאַרס, ווייַל פּאָפּער איז נישט געניצט אין נאַוובאַרס.
אַליינמאַנט אָפּציעס
גענומען רובֿ פון די אָפּציעס געוויזן אויבן, דאָ איז אַ קליין קיך זינקען דעמאָ פון פאַרשידן דראָפּדאָוון אַליינמאַנט אָפּציעס אין איין אָרט.
<div class="btn-group">
<button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuButton" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenuButton">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Right-aligned menu
</button>
<ul class="dropdown-menu dropdown-menu-end">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" data-bs-display="static" aria-expanded="false">
Left-aligned, right-aligned lg
</button>
<ul class="dropdown-menu dropdown-menu-lg-end">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" data-bs-display="static" aria-expanded="false">
Right-aligned, left-aligned lg
</button>
<ul class="dropdown-menu dropdown-menu-end dropdown-menu-lg-start">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
<div class="btn-group dropstart">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Dropstart
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
<div class="btn-group dropend">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Dropend
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
<div class="btn-group dropup">
<button type="button" class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Dropup
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
מעניו אינהאַלט
העאַדערס
לייג אַ כעדער צו לייבלינג סעקשאַנז פון אַקשאַנז אין קיין דראָפּדאָוון מעניו.
<ul class="dropdown-menu">
<li><h6 class="dropdown-header">Dropdown header</h6></li>
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
</ul>
דיווידערס
באַזונדער גרופּעס פון פֿאַרבונדענע מעניו זאכן מיט אַ דיווידער.
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
<li><hr class="dropdown-divider"></li>
<li><a class="dropdown-item" href="#">Separated link</a></li>
</ul>
טעקסט
שטעלן קיין פריי-פאָרעם טעקסט אין אַ דראָפּדאָוון מעניו מיט טעקסט און נוצן ספּייסינג יוטילאַטיז . באַמערקונג אַז איר וועט מסתּמא דאַרפֿן נאָך סייזינג סטיילז צו באַגרענעצן די מעניו ברייט.
<div class="dropdown-menu p-4 text-muted" style="max-width: 200px;">
<p>
Some example text that's free-flowing within the dropdown menu.
</p>
<p class="mb-0">
And this is more example text.
</p>
</div>
Forms
שטעלן אַ פאָרעם אין אַ דראָפּדאָוון מעניו, אָדער מאַכן עס אין אַ דראָפּדאָוון מעניו, און נוצן גרענעץ אָדער וואַטן יוטילאַטיז צו געבן עס די נעגאַטיוו פּלאַץ איר דאַרפֿן.
<div class="dropdown-menu">
<form class="px-4 py-3">
<div class="mb-3">
<label for="exampleDropdownFormEmail1" class="form-label">Email address</label>
<input type="email" class="form-control" id="exampleDropdownFormEmail1" placeholder="[email protected]">
</div>
<div class="mb-3">
<label for="exampleDropdownFormPassword1" class="form-label">Password</label>
<input type="password" class="form-control" id="exampleDropdownFormPassword1" placeholder="Password">
</div>
<div class="mb-3">
<div class="form-check">
<input type="checkbox" class="form-check-input" id="dropdownCheck">
<label class="form-check-label" for="dropdownCheck">
Remember me
</label>
</div>
</div>
<button type="submit" class="btn btn-primary">Sign in</button>
</form>
<div class="dropdown-divider"></div>
<a class="dropdown-item" href="#">New around here? Sign up</a>
<a class="dropdown-item" href="#">Forgot password?</a>
</div>
<form class="dropdown-menu p-4">
<div class="mb-3">
<label for="exampleDropdownFormEmail2" class="form-label">Email address</label>
<input type="email" class="form-control" id="exampleDropdownFormEmail2" placeholder="[email protected]">
</div>
<div class="mb-3">
<label for="exampleDropdownFormPassword2" class="form-label">Password</label>
<input type="password" class="form-control" id="exampleDropdownFormPassword2" placeholder="Password">
</div>
<div class="mb-3">
<div class="form-check">
<input type="checkbox" class="form-check-input" id="dropdownCheck2">
<label class="form-check-label" for="dropdownCheck2">
Remember me
</label>
</div>
</div>
<button type="submit" class="btn btn-primary">Sign in</button>
</form>
דראָפּדאָוון אָפּציעס
ניצן data-bs-offset
אָדער data-bs-reference
צו טוישן דעם אָרט פון די דראָפּדאָוון.
<div class="d-flex">
<div class="dropdown me-1">
<button type="button" class="btn btn-secondary dropdown-toggle" id="dropdownMenuOffset" data-bs-toggle="dropdown" aria-expanded="false" data-bs-offset="10,20">
Offset
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenuOffset">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-secondary">Reference</button>
<button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" id="dropdownMenuReference" data-bs-toggle="dropdown" aria-expanded="false" data-bs-reference="parent">
<span class="visually-hidden">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenuReference">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
<li><hr class="dropdown-divider"></li>
<li><a class="dropdown-item" href="#">Separated link</a></li>
</ul>
</div>
</div>
אַוטאָ נאָענט נאַטור
דורך פעליקייַט, די דראָפּדאָוון מעניו איז פֿאַרמאַכט ווען קליקינג ין אָדער אַרויס די דראָפּדאָוון מעניו. איר קענען נוצן די autoClose
אָפּציע צו טוישן דעם נאַטור פון די דראָפּדאָוון.
<div class="btn-group">
<button class="btn btn-secondary dropdown-toggle" type="button" id="defaultDropdown" data-bs-toggle="dropdown" data-bs-auto-close="true" aria-expanded="false">
Default dropdown
</button>
<ul class="dropdown-menu" aria-labelledby="defaultDropdown">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
<div class="btn-group">
<button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuClickableOutside" data-bs-toggle="dropdown" data-bs-auto-close="inside" aria-expanded="false">
Clickable outside
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenuClickableOutside">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
<div class="btn-group">
<button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuClickableInside" data-bs-toggle="dropdown" data-bs-auto-close="outside" aria-expanded="false">
Clickable inside
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenuClickableInside">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
<div class="btn-group">
<button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuClickable" data-bs-toggle="dropdown" data-bs-auto-close="false" aria-expanded="false">
Manual close
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenuClickable">
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
<li><a class="dropdown-item" href="#">Menu item</a></li>
</ul>
</div>
סאַס
וועריאַבאַלז
וועריאַבאַלז פֿאַר אַלע דראָפּדאָוונס:
$dropdown-min-width: 10rem;
$dropdown-padding-x: 0;
$dropdown-padding-y: .5rem;
$dropdown-spacer: .125rem;
$dropdown-font-size: $font-size-base;
$dropdown-color: $body-color;
$dropdown-bg: $white;
$dropdown-border-color: rgba($black, .15);
$dropdown-border-radius: $border-radius;
$dropdown-border-width: $border-width;
$dropdown-inner-border-radius: subtract($dropdown-border-radius, $dropdown-border-width);
$dropdown-divider-bg: $dropdown-border-color;
$dropdown-divider-margin-y: $spacer * .5;
$dropdown-box-shadow: $box-shadow;
$dropdown-link-color: $gray-900;
$dropdown-link-hover-color: shade-color($dropdown-link-color, 10%);
$dropdown-link-hover-bg: $gray-200;
$dropdown-link-active-color: $component-active-color;
$dropdown-link-active-bg: $component-active-bg;
$dropdown-link-disabled-color: $gray-500;
$dropdown-item-padding-y: $spacer * .25;
$dropdown-item-padding-x: $spacer;
$dropdown-header-color: $gray-600;
$dropdown-header-padding: $dropdown-padding-y $dropdown-item-padding-x;
וועריאַבאַלז פֿאַר די טונקל דראָפּדאָוון :
$dropdown-dark-color: $gray-300;
$dropdown-dark-bg: $gray-800;
$dropdown-dark-border-color: $dropdown-border-color;
$dropdown-dark-divider-bg: $dropdown-divider-bg;
$dropdown-dark-box-shadow: null;
$dropdown-dark-link-color: $dropdown-dark-color;
$dropdown-dark-link-hover-color: $white;
$dropdown-dark-link-hover-bg: rgba($white, .15);
$dropdown-dark-link-active-color: $dropdown-link-active-color;
$dropdown-dark-link-active-bg: $dropdown-link-active-bg;
$dropdown-dark-link-disabled-color: $gray-500;
$dropdown-dark-header-color: $gray-500;
וועריאַבאַלז פֿאַר די CSS-באזירט קאַרעץ וואָס אָנווייַזן די ינטעראַקטיוואַטי פון אַ דראָפּדאָוון:
$caret-width: .3em;
$caret-vertical-align: $caret-width * .85;
$caret-spacing: $caret-width * .85;
מיקסינס
מיקסינס זענען געניצט צו דזשענערייט די CSS-באזירט קאַרעץ און קענען זיין געפֿונען אין scss/mixins/_caret.scss
.
@mixin caret-down {
border-top: $caret-width solid;
border-right: $caret-width solid transparent;
border-bottom: 0;
border-left: $caret-width solid transparent;
}
@mixin caret-up {
border-top: 0;
border-right: $caret-width solid transparent;
border-bottom: $caret-width solid;
border-left: $caret-width solid transparent;
}
@mixin caret-end {
border-top: $caret-width solid transparent;
border-right: 0;
border-bottom: $caret-width solid transparent;
border-left: $caret-width solid;
}
@mixin caret-start {
border-top: $caret-width solid transparent;
border-right: $caret-width solid;
border-bottom: $caret-width solid transparent;
}
@mixin caret($direction: down) {
@if $enable-caret {
&::after {
display: inline-block;
margin-left: $caret-spacing;
vertical-align: $caret-vertical-align;
content: "";
@if $direction == down {
@include caret-down();
} @else if $direction == up {
@include caret-up();
} @else if $direction == end {
@include caret-end();
}
}
@if $direction == start {
&::after {
display: none;
}
&::before {
display: inline-block;
margin-right: $caret-spacing;
vertical-align: $caret-vertical-align;
content: "";
@include caret-start();
}
}
&:empty::after {
margin-left: 0;
}
}
}
באַניץ
דורך דאַטן אַטריביוץ אָדער דזשאַוואַסקריפּט, די דראָפּדאָוון פּלוגין טאַגאַליז פאַרבאָרגן אינהאַלט (דראָפּדאָוון מעניוז) דורך טאַגאַלינג די .show
קלאַס אויף דער פאָטער .dropdown-menu
. די data-bs-toggle="dropdown"
אַטריביוט איז רילייד אויף פֿאַר קלאָוזינג דראָפּדאָוון מעניוז אויף אַ אַפּלאַקיישאַן מדרגה, אַזוי עס איז אַ גוטע געדאַנק צו שטענדיק נוצן עס.
mouseover
האַנדלערס צו די באַלדיק קינדער פון די
<body>
עלעמענט. דעם אַדמיטאַדלי מיעס כאַק איז נייטיק צו אַרבעטן אַרום אַ
קנאַפּ אין יאָס 'עווענט דעלאַגיישאַן , וואָס אַנדערש וואָלט פאַרמייַדן אַ צאַפּן ערגעץ אַרויס פון די דראָפּדאָוון פון טריגערינג די קאָד וואָס קלאָוזיז די דראָפּדאָוון. אַמאָל די דראָפּדאָוון איז פארמאכט, די נאָך ליידיק
mouseover
האַנדלערס זענען אַוועקגענומען.
דורך דאַטן אַטריביוץ
לייג data-bs-toggle="dropdown"
צו אַ לינק אָדער קנעפּל צו באַשטימען אַ דראָפּדאָוון.
<div class="dropdown">
<button id="dLabel" type="button" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown trigger
</button>
<ul class="dropdown-menu" aria-labelledby="dLabel">
...
</ul>
</div>
דורך דזשאַוואַסקריפּט
רופן די דראָפּדאָוונס דורך דזשאַוואַסקריפּט:
var dropdownElementList = [].slice.call(document.querySelectorAll('.dropdown-toggle'))
var dropdownList = dropdownElementList.map(function (dropdownToggleEl) {
return new bootstrap.Dropdown(dropdownToggleEl)
})
data-bs-toggle="dropdown"
נאָך פארלאנגט
צי איר רופן דיין דראָפּדאָוון דורך דזשאַוואַסקריפּט אָדער אַנשטאָט ניצן די דאַטן-אַפּי, עס data-bs-toggle="dropdown"
איז שטענדיק פארלאנגט צו זיין פאָרשטעלן אויף די צינגל עלעמענט פון די דראָפּדאָוון.
אָפּציעס
אָפּציעס קענען זיין דורכגעגאנגען דורך דאַטן אַטריביוץ אָדער דזשאַוואַסקריפּט. פֿאַר דאַטן אַטריביוץ, צולייגן די אָפּציע נאָמען צו data-bs-
, ווי אין data-bs-offset=""
. מאַכן זיכער צו טוישן די פאַל טיפּ פון די אָפּציע נאָמען פון camelCase צו קעבאַב-פאַל ווען איר פאָרן די אָפּציעס דורך דאַטן אַטריביוץ. פֿאַר בייַשפּיל, אַנשטאָט פון ניצן data-bs-autoClose="false"
, נוצן data-bs-auto-close="false"
.
נאָמען | טיפּ | פעליקייַט | באַשרייַבונג |
---|---|---|---|
boundary |
שטריקל | עלעמענט | 'clippingParents' |
איבערפלאָו קאַנסטריינט גרענעץ פון די דראָפּדאָוון מעניו (אַפּלייז בלויז צו פּאָפּער ס פּרעווענטאָווערפלאָוו מאָדיפיער). דורך פעליקייַט עס ס 'clippingParents' און קענען אָננעמען אַן HTMLElement דערמאָנען (בלויז דורך דזשאַוואַסקריפּט). פֿאַר מער אינפֿאָרמאַציע אָפּשיקן צו Popper's detectOverflow docs . |
reference |
שטריקל | עלעמענט | כייפעץ | 'toggle' |
רעפערענץ עלעמענט פון די דראָפּדאָוון מעניו. אַקסעפּץ די וואַלועס פון 'toggle' , 'parent' , אַן HTMLElement רעפֿערענץ אָדער אַ כייפעץ פּראַוויידינג getBoundingClientRect . פֿאַר מער אינפֿאָרמאַציע אָפּשיקן צו פּאָפּער ס קאַנסטראַקטער דאָקומענטן און ווירטואַל עלעמענט דאָקס . |
display |
שטריקל | 'dynamic' |
דורך פעליקייַט, מיר נוצן פּאָפּער פֿאַר דינאַמיש פּאַזישאַנינג. דיסייבאַל דעם מיט static . |
offset |
מענגע | שטריקל | פֿונקציע | [0, 2] |
פאָטאָ פון די דראָפּדאָוון קאָרעוו צו זיין ציל. איר קענען פאָרן אַ שטריקל אין דאַטן אַטריביוץ מיט קאָמע אפגעשיידט וואַלועס ווי: ווען אַ פֿונקציע איז גענוצט צו באַשטימען דעם פאָטאָ, עס איז גערופן מיט אַ כייפעץ מיט די פּאָפּער פּלייסמאַנט, די רעפֿערענץ, און פּאָפּער רעקץ ווי זייַן ערשטער אַרגומענט. די טריגערינג עלעמענט DOM נאָדע איז דורכגעגאנגען ווי די רגע אַרגומענט. די פֿונקציע מוזן צוריקקומען אַ מענגע מיט צוויי נומערן: . פֿאַר מער אינפֿאָרמאַציע אָפּשיקן צו פּאָפּער ס פאָטאָ דאָקומענטן . |
autoClose |
בוליאַן | שטריקל | true |
קאַנפיגיער די אַוטאָ נאָענט נאַטור פון די דראָפּדאָוון:
|
popperConfig |
null | כייפעץ | פֿונקציע | null |
צו טוישן באָאָטסטראַפּ ס פעליקייַט פּאָפּער קאַנפיגיעריישאַן, זען פּאָפּער ס קאַנפיגיעריישאַן . ווען אַ פֿונקציע איז גענוצט צו שאַפֿן די פּאָפּער קאַנפיגיעריישאַן, עס איז גערופן מיט אַ כייפעץ וואָס כּולל די באָאָטסטראַפּ ס פעליקייַט פּאָפּער קאַנפיגיעריישאַן. עס העלפּס איר נוצן און צונויפגיסן די פעליקייַט מיט דיין אייגענע קאַנפיגיעריישאַן. די פֿונקציע מוזן צוריקקומען אַ קאַנפיגיעריישאַן כייפעץ פֿאַר פּאָפּער. |
ניצן פונקציע מיטpopperConfig
var dropdown = new bootstrap.Dropdown(element, {
popperConfig: function (defaultBsPopperConfig) {
// var newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
מעטהאָדס
מעטאָד | באַשרייַבונג |
---|---|
toggle |
טאָגלעס די דראָפּדאָוון מעניו פון אַ געגעבן נאַוובאַר אָדער טאַבבעד נאַוויגאַציע. |
show |
ווייזט די דראָפּדאָוון מעניו פון אַ געגעבן נאַוובאַר אָדער טאַבבעד נאַוויגאַציע. |
hide |
כיידז די דראָפּדאָוון מעניו פון אַ געגעבן נאַוובאַר אָדער טאַבבעד נאַוויגאַציע. |
update |
דערהייַנטיקונגען די שטעלע פון אַ עלעמענט ס דראָפּדאָוון. |
dispose |
דיסטרויז אַן עלעמענט ס דראָפּדאָוון. (רימוווז סטאָרד דאַטן אויף די DOM עלעמענט) |
getInstance |
סטאַטיק אופֿן וואָס אַלאַוז איר צו באַקומען די דראָפּדאָוון בייַשפּיל פארבונדן צו אַ DOM עלעמענט, איר קענען נוצן עס ווי דאָס:bootstrap.Dropdown.getInstance(element) |
getOrCreateInstance |
סטאַטיק אופֿן וואָס קערט אַ דראָפּדאָוון בייַשפּיל פֿאַרבונדן צו אַ DOM עלעמענט אָדער שאַפֿן אַ נייַע אין פאַל עס איז נישט יניטיאַלייזד. איר קענען נוצן עס ווי דאָס:bootstrap.Dropdown.getOrCreateInstance(element) |
געשעענישן
אַלע דראָפּדאָוון געשעענישן זענען פייערד אויף די טאַגאַלינג עלעמענט און דעמאָלט באַבאַלד אַרויף. אַזוי איר קענען אויך לייגן געשעעניש צוהערערס אויף דער .dropdown-menu
פאָטער עלעמענט. hide.bs.dropdown
און hidden.bs.dropdown
געשעענישן האָבן אַ clickEvent
פאַרמאָג (בלויז ווען דער אָריגינעל עווענט טיפּ איז click
) וואָס כּולל אַ עווענט אָבדזשעקט פֿאַר די קליק געשעעניש.
מעטאָד | באַשרייַבונג |
---|---|
show.bs.dropdown |
פירעס מיד ווען די ווייַזן בייַשפּיל אופֿן איז גערופן. |
shown.bs.dropdown |
פייערד ווען די דראָפּדאָוון איז קענטיק צו דער באַניצער און CSS טראַנזישאַנז האָבן געענדיקט. |
hide.bs.dropdown |
פירעס מיד ווען די באַהאַלטן בייַשפּיל אופֿן איז גערופן. |
hidden.bs.dropdown |
פייערד ווען די דראָפּדאָוון איז פאַרטיק צו זיין פאַרבאָרגן פון די באַניצער און CSS טראַנזישאַנז האָבן געענדיקט. |
var myDropdown = document.getElementById('myDropdown')
myDropdown.addEventListener('show.bs.dropdown', function () {
// do something...
})