Schalten Sie mit dem Bootstrap-Dropdown-Plug-in kontextabhängige Overlays zum Anzeigen von Linklisten und mehr um.
Überblick
Dropdowns sind umschaltbare, kontextabhängige Overlays zum Anzeigen von Linklisten und mehr. Sie werden mit dem enthaltenen Bootstrap-Dropdown-JavaScript-Plugin interaktiv gemacht. Sie werden durch Klicken umgeschaltet, nicht durch Bewegen der Maus; Dies ist eine bewusste Designentscheidung .
Dropdowns basieren auf einer Bibliothek eines Drittanbieters, Popper.js , die dynamische Positionierung und Ansichtsfenstererkennung bietet. Stellen Sie sicher, dass Sie popper.min.js vor dem JavaScript von Bootstrap einfügen oder bootstrap.bundle.min.js/ verwenden bootstrap.bundle.js, das Popper.js enthält. Popper.js wird jedoch nicht zum Positionieren von Dropdowns in Navigationsleisten verwendet, da eine dynamische Positionierung nicht erforderlich ist.
Wenn Sie unser JavaScript aus der Quelle erstellenutil.js , ist .
Barrierefreiheit
Der WAI ARIA -Standard definiert ein eigentliches role="menu"Widget , aber das ist spezifisch für anwendungsähnliche Menüs, die Aktionen oder Funktionen auslösen. ARIA -Menüs können nur Menüelemente, Kontrollkästchen-Menüelemente, Optionsfeld-Menüelemente, Optionsfeldgruppen und Untermenüs enthalten.
Die Dropdowns von Bootstrap hingegen sind so konzipiert, dass sie generisch sind und auf eine Vielzahl von Situationen und Markup-Strukturen anwendbar sind. Beispielsweise ist es möglich, Dropdowns zu erstellen, die zusätzliche Eingaben und Formularsteuerelemente wie Suchfelder oder Anmeldeformulare enthalten. Aus diesem Grund erwartet Bootstrap keine der für echte ARIA - Menüs erforderlichen Attribute roleund (oder fügt diese automatisch hinzu). Autoren müssen diese spezifischeren Attribute selbst hinzufügen.aria-
Bootstrap fügt jedoch integrierte Unterstützung für die meisten standardmäßigen Tastaturmenüinteraktionen hinzu, z. B. die Möglichkeit, sich .dropdown-itemmit den Cursortasten durch einzelne Elemente zu bewegen und das Menü mit der ESCTaste zu schließen.
Beispiele
Umschließen Sie den Umschalter des Dropdown-Menüs (Ihre Schaltfläche oder Ihren Link) und das Dropdown-Menü .dropdownmit oder einem anderen Element, das deklariert position: relative;. Dropdowns können von <a>oder <button>Elementen ausgelöst werden, um Ihren potenziellen Anforderungen besser gerecht zu werden.
Einzelne Taste
Jede Single .btnkann mit einigen Markup-Änderungen in einen Dropdown-Schalter umgewandelt werden. So können Sie sie mit beiden <button>Elementen verwenden:
Erstellen Sie auf ähnliche Weise Dropdown-Listen mit geteilten Schaltflächen mit praktisch demselben Markup wie Dropdown-Listen mit einer Schaltfläche, jedoch mit dem Zusatz von .dropdown-toggle-splitfür den richtigen Abstand um das Dropdown-Cursor.
Wir verwenden diese zusätzliche Klasse, um die Horizontale paddingauf beiden Seiten des Caret-Zeichens um 25 % zu reduzieren und die margin-leftfür normale Schaltflächen-Dropdowns hinzugefügte zu entfernen. Diese zusätzlichen Änderungen sorgen dafür, dass das Caretzeichen in der Split-Taste zentriert bleibt, und bieten neben der Haupttaste einen Trefferbereich mit besserer Größe.
In der Vergangenheit mussten die Inhalte von Dropdown-Menüs Links sein, aber das ist bei v4 nicht mehr der Fall. Jetzt können Sie optional <button>Elemente in Ihren Dropdowns verwenden, anstatt nur <a>s.
Sie können auch nicht interaktive Dropdown-Elemente mit erstellen .dropdown-item-text. Fühlen Sie sich frei, mit benutzerdefinierten CSS- oder Textdienstprogrammen weiter zu gestalten.
Standardmäßig wird ein Dropdown-Menü automatisch 100 % von oben und entlang der linken Seite seines übergeordneten Elements positioniert. Fügen Sie .dropdown-menu-rightzu a .dropdown-menuhinzu, um das Dropdown-Menü rechts auszurichten.
Kopf hoch! Dropdowns werden dank Popper.js positioniert (außer wenn sie in einer Navigationsleiste enthalten sind).
Reaktionsschnelle Ausrichtung
Wenn Sie die responsive Ausrichtung verwenden möchten, deaktivieren Sie die dynamische Positionierung, indem Sie das data-display="static"Attribut hinzufügen, und verwenden Sie die responsiven Variationsklassen.
Um das Dropdown-Menü rechts.dropdown-menu{-sm|-md|-lg|-xl}-right am angegebenen Haltepunkt oder größer auszurichten, fügen Sie hinzu .
Um das Dropdown-Menü links.dropdown-menu-right am angegebenen Haltepunkt oder größer auszurichten, fügen Sie und hinzu .dropdown-menu{-sm|-md|-lg|-xl}-left.
Beachten Sie, dass Sie data-display="static"den Dropdown-Schaltflächen in Navigationsleisten kein Attribut hinzufügen müssen, da Popper.js in Navigationsleisten nicht verwendet wird.
Menüinhalt
Überschriften
Fügen Sie eine Kopfzeile hinzu, um Aktionsabschnitte in einem beliebigen Dropdown-Menü zu kennzeichnen.
Platzieren Sie beliebigen Freiformtext in einem Dropdown-Menü mit Text und verwenden Sie Abstandshilfsmittel . Beachten Sie, dass Sie wahrscheinlich zusätzliche Größenstile benötigen, um die Menübreite einzuschränken.
Ein Beispieltext, der innerhalb des Dropdown-Menüs frei fließen kann.
Und das ist mehr Beispieltext.
Formen
Fügen Sie ein Formular in ein Dropdown-Menü ein oder machen Sie es zu einem Dropdown-Menü und verwenden Sie Rand- oder Auffüll- Dienstprogramme , um ihm den erforderlichen negativen Raum zu geben.
Über Datenattribute oder JavaScript schaltet das Dropdown-Plug-in ausgeblendete Inhalte (Dropdown-Menüs) um, indem es die .showKlasse des übergeordneten Listenelements umschaltet. Das data-toggle="dropdown"Attribut wird zum Schließen von Dropdown-Menüs auf Anwendungsebene verwendet, daher ist es eine gute Idee, es immer zu verwenden.
Auf berührungsempfindlichen Geräten fügt das Öffnen eines Dropdown-Menüs leere ( $.noop) mouseoverHandler zu den unmittelbar untergeordneten Elementen des <body>Elements hinzu. Dieser zugegebenermaßen hässliche Hack ist notwendig, um eine Macke in der Ereignisdelegierung von iOS zu umgehen, die ansonsten verhindern würde, dass ein Tippen irgendwo außerhalb des Dropdowns den Code auslöst, der das Dropdown schließt. Sobald das Dropdown geschlossen wird, werden diese zusätzlichen leeren mouseoverHandler entfernt.
Über Datenattribute
Zu einem Link oder einer Schaltfläche hinzufügen data-toggle="dropdown", um ein Dropdown-Menü umzuschalten.
Über JavaScript
Rufen Sie die Dropdowns über JavaScript auf:
data-toggle="dropdown"noch erforderlich
Unabhängig davon, ob Sie Ihr Dropdown über JavaScript aufrufen oder stattdessen die Daten-API verwenden, muss data-toggle="dropdown"es immer auf dem Trigger-Element des Dropdowns vorhanden sein.
Optionen
Optionen können über Datenattribute oder JavaScript übergeben werden. Hängen Sie für Datenattribute den Optionsnamen an data-, wie in data-offset="".
Name
Typ
Standard
Beschreibung
versetzt
Zahl | Zeichenfolge | Funktion
0
Offset des Dropdowns relativ zu seinem Ziel.
Wenn eine Funktion verwendet wird, um den Offset zu bestimmen, wird sie mit einem Objekt aufgerufen, das die Offset-Daten als erstes Argument enthält. Die Funktion muss ein Objekt mit derselben Struktur zurückgeben. Als zweites Argument wird das auslösende Element DOM node übergeben.
Überlaufbeschränkungsgrenze des Dropdown-Menüs. Akzeptiert die Werte von 'viewport', 'window', 'scrollParent', oder eine HTMLElement-Referenz (nur JavaScript). Weitere Informationen finden Sie in der Datei preventOverflow von Popper.js .
Beachten Sie, dass wenn boundaryauf einen anderen Wert als gesetzt 'scrollParent'ist, der Stil position: staticauf den .dropdownContainer angewendet wird.
Methoden
Methode
Beschreibung
$().dropdown('toggle')
Schaltet das Dropdown-Menü einer bestimmten Navigationsleiste oder Registerkartennavigation um bzw. um.
$().dropdown('show')
Zeigt das Dropdown-Menü einer bestimmten Navigationsleiste oder Registerkartennavigation an.
$().dropdown('hide')
Blendet das Dropdown-Menü einer bestimmten Navigationsleiste oder Registerkartennavigation aus.
$().dropdown('update')
Aktualisiert die Position der Dropdown-Liste eines Elements.
$().dropdown('dispose')
Zerstört das Dropdown eines Elements.
Veranstaltungen
Alle Dropdown-Ereignisse werden beim .dropdown-menuübergeordneten Element von ausgelöst und haben eine relatedTargetEigenschaft, deren Wert das umschaltende Ankerelement ist. hide.bs.dropdownund hidden.bs.dropdownEreignisse haben eine clickEventEigenschaft (nur wenn der ursprüngliche Ereignistyp click) ist, die ein Ereignisobjekt für das Klickereignis enthält.
Vorfall
Beschreibung
show.bs.dropdown
Dieses Ereignis wird sofort ausgelöst, wenn die show instance-Methode aufgerufen wird.
shown.bs.dropdown
Dieses Ereignis wird ausgelöst, wenn das Dropdown-Menü für den Benutzer sichtbar gemacht wurde (wartet auf den Abschluss von CSS-Übergängen).
hide.bs.dropdown
Dieses Ereignis wird sofort ausgelöst, wenn die Methode zum Ausblenden der Instanz aufgerufen wurde.
hidden.bs.dropdown
Dieses Ereignis wird ausgelöst, wenn die Dropdown-Liste vollständig vor dem Benutzer ausgeblendet wurde (wartet auf den Abschluss von CSS-Übergängen).