Source

Modal

Brug Bootstraps JavaScript modal plugin til at tilføje dialogbokse til dit websted til lysbokse, brugermeddelelser eller helt tilpasset indhold.

Hvordan det virker

Før du går i gang med Bootstraps modale komponent, skal du sørge for at læse følgende, da vores menuindstillinger for nylig er ændret.

Modaler er bygget med HTML, CSS og JavaScript. De er placeret over alt andet i dokumentet og fjerner rulle fra dokumentet, <body>så modalt indhold ruller i stedet.
Ved at klikke på den modale "baggrund" lukkes modalen automatisk.
Bootstrap understøtter kun ét modalt vindue ad gangen. Indlejrede modaler understøttes ikke, da vi mener, at de er dårlige brugeroplevelser.
Modaler bruger position: fixed, som nogle gange kan være lidt speciel med hensyn til gengivelsen. Når det er muligt, skal du placere din modale HTML på øverste niveau for at undgå potentiel interferens fra andre elementer. Du vil sandsynligvis løbe ind i problemer, når du indlejrer en .modali et andet fast element.
Endnu en gang, grundet position: fixed, er der nogle forbehold med at bruge modaler på mobile enheder. Se vores browsersupportdokumenter for detaljer.
På grund af hvordan HTML5 definerer sin semantik, har autofocusHTML-attributten ingen effekt i Bootstrap-modaler. For at opnå den samme effekt skal du bruge noget tilpasset JavaScript:

$('#myModal').on('shown.bs.modal', function () {
  $('#myInput').trigger('focus')
})

Animationseffekten af denne komponent afhænger af prefers-reduced-motionmedieforespørgslen. Se afsnittet om reduceret bevægelse i vores tilgængelighedsdokumentation .

Fortsæt med at læse for demoer og retningslinjer for brug.

Eksempler

Nedenfor er et statisk modalt eksempel (hvilket betyder, at det er positionog displayer blevet tilsidesat). Inkluderet er modal sidehoved, modal tekst (påkrævet for padding) og modal sidefod (valgfrit). Vi beder dig om at inkludere modale overskrifter med afvisningshandlinger, når det er muligt, eller angive en anden eksplicit afvisningshandling.

<div class="modal" tabindex="-1" role="dialog">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title">Modal title</h5>
        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
          <span aria-hidden="true">&times;</span>
        </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-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div>
  </div>
</div>

Live demo

Skift en fungerende modal demo ved at klikke på knappen nedenfor. Det vil glide ned og fade ind fra toppen af siden.

<!-- Button trigger modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal">
  Launch demo modal
</button>

<!-- Modal -->
<div class="modal fade" id="exampleModal" tabindex="-1" role="dialog" aria-labelledby="exampleModalLabel" aria-hidden="true">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="exampleModalLabel">Modal title</h5>
        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
          <span aria-hidden="true">&times;</span>
        </button>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-secondary" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div>
  </div>
</div>

Statisk baggrund

Når baggrund er indstillet til statisk, lukker modalen ikke, når der klikkes uden for den. Klik på knappen nedenfor for at prøve det.

<!-- Button trigger modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#staticBackdrop">
  Launch static backdrop modal
</button>

<!-- Modal -->
<div class="modal fade" id="staticBackdrop" data-backdrop="static" tabindex="-1" role="dialog" aria-labelledby="staticBackdropLabel" aria-hidden="true">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="staticBackdropLabel">Modal title</h5>
        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
          <span aria-hidden="true">&times;</span>
        </button>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-secondary" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Understood</button>
      </div>
    </div>
  </div>
</div>

Rulle langt indhold

Når modalerne bliver for lange til brugerens viewport eller enhed, ruller de uafhængigt af selve siden. Prøv demoen nedenfor for at se, hvad vi mener.

<!-- Button trigger modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModalLong">
  Launch demo modal
</button>

<!-- Modal -->
<div class="modal fade" id="exampleModalLong" tabindex="-1" role="dialog" aria-labelledby="exampleModalLongTitle" aria-hidden="true">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="exampleModalLongTitle">Modal title</h5>
        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
          <span aria-hidden="true">&times;</span>
        </button>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-secondary" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div>
  </div>
</div>

Du kan også oprette en scrollbar modal, der tillader scroll modal body ved at tilføje .modal-dialog-scrollabletil .modal-dialog.

<!-- Button trigger modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModalScrollable">
  Launch demo modal
</button>

<!-- Modal -->
<div class="modal fade" id="exampleModalScrollable" tabindex="-1" role="dialog" aria-labelledby="exampleModalScrollableTitle" aria-hidden="true">
  <div class="modal-dialog modal-dialog-scrollable" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="exampleModalScrollableTitle">Modal title</h5>
        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
          <span aria-hidden="true">&times;</span>
        </button>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-secondary" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div>
  </div>
</div>

Lodret centreret

Tilføj .modal-dialog-centeredtil .modal-dialogfor at centrere modalen lodret.

<!-- Button trigger modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModalCenter">
  Launch demo modal
</button>

<!-- Modal -->
<div class="modal fade" id="exampleModalCenter" tabindex="-1" role="dialog" aria-labelledby="exampleModalCenterTitle" aria-hidden="true">
  <div class="modal-dialog modal-dialog-centered" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="exampleModalCenterTitle">Modal title</h5>
        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
          <span aria-hidden="true">&times;</span>
        </button>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-secondary" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div>
  </div>
</div>

Værktøjstip og popovers

Værktøjstip og popovers kan placeres i modaler efter behov. Når modalerne er lukket, afvises alle værktøjstip og popovers indeni også automatisk.

<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-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>

Brug af gitteret

Udnyt Bootstrap-gittersystemet i en modal ved at indlejre .container-fluidi .modal-body. Brug derefter de normale netsystemklasser, som du ville andre steder.

<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 ml-auto">.col-md-4 .ml-auto</div>
    </div>
    <div class="row">
      <div class="col-md-3 ml-auto">.col-md-3 .ml-auto</div>
      <div class="col-md-2 ml-auto">.col-md-2 .ml-auto</div>
    </div>
    <div class="row">
      <div class="col-md-6 ml-auto">.col-md-6 .ml-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>

Har du en masse knapper, der alle udløser den samme modal med lidt forskelligt indhold? Brug event.relatedTargetog HTML- data-*attributter (evt. via jQuery ) til at variere indholdet af modalen afhængigt af hvilken knap der blev klikket på.

Nedenfor er en live demo efterfulgt af eksempel HTML og JavaScript. For mere information, læs dokumentet om modale begivenheder for detaljer om relatedTarget.

<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@mdo">Open modal for @mdo</button>
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@fat">Open modal for @fat</button>
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@getbootstrap">Open modal for @getbootstrap</button>

<div class="modal fade" id="exampleModal" tabindex="-1" role="dialog" aria-labelledby="exampleModalLabel" aria-hidden="true">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="exampleModalLabel">New message</h5>
        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
          <span aria-hidden="true">&times;</span>
        </button>
      </div>
      <div class="modal-body">
        <form>
          <div class="form-group">
            <label for="recipient-name" class="col-form-label">Recipient:</label>
            <input type="text" class="form-control" id="recipient-name">
          </div>
          <div class="form-group">
            <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-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Send message</button>
      </div>
    </div>
  </div>
</div>

$('#exampleModal').on('show.bs.modal', function (event) {
  var button = $(event.relatedTarget) // Button that triggered the modal
  var recipient = button.data('whatever') // Extract info from data-* attributes
  // If necessary, you could initiate an AJAX request here (and then do the updating in a callback).
  // Update the modal's content. We'll use jQuery here, but you could use a data binding library or other methods instead.
  var modal = $(this)
  modal.find('.modal-title').text('New message to ' + recipient)
  modal.find('.modal-body input').val(recipient)
})

Skift animation

$modal-fade-transformVariablen bestemmer transformationstilstanden før den .modal-dialogmodale fade-in-animation, $modal-show-transformvariablen bestemmer transformationen af .modal-dialogi slutningen af den modale fade-in-animation.

Ønsker du f.eks. en zoom-ind-animation, kan du indstille $modal-fade-transform: scale(.8).

Fjern animation

For modaler, der blot vises i stedet for at falme ind for at se, skal du fjerne .fadeklassen fra din modale markup.

<div class="modal" tabindex="-1" role="dialog" aria-labelledby="..." aria-hidden="true">
  ...
</div>

Dynamiske højder

Hvis højden på en modal ændres, mens den er åben, skal du ringe $('#myModal').modal('handleUpdate')for at justere modalens position, hvis der vises en rullepanel.

Tilgængelighed

Sørg for at tilføje role="dialog"og aria-labelledby="...", med henvisning til den modale titel, til .modal, og role="document"til sig .modal-dialogselv. Derudover kan du give en beskrivelse af din modale dialog med aria-describedbypå .modal.

Indlejring af YouTube-videoer

Indlejring af YouTube-videoer i modaler kræver yderligere JavaScript, der ikke er i Bootstrap for automatisk at stoppe afspilning og mere. Se dette nyttige Stack Overflow-indlæg for mere information.

Valgfri størrelser

Modaler har tre valgfrie størrelser, tilgængelige via modifikationsklasser til at blive placeret på en .modal-dialog. Disse størrelser slår ind ved bestemte brudpunkter for at undgå vandrette rullebjælker på smallere visningsporte.

Størrelse	Klasse	Modal max-bredde
Lille	`.modal-sm`	`300px`
Standard	Ingen	`500px`
Stor	`.modal-lg`	`800px`
Ekstra stor	`.modal-xl`	`1140px`

Vores standard modal uden modifikator klasse udgør "medium" størrelse modal.

<!-- Extra large modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bd-example-modal-xl">Extra large modal</button>

<div class="modal fade bd-example-modal-xl" tabindex="-1" role="dialog" aria-labelledby="myExtraLargeModalLabel" aria-hidden="true">
  <div class="modal-dialog modal-xl" role="document">
    <div class="modal-content">
      ...
    </div>
  </div>
</div>

<!-- Large modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bd-example-modal-lg">Large modal</button>

<div class="modal fade bd-example-modal-lg" tabindex="-1" role="dialog" aria-labelledby="myLargeModalLabel" aria-hidden="true">
  <div class="modal-dialog modal-lg" role="document">
    <div class="modal-content">
      ...
    </div>
  </div>
</div>

<!-- Small modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bd-example-modal-sm">Small modal</button>

<div class="modal fade bd-example-modal-sm" tabindex="-1" role="dialog" aria-labelledby="mySmallModalLabel" aria-hidden="true">
  <div class="modal-dialog modal-sm" role="document">
    <div class="modal-content">
      ...
    </div>
  </div>
</div>

Brug

Det modale plugin skifter dit skjulte indhold efter behov via dataattributter eller JavaScript. Det tilføjer også .modal-opentil <body>at tilsidesætte standard rulleadfærd og genererer et .modal-backdropklikområde til at afvise viste modaler, når der klikkes uden for modalen.

Via dataattributter

Aktiver en modal uden at skrive JavaScript. Indstil data-toggle="modal"på et controller-element, som en knap, sammen med et data-target="#foo"eller href="#foo"for at målrette en bestemt modal til at skifte.

<button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>

Via JavaScript

Kald en modal med id myModalmed en enkelt linje JavaScript:

$('#myModal').modal(options)

Muligheder

Indstillinger kan videregives via dataattributter eller JavaScript. For dataattributter skal du tilføje indstillingsnavnet til data-, som i data-backdrop="".

Navn	Type	Standard	Beskrivelse
baggrund	boolesk eller strengen`'static'`	rigtigt	Indeholder et modal-baggrundselement. Alternativt kan du angive `static`en baggrund, som ikke lukker modalen ved klik eller ved escape-tastetryk.
tastatur	boolesk	rigtigt	Lukker modalen, når der trykkes på escape-tasten
fokus	boolesk	rigtigt	Sætter fokus på modalen, når den initialiseres.
at vise	boolesk	rigtigt	Viser modal ved initialisering.

Metoder

Asynkrone metoder og overgange

Alle API - metoder er asynkrone og starter en overgang . De vender tilbage til den, der ringer, så snart overgangen er startet, men før den slutter . Derudover vil et metodekald på en overgangskomponent blive ignoreret .

Se vores JavaScript-dokumentation for mere information .

`.modal(options)`

Aktiverer dit indhold som en modal. Accepterer en valgfri indstilling object.

$('#myModal').modal({
  keyboard: false
})

`.modal('toggle')`

Skifter manuelt en modal. Vender tilbage til den, der ringer, før modalen faktisk er blevet vist eller skjult (dvs. før hændelsen shown.bs.modaleller hidden.bs.modalindtræffer).

$('#myModal').modal('toggle')

`.modal('show')`

Åbner manuelt en modal. Vender tilbage til den, der ringer, før modalen faktisk er blevet vist (dvs. før shown.bs.modalhændelsen indtræffer).

$('#myModal').modal('show')

`.modal('hide')`

Skjuler manuelt en modal. Vender tilbage til den, der ringer, før modalen rent faktisk er blevet skjult (dvs. før hidden.bs.modalhændelsen indtræffer).

$('#myModal').modal('hide')

`.modal('handleUpdate')`

Juster manuelt modalens position, hvis højden af en modal ændres, mens den er åben (dvs. hvis der vises en rullebjælke).

$('#myModal').modal('handleUpdate')

`.modal('dispose')`

Ødelægger et elements modal.

Begivenheder

Bootstraps modal-klasse afslører nogle få hændelser for tilslutning til modal funktionalitet. Alle modale hændelser skydes mod selve modalen (dvs. på <div class="modal">).

Begivenhedstype	Beskrivelse
show.bs.modal	Denne hændelse udløses med det samme, når `show`instansmetoden kaldes. Hvis det er forårsaget af et klik, er det klikkede element tilgængeligt som `relatedTarget`hændelsens egenskab.
vist.bs.modal	Denne hændelse udløses, når modalen er gjort synlig for brugeren (vil vente på, at CSS-overgange er fuldført). Hvis det er forårsaget af et klik, er det klikkede element tilgængeligt som `relatedTarget`hændelsens egenskab.
hide.bs.modal	Denne hændelse udløses straks, når `hide`instansmetoden er blevet kaldt.
skjult.bs.modal	Denne hændelse udløses, når modalen er færdig med at blive skjult for brugeren (vil vente på, at CSS-overgange er fuldført).
hidePrevented.bs.modal	Denne hændelse udløses, når modalen vises, dens baggrund er, `static`og der udføres et klik uden for modalen eller et escape-tastetryk.

$('#myModal').on('hidden.bs.modal', function (e) {
  // do something...
})