Modal
Benotzt Bootstrap's JavaScript modal Plugin fir Dialogen op Är Site fir Lightboxen, Benotzer Notifikatiounen oder komplett personaliséiert Inhalter ze addéieren.
Wéi et funktionnéiert
Ier Dir mam Bootstrap's modale Komponent ufänkt, gitt sécher déi folgend ze liesen well eis Menüoptioune viru kuerzem geännert hunn.
- Modale si mat HTML, CSS a JavaScript gebaut. Si sinn iwwer alles anescht am Dokument positionéiert an ewechzehuelen Scroll aus dem
<body>
sou datt modal Inhalt scrollt amplaz. - Klickt op de Modal "Kulisse" mécht de Modal automatesch zou.
- Bootstrap ënnerstëtzt nëmmen eng modal Fënster gläichzäiteg. Nested Modals ginn net ënnerstëtzt well mir gleewen datt se schlecht Benotzererfarungen sinn.
- Modals benotzen
position: fixed
, wat heiansdo e bësse speziell iwwer seng Rendering ka sinn. Wann ëmmer méiglech, setzt Är modal HTML an enger Top-Level Positioun fir potenziell Interferenz vun aneren Elementer ze vermeiden. Dir wäert méiglecherweis an Probleemer lafen wann Dir en.modal
an engem anere fixen Element nest. - Nach eng Kéier, wéinst
position: fixed
, ginn et e puer Virschléi mat der Benotzung vu Modalen op mobilen Apparater. Gesinn eis Browser Support Dokumenter fir Detailer. - Wéinst wéi HTML5 seng Semantik definéiert, huet den
autofocus
HTML Attribut keen Effekt a Bootstrap Modal. Fir deeselwechten Effekt z'erreechen, benotzt e puer personaliséiert JavaScript:
var myModal = document.getElementById('myModal')
var myInput = document.getElementById('myInput')
myModal.addEventListener('shown.bs.modal', function () {
myInput.focus()
})
prefers-reduced-motion
Medienufro of. Kuckt d'
Reduktiounsbewegungssektioun vun eiser Accessibilitéitsdokumentatioun .
Liest weider fir Demos a Benotzungsrichtlinnen.
Beispiller
Modal Komponente
Drënner ass e statesch modal Beispill (dat heescht seng position
a display
goufen iwwerschriwwen). Abegraff sinn de modale Header, modale Kierper (obligatoresch fir padding
), a modal Fousszeilen (optional). Mir froen datt Dir modal Header mat Entloossaktiounen enthält wa méiglech, oder eng aner explizit Entloossaktioun ubitt.
<div class="modal" tabindex="-1">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title">Modal title</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<p>Modal body text goes here.</p>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Save changes</button>
</div>
</div>
</div>
</div>
Live Demo
Toggle eng funktionéierend modal Demo andeems Dir op de Knäppchen hei drënner klickt. Et rutscht erof a verschwannen vun uewen op der Säit.
<!-- Button trigger modal -->
<button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#exampleModal">
Launch demo modal
</button>
<!-- Modal -->
<div class="modal fade" id="exampleModal" tabindex="-1" aria-labelledby="exampleModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="exampleModalLabel">Modal title</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
...
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Save changes</button>
</div>
</div>
</div>
</div>
Statesch Kuliss
Wann den Hannergrond op statesch gesat ass, gëtt de Modal net zou wann Dir dobausse klickt. Klickt op de Knäppchen hei ënnen fir et ze probéieren.
<!-- Button trigger modal -->
<button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#staticBackdrop">
Launch static backdrop modal
</button>
<!-- Modal -->
<div class="modal fade" id="staticBackdrop" data-bs-backdrop="static" data-bs-keyboard="false" tabindex="-1" aria-labelledby="staticBackdropLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="staticBackdropLabel">Modal title</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
...
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Understood</button>
</div>
</div>
</div>
</div>
Scrolling laang Inhalt
Wann d'Modalen ze laang ginn fir de Viewport oder den Apparat vum Benotzer, scrollen se onofhängeg vun der Säit selwer. Probéiert d'Demo hei ënnen fir ze kucken wat mir mengen.
Dir kënnt och e scrollbare Modal erstellen, deen de modale Kierper scrollen erlaabt andeems Dir .modal-dialog-scrollable
op .modal-dialog
.
<!-- Scrollable modal -->
<div class="modal-dialog modal-dialog-scrollable">
...
</div>
Vertikal zentréiert
Füügt .modal-dialog-centered
fir .modal-dialog
de Modal vertikal ze zentréieren.
<!-- Vertically centered modal -->
<div class="modal-dialog modal-dialog-centered">
...
</div>
<!-- Vertically centered scrollable modal -->
<div class="modal-dialog modal-dialog-centered modal-dialog-scrollable">
...
</div>
Tooltips an Popovers
Tooltips a Popovers kënne bannent Modale plazéiert ginn wéi néideg. Wann Modale zougemaach sinn, ginn all Tooltipps a Popovers bannent och automatesch entlooss.
<div class="modal-body">
<h5>Popover in a modal</h5>
<p>This <a href="#" role="button" class="btn btn-secondary popover-test" title="Popover title" data-bs-content="Popover body content is set in this attribute.">button</a> triggers a popover on click.</p>
<hr>
<h5>Tooltips in a modal</h5>
<p><a href="#" class="tooltip-test" title="Tooltip">This link</a> and <a href="#" class="tooltip-test" title="Tooltip">that link</a> have tooltips on hover.</p>
</div>
Benotzt de Gitter
Benotzt de Bootstrap Gitter System bannent engem Modal andeems Dir .container-fluid
an der .modal-body
. Dann benotzt déi normal Gittersystemklassen wéi Dir soss anzwousch géift.
<div class="modal-body">
<div class="container-fluid">
<div class="row">
<div class="col-md-4">.col-md-4</div>
<div class="col-md-4 ms-auto">.col-md-4 .ms-auto</div>
</div>
<div class="row">
<div class="col-md-3 ms-auto">.col-md-3 .ms-auto</div>
<div class="col-md-2 ms-auto">.col-md-2 .ms-auto</div>
</div>
<div class="row">
<div class="col-md-6 ms-auto">.col-md-6 .ms-auto</div>
</div>
<div class="row">
<div class="col-sm-9">
Level 1: .col-sm-9
<div class="row">
<div class="col-8 col-sm-6">
Level 2: .col-8 .col-sm-6
</div>
<div class="col-4 col-sm-6">
Level 2: .col-4 .col-sm-6
</div>
</div>
</div>
</div>
</div>
</div>
Variéierend modalen Inhalt
Hutt Dir eng Rëtsch Knäppercher déi all déiselwecht Modal mat liicht verschiddenen Inhalter ausléisen? Benotzt event.relatedTarget
an HTML data-bs-*
Attributer fir den Inhalt vum Modal ze variéieren jee no wéi ee Knäppchen geklickt gouf.
Drënner ass eng Live Demo gefollegt vum Beispill HTML a JavaScript. Fir méi Informatioun, liest d'Modal Eventer Dokumenter fir Detailer iwwer relatedTarget
.
<button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#exampleModal" data-bs-whatever="@mdo">Open modal for @mdo</button>
<button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#exampleModal" data-bs-whatever="@fat">Open modal for @fat</button>
<button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#exampleModal" data-bs-whatever="@getbootstrap">Open modal for @getbootstrap</button>
<div class="modal fade" id="exampleModal" tabindex="-1" aria-labelledby="exampleModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="exampleModalLabel">New message</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<form>
<div class="mb-3">
<label for="recipient-name" class="col-form-label">Recipient:</label>
<input type="text" class="form-control" id="recipient-name">
</div>
<div class="mb-3">
<label for="message-text" class="col-form-label">Message:</label>
<textarea class="form-control" id="message-text"></textarea>
</div>
</form>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Send message</button>
</div>
</div>
</div>
</div>
var exampleModal = document.getElementById('exampleModal')
exampleModal.addEventListener('show.bs.modal', function (event) {
// Button that triggered the modal
var button = event.relatedTarget
// Extract info from data-bs-* attributes
var recipient = button.getAttribute('data-bs-whatever')
// If necessary, you could initiate an AJAX request here
// and then do the updating in a callback.
//
// Update the modal's content.
var modalTitle = exampleModal.querySelector('.modal-title')
var modalBodyInput = exampleModal.querySelector('.modal-body input')
modalTitle.textContent = 'New message to ' + recipient
modalBodyInput.value = recipient
})
Wiesselt tëscht Modaler
Wiesselt tëscht Multiple Modale mat e puer clevere Placement vun den data-bs-target
an data-bs-toggle
Attributer. Zum Beispill, Dir kënnt e Passwuert zréckgesat Modal aus engem schonn opgemaache Sign-in Modal wiesselen. Notéiert w.e.g. datt verschidde Modaler net zur selwechter Zäit kënnen op sinn - dës Method wiesselt einfach tëscht zwee getrennte Modale.
<div class="modal fade" id="exampleModalToggle" aria-hidden="true" aria-labelledby="exampleModalToggleLabel" tabindex="-1">
<div class="modal-dialog modal-dialog-centered">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="exampleModalToggleLabel">Modal 1</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
Show a second modal and hide this one with the button below.
</div>
<div class="modal-footer">
<button class="btn btn-primary" data-bs-target="#exampleModalToggle2" data-bs-toggle="modal">Open second modal</button>
</div>
</div>
</div>
</div>
<div class="modal fade" id="exampleModalToggle2" aria-hidden="true" aria-labelledby="exampleModalToggleLabel2" tabindex="-1">
<div class="modal-dialog modal-dialog-centered">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="exampleModalToggleLabel2">Modal 2</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
Hide this modal and show the first with the button below.
</div>
<div class="modal-footer">
<button class="btn btn-primary" data-bs-target="#exampleModalToggle" data-bs-toggle="modal">Back to first</button>
</div>
</div>
</div>
</div>
<a class="btn btn-primary" data-bs-toggle="modal" href="#exampleModalToggle" role="button">Open first modal</a>
Änneren Animatioun
D' $modal-fade-transform
Variabel bestëmmt den Transformatiounszoustand vu .modal-dialog
virun der modaler Fade-in Animatioun, d' $modal-show-transform
Variabel bestëmmt d'Transformatioun vun .modal-dialog
um Enn vun der modaler Fade-in Animatioun.
Wann Dir zum Beispill eng Zoom-In Animatioun wëllt, kënnt Dir setzen $modal-fade-transform: scale(.8)
.
Ewechzehuelen Animatioun
Fir Modaler déi einfach erschéngen anstatt ze verschwannen fir ze kucken, läscht d' .fade
Klass aus Ärem Modal Markup.
<div class="modal" tabindex="-1" aria-labelledby="..." aria-hidden="true">
...
</div>
Dynamesch Héichten
Wann d'Héicht vun engem Modal ännert wann et op ass, sollt Dir uruffenmyModal.handleUpdate()
fir d'Positioun vum Modal z'änneren am Fall wou eng Scrollbar erscheint.
Accessibilitéit
Gitt sécher bäizefügen aria-labelledby="..."
, de modalen Titel ze referenzéieren, op .modal
. Zousätzlech kënnt Dir eng Beschreiwung vun Ärem modalen Dialog mat aria-describedby
op ginn .modal
. Notéiert datt Dir net braucht derbäi ze ginn role="dialog"
well mir et scho iwwer JavaScript addéieren.
Embetting YouTube Videoen
Embedding vu YouTube Videoen a Modalen erfuerdert zousätzlech JavaScript net am Bootstrap fir automatesch d'Playback ze stoppen a méi. Gesinn dës hëllefräich Stack Overflow Post fir méi Informatiounen.
Optional Gréissten
Modaler hunn dräi fakultativ Gréissten, verfügbar via Modifikateur Klassen op engem gesat ginn .modal-dialog
. Dës Gréisste kicken op bestëmmte Breakpunkte fir horizontale Scrollbars op méi schmuele Viewports ze vermeiden.
Gréisst | Klass | Modal Max-Breet |
---|---|---|
Kleng | .modal-sm |
300px |
Default | Keen | 500px |
Grouss | .modal-lg |
800px |
Extra grouss | .modal-xl |
1140px |
Eis Standardmodal ouni Modifizéierungsklass mécht de "mëttel" Gréisst Modal aus.
<div class="modal-dialog modal-xl">...</div>
<div class="modal-dialog modal-lg">...</div>
<div class="modal-dialog modal-sm">...</div>
Vollbildmodus Modal
Eng aner Iwwerschrëft ass d'Optioun fir e Modal opzemaachen, deen de Benotzer Viewport deckt, verfügbar iwwer Modifizéierungsklassen déi op engem .modal-dialog
.
Klass | Disponibilitéit |
---|---|
.modal-fullscreen |
Ëmmer |
.modal-fullscreen-sm-down |
Drënner576px |
.modal-fullscreen-md-down |
Drënner768px |
.modal-fullscreen-lg-down |
Drënner992px |
.modal-fullscreen-xl-down |
Drënner1200px |
.modal-fullscreen-xxl-down |
Drënner1400px |
<!-- Full screen modal -->
<div class="modal-dialog modal-fullscreen-sm-down">
...
</div>
Sass
Variablen
$modal-inner-padding: $spacer;
$modal-footer-margin-between: .5rem;
$modal-dialog-margin: .5rem;
$modal-dialog-margin-y-sm-up: 1.75rem;
$modal-title-line-height: $line-height-base;
$modal-content-color: null;
$modal-content-bg: $white;
$modal-content-border-color: rgba($black, .2);
$modal-content-border-width: $border-width;
$modal-content-border-radius: $border-radius-lg;
$modal-content-inner-border-radius: subtract($modal-content-border-radius, $modal-content-border-width);
$modal-content-box-shadow-xs: $box-shadow-sm;
$modal-content-box-shadow-sm-up: $box-shadow;
$modal-backdrop-bg: $black;
$modal-backdrop-opacity: .5;
$modal-header-border-color: $border-color;
$modal-footer-border-color: $modal-header-border-color;
$modal-header-border-width: $modal-content-border-width;
$modal-footer-border-width: $modal-header-border-width;
$modal-header-padding-y: $modal-inner-padding;
$modal-header-padding-x: $modal-inner-padding;
$modal-header-padding: $modal-header-padding-y $modal-header-padding-x; // Keep this for backwards compatibility
$modal-sm: 300px;
$modal-md: 500px;
$modal-lg: 800px;
$modal-xl: 1140px;
$modal-fade-transform: translate(0, -50px);
$modal-show-transform: none;
$modal-transition: transform .3s ease-out;
$modal-scale-transform: scale(1.02);
Loop
Reaktiounsfäeger Vollbildmodus ginn iwwer d' $breakpoints
Kaart an eng Loop generéiert scss/_modal.scss
.
@each $breakpoint in map-keys($grid-breakpoints) {
$infix: breakpoint-infix($breakpoint, $grid-breakpoints);
$postfix: if($infix != "", $infix + "-down", "");
@include media-breakpoint-down($breakpoint) {
.modal-fullscreen#{$postfix} {
width: 100vw;
max-width: none;
height: 100%;
margin: 0;
.modal-content {
height: 100%;
border: 0;
@include border-radius(0);
}
.modal-header {
@include border-radius(0);
}
.modal-body {
overflow-y: auto;
}
.modal-footer {
@include border-radius(0);
}
}
}
}
Benotzung
De modale Plugin wiesselt Äre verstoppte Inhalt op Ufro, iwwer Datenattributer oder JavaScript. Et iwwerschreift och Standard Scrollverhalen a generéiert eng.modal-backdrop
fir e Klickberäich ze bidden fir ugewisen Modaler ze entloossen wann Dir ausserhalb vum Modal klickt.
Via daten Attributer
Toggle
Aktivéiert e Modal ouni JavaScript ze schreiwen. Setzt data-bs-toggle="modal"
op e Controllerelement, wéi e Knäppchen, zesumme mat engem data-bs-target="#foo"
oder href="#foo"
fir e spezifesche Modal ze zielen fir ze wiesselen.
<button type="button" data-bs-toggle="modal" data-bs-target="#myModal">Launch modal</button>
Entloossen
Entloossung ka mat dem data
Attribut op engem Knäpp am Modal erreecht ginn wéi hei ënnen gewisen:
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
oder op engem Knäppchen ausserhalb vum Modal benotzt de data-bs-target
wéi hei ënnen gewisen:
<button type="button" class="btn-close" data-bs-dismiss="modal" data-bs-target="#my-modal" aria-label="Close"></button>
Iwwer JavaScript
Erstellt e Modal mat enger eenzeger JavaScript Zeil:
var myModal = new bootstrap.Modal(document.getElementById('myModal'), options)
Optiounen
Optiounen kënnen iwwer Datenattributer oder JavaScript weidergeleet ginn. Fir Datenattributer, fügen d'Optiounsnumm un data-bs-
, wéi an data-bs-backdrop=""
.
Numm | Typ | Default | Beschreiwung |
---|---|---|---|
backdrop |
boolesch oder de String'static' |
true |
Ëmfaasst e modal-Kulisse-Element. Alternativ, spezifizéiert static fir eng Kuliss déi de Modal net op Klick zoumaacht. |
keyboard |
boolesch | true |
Maacht de Modal zou wann d'Escape-Taste gedréckt gëtt |
focus |
boolesch | true |
Stellt de Fokus op de Modal wann se initialiséiert ginn. |
Methoden
Asynchron Methoden an Iwwergäng
All API Methoden sinn asynchron a starten en Iwwergang . Si ginn zréck op den Uruffer soubal den Iwwergang ugefaang ass, awer ier en eriwwer ass . Zousätzlech gëtt e Methodruff op eng Iwwergangskomponent ignoréiert .
Passéieren Optiounen
Aktivéiert Ären Inhalt als Modal. Akzeptéiert eng fakultativ Optiounen object
.
var myModal = new bootstrap.Modal(document.getElementById('myModal'), {
keyboard: false
})
wiesselen
Manuell wiesselt e Modal. Gëtt zréck op den Uruffer ier de Modal tatsächlech gewisen oder verstoppt goufshown.bs.modal
( dh ier den hidden.bs.modal
Event geschitt ass).
myModal.toggle()
weisen
Manuell mécht e Modal op. Gitt zréck op den Uruffer ier de Modal tatsächlech gewisen gouf (dh ier d' shown.bs.modal
Evenement geschitt ass).
myModal.show()
Och kënnt Dir en DOM Element als Argument passéieren dat an de modalen Eventer (als relatedTarget
Immobilie) kritt ka ginn.
var modalToggle = document.getElementById('toggleMyModal') // relatedTarget
myModal.show(modalToggle)
verstoppen
Manuell verstoppt e Modal. Gitt zréck op den Uruffer ier de Modal tatsächlech verstoppt ass (dh ier d' hidden.bs.modal
Evenement geschitt ass).
myModal.hide()
handleUpdate
Manuell d'Positioun vum Modal nei ajustéieren wann d'Héicht vun engem Modal ännert wärend et op ass (dh am Fall wou eng Scrollbar erscheint).
myModal.handleUpdate()
entsuergen
Zerstéiert d'Modal vun engem Element. (läscht gespäichert Daten am DOM Element)
myModal.dispose()
getInstanz
Statesch Method déi Iech erlaabt d'modal Instanz mat engem DOM Element assoziéiert ze kréien
var myModalEl = document.getElementById('myModal')
var modal = bootstrap.Modal.getInstance(myModalEl) // Returns a Bootstrap modal instance
getOrCreateInstance
Statesch Method déi Iech erlaabt déi modal Instanz mat engem DOM Element assoziéiert ze kréien, oder eng nei ze kreéieren am Fall wou se net initialiséiert gouf
var myModalEl = document.querySelector('#myModal')
var modal = bootstrap.Modal.getOrCreateInstance(myModalEl) // Returns a Bootstrap modal instance
Evenementer
Dem Bootstrap seng modal Klass weist e puer Eventer fir an d'modal Funktionalitéit unzehaken. All Modal Eventer ginn op de Modal selwer geschoss (dh op der <div class="modal">
).
Event Typ | Beschreiwung |
---|---|
show.bs.modal |
Dëst Event brennt direkt wann d' show Instanzmethod genannt gëtt. Wann duerch e Klick verursaacht gëtt, ass dat geklickt Element als relatedTarget Eegeschafte vum Event verfügbar. |
shown.bs.modal |
Dëst Evenement gëtt ausgeléist wann de Modal fir de Benotzer siichtbar gemaach gouf (waart op CSS Iwwergäng fir fäerdeg ze maachen). Wann duerch e Klick verursaacht gëtt, ass dat geklickt Element als relatedTarget Eegeschafte vum Event verfügbar. |
hide.bs.modal |
Dëst Evenement gëtt direkt gebrannt wann d' hide Instanzmethod genannt gouf. |
hidden.bs.modal |
Dëst Evenement gëtt ausgeléist wann de Modal fäerdeg ass vum Benotzer verstoppt ze ginn (waart op CSS Iwwergäng fir fäerdeg ze sinn). |
hidePrevented.bs.modal |
Dëst Evenement gëtt ausgeléist wann de Modal gewise gëtt, seng Kuliss ass static an e Klick ausserhalb vum Modal oder eng Flucht Tastepress gëtt mat der Tastaturoptioun gemaach oder data-bs-keyboard op gesat false . |
var myModalEl = document.getElementById('myModal')
myModalEl.addEventListener('hidden.bs.modal', function (event) {
// do something...
})