Web & Udvikling

Sådan opretter du tilgængelige modal dialogbokse med HTML, CSS og JavaScript

How to Create Accessible Modal Dialogs with HTML, CSS, and JavaScript

Byg tilgængelige modal dialogbokse ved hjælp af det indbyggede HTML dialog-element. Lær, hvordan du åbner og lukker pop-ups, håndterer tastaturfokus, formaterer baggrunde og opretter bekræftelsesdialoger uden et JavaScript-bibliotek.

Sådan opretter du tilgængelige modalbokse med HTML, CSS og JavaScript

En besøger klikker på en knap på dit websted. En popup vises med en formular, en bekræftelsesbesked eller yderligere information.

At skabe den visuelle popup er nemt. At få det til at fungere korrekt med et tastatur, en skælmlæser og en mobilbrowser er en anden sag.

Mange tilpassede modalimplementationer bygger på store mængder JavaScript til at fokusere, blokere interaktion med siden og håndtere Escape-tasten.

Moderne HTML tilbyder en enklere tilgang: den native <dialog>-element.

Den leverer meget af den adfærd, der forventes af en modalboks direkte i browseren. Du kan oprette en funktionel popup med et lille antal HTML, CSS og JavaScript uden at installere et framework eller en plugin.

I denne guideBygger vi en genbrugelig modal, styliser den, tilføjer en bekræftelsesboks og udforsker de tilgængelighedsdetaljer, der har betydning på reelle hjemmesider.

1. Hvad adskiller en modalboks fra en regulær popup?

En modalbokse kræver midlertidigt, at besøgeren interagerer med en bestemt del af grænsefladen, før man ke til hovedsiden.

Typiske eksempler inkluderer:

  • Bekræftelse af sletning af et item.
  • Visning af en kontaktformular.
  • Anmodning om bekræftelse før forladelse af en side.
  • Visning af yderligere produktinformation.
  • Redigering af en applikationsindstilling.

En korrekt implementeret modal bør gøre formålet klart, tilbyre en oplåbne måde at lukke den på, og håndtere tastaturfokus passende.

Den native <dialog>-element understøtter både modal og ikke-modal adfærd.

Metode Adfærd
showModal() Åbner en modal og gør resten af dokumentet ude af spil
show() Åbner en ikke-modal dialog
close() Lukker boksen
method="dialog" Tillader en formularknap at lukke boksen

Den modaladfæd fokusstyring og tastaturinteraktion, der tilbydes af browseren.

2. Opret dit første HTML-modal

Lad os starte med et simpelt eksempel: en knap der åbner en boks indeholdende en titel, noget tekst og en lukknap.

<button type="button" id="openDialog">
    View delivery information
</button>

<dialog id="deliveryDialog"
        aria-labelledby="deliveryTitle">

    <h2 id="deliveryTitle">
        Delivery information
    </h2>

    <p>
        Orders are prepared within two business days.
        You will receive a tracking link by email.
    </p>

    <form method="dialog">
        <button type="submit" autofocus>
            Close
        </button>
    </form>

</dialog>

<script>
const openButton = document.getElementById('openDialog');
const dialog = document.getElementById('deliveryDialog');

openButton.addEventListener('click', () => {
    dialog.showModal();
});
</script>

Det er nok for at oprette en fungerende modalboks.

Når besøgeren klikker på knappen, åbner showModal() boksen oven over sidesindholdet.

Browseren håndterer flere vigtige adfærdsmønstre automatisk:

  • Boksen indgår i øverste lag, oven over almindelig sidesindhold.
  • Resten af dokumentet bliver inaktiv.
  • Tastaturfokus flyttes ind i boksen.
  • Trykning af Escape lukker det normalt.
  • Fokus returnerer normalt til åbningsknappen, når boksen lukkes.

Lukknappen bruger method="dialog", så den kræver ikke en JavaScript-hændelseshåndterer.

3. Stil boksen med CSS

Den standarddialog fungerer, men dens udseende er grundlæggende.

Vi kan give det afrundede hjørner, komfortabel afstand, en responsiv bredde og en baggrundsfortegnelse.

dialog {
    width: min(90vw, 520px);
    max-height: 85vh;
    box-sizing: border-box;
    padding: 2rem;
    border: 0;
    border-radius: 14px;
    background: #fff;
    color: #20242b;
    box-shadow: 0 20px 70px rgba(0, 0, 0, .2);
    overflow: auto;
}

dialog::backdrop {
    background: rgba(15, 23, 42, .65);
    backdrop-filter: blur(3px);
}

dialog h2 {
    margin-top: 0;
    font-size: 1.5rem;
}

dialog p {
    line-height: 1.6;
}

dialog button {
    padding: .75rem 1.25rem;
    border: 0;
    border-radius: 8px;
    background: #2458d3;
    color: #fff;
    font: inherit;
    cursor: pointer;
}

dialog button:focus-visible {
    outline: 3px solid #f59e0b;
    outline-offset: 3px;
}

::backdrop-pseudoelementet styler laget bag en modalboks.

Den optræder kun, når boksen vises modal, f.eks. gennem showModal().

En dialog åbnet med show() modtager ikke automatisk samme modal baggrundsadfærd.

Hvorfor bruge det øverste lag?

Traditionelle tilpassede popups bygger ofte på stigende store z-index-værdier.

En modalboks åbnet med showModal() indgår i browseren's øverste lag, hvilket undgår mange lag-kontekst problemer.

Dette er særligt nyttigt på hjemmesider med fast-header, flydende widgets og komplekse sidesbyggeprogrammer.

4. Forstå tastaturtilgængelighed

En modal bør fungere uden en mus.

Forestil en besøger, der navigerer dit websted ved hjælp af Tab-tasten. Når en modal åbnes, bør de kunne interagere med dets kontroller uden utilsigtet at bevæge sig ind i siden bagved.

Den native modalboks hjælper med denne adfærd.

W3C beskriver HTML-dialog-elementet som en teknik for at oprette tilgængelige modalbokse, herunder fokusindhold og focus-retur når boksen lukkes.

Giv boksen et tilgængeligt navn

Brug et synligt overskrift og referer til den med aria-labelledby:

<dialog aria-labelledby="settingsTitle">
    <h2 id="settingsTitle">Account settings</h2>
    ...
</dialog>

Dette giver hjælpemidler et meningsfuldt navn til boksen.

Vælg initial fokus omhyggeligt

autofocus-attributten kan identificere den kontrol, der bør modtage fokus, når modalboksen åbnes.

For en informationsboks, kan det være passende at fokusere lukknappen.

Illustration of the article's main concept

For et formular, kan det have mere mening at fokusere den første input.

For en destruktiv bekræftelse, er det ofte foretrukket at fokusere den sikrere handling, f.eks. Annuller.

Undgå at placere tabindex direkte på <dialog>-elementet; HTML-specifikationen forbyder det pågældende attribut på elementet selv.

Altid et synligt lukknap

Selvom Escape normalt lukker en modalboks, forbliver et synligt lukknap essential.

Mobilbrugere kan måske ikke have et fysisk tastatur, og nogle brugere ved ikke, at Escape kan lukke en popup.

5. Opret en bekræftelsesboks med to knapper

Lad os bygge en mere nyttig eksempels: bekræftelse af sletning af et gemt item.

Beskueren bør kunne vælge Annuller eller Slet.

HTML giver en bekvem mekanisme gennem method="dialog" og dialogens returnValue-ejendom.

<button type="button" id="deleteItem">
    Delete item
</button>

<dialog id="confirmDialog"
        aria-labelledby="confirmTitle">

    <h2 id="confirmTitle">
        Delete this item?
    </h2>

    <p>
        This action cannot be undone.
    </p>

    <form method="dialog">
        <button value="cancel" autofocus>
            Cancel
        </button>

        <button value="confirm">
            Delete
        </button>
    </form>

</dialog>

<script>
const deleteButton = document.getElementById('deleteItem');
const confirmDialog = document.getElementById('confirmDialog');

deleteButton.addEventListener('click', () => {
    confirmDialog.returnValue = 'cancel';
    confirmDialog.showModal();
});

confirmDialog.addEventListener('close', () => {
    if (confirmDialog.returnValue === 'confirm') {
        // Call your application deletion logic here.
        console.log('Deletion confirmed');
    }
});
</script>

Det vigtige detail er, at klikke en knap indeholdende en method="dialog" form lukker boksen og sætter dens returnValue.

Vores kode undersøger om brugeren valgte confirm.

Nulstillingen af værdien før åbning forhindrer en tidligere bekræftelse i at blive fejlfortolket som en ny, hvis brugeren lukker boksen med Escape.

Eksempelmet sletter intentionelt intet. I en rigtig applikation, ville den bekræftede handling kalde dit eget PHP endpoint eller applikationscontroller, med nødvendig autorisation og CSRF-beskyttelse.

6. Test bekræftelsesarbejdet

En nyttig demonstration er en liste af gemte item, hver med en Slet-knap. Klik på Slet bør åbne en bekræftelsesboks. Annuller bør efterlade itemet uberørt; Bekræft bør fjerne kun det valgte item.

Dette illustrerer bekræftelsesflowet uden at ændre reelle hjemmeside-data.

7. Tilføj en kontaktformular indeholdende en dialog

Men der er en vigtig forskel mellem at lukke en boks og indsende data til en server.

En form med method="dialog" lukker popup'en. Den sender ikke en konventionel HTTP-anmodning til din PHP-backend.

Til en rigtig kontaktformular, brug en normal formular-indsendelse eller en AJAX-anmodning.

F.eks:

<dialog id="contactDialog"
        aria-labelledby="contactTitle">

    <h2 id="contactTitle">
        Contact us
    </h2>

    <form action="/contact-handler.php" method="post">
        <label for="contactEmail">
            Your email
        </label>

        <input
            type="email"
            id="contactEmail"
            name="email"
            required
            autocomplete="email"
            autofocus
        >

        <label for="contactMessage">
            Your message
        </label>

        <textarea
            id="contactMessage"
            name="message"
            required
        ></textarea>

        <button type="submit">
            Send message
        </button>

        <button type="button" id="closeContact">
            Cancel
        </button>
    </form>
</dialog>

Send-knappen indsender normalt formularen.

Annuller-knappen bør lukke boksen uden at indsende:

document.getElementById('closeContact')
    .addEventListener('click', () => {
        document.getElementById('contactDialog').close();
    });

Din PHP-håndterer har stadig brug for at validere de indsendte data, implementere anti-spam-beskyttelse, og returnere en meningsfuld succes eller fejl response.

En modalboks forbedrer grænsefladen; den erstatter ikke server-side formular-sikkerhed.

8. Kan brugere lukke boksen ved at klikke uden for?

Mange hjemmesider tillader besøgende at lukke en popup ved at klikke på dens baggrund.

Dette adfærd kaldes ofte lydismiss.

Moderne HTML inkluderer closedby-attributten, som kan specificere om en dialog må lukkes via udenfor interaktion, platform lukkes anmodninger, eller eksplicitte kontroller.

F.eks:

<dialog id="infoDialog" closedby="any">
    <h2>More information</h2>
    <p>Additional details appear here.</p>

    <form method="dialog">
        <button>Close</button>
    </form>
</dialog>

Værdien closedby="any" tillader lydismiss-adfærd i browsere, der understøtter det.

Men understøttelse af nyere dialog-funktioner bør kontrolleres mod dine mål-browsere. De grundlæggende showModal() og close() APIs er mere bredt etableret.

For kritiske bekræftelsesbokse, kan utilsigtet udenfor lukning være uønsket.

I alle tilfælde, et synligt luk eller annuller kontrol.

9. Undgå disse almindelige implementeringsfejl

Technical workflow illustration

Åbning af en modal ved at tilføje open-attributten

Dette kode:

dialog.setAttribute('open', '');

udgør ikke samme adfærd som:

dialog.showModal();

open-attributten viser dialog ikke-modal. Den gør ikke automatisk resten af dokumentet inaktiv.

Brug showModal() når du har brug for en faktisk modal.

Fjernelse af open-attributten for at lukke en modal

Undgå manuelt at fjerne open-attributten fra en aktiv modal.

Brug:

dialog.close();

Dette følger den tilsigtede levetid og sikrer den passende lukning adfærd.

Brug af et link i stedet for en knap

En kontrol der åbner en interface-handling bør generelt være en knap:

<button type="button">Open settings</button>

Brug links til navigation til et andet resource.

Glemning af fokus-synlighed

Brugere, der navigerer med et tastatur, har brug for en synlig indikation af, hvilken kontrol der er aktiv.

Hold et klart :focus-visible stil frem for at fjerne browser fokus outlines uden erstatning.

Placering af boksen inde i et skjult container

Hvis en forældre-container er skjult, eller hvis en CMS dynamisk erstatter det omgivende markup, kan boksen opføre sig uforudset.

For sideskabelon-integrationer, foretrækker et stabilt container og sikre at JavaScript kører efter at boksen er indsat i dokumentet.

10. Integrer en dialog i WordPress eller Joomla

Du skal ikke lave et extension bare for at bruge det native dialog-element.

For en simpel hjemmeside, integrationen består af tre dele:

Del Hvor den hører hjemme
HTML-markup Custom HTML block, module, template, or page-builder element
CSS Theme or template custom CSS
JavaScript Theme/template custom JavaScript or a supported code-injection feature

WordPress

I WordPress kan du placere HTML i en Custom HTML block, forudsat at din konto og editor konfiguration tillader det nødvendige markup.

Tilføj stil gennem din themes understøttede custom CSS mekanisme.

For JavaScript, brug et theme-støttet script-område, et child theme, eller en pålidelig code-insertion extension der håndterer JavaScript korrekt.

Nogle redaktører og sikkerhedskonfigurationer filtre <script> elementer. Undgå at antage, at JavaScript indsat direkte i en indhold-blok vil udføre.

Joomla

I Joomla, en Custom module eller en editor tillader egnet HTML markup kan indeholde dialog.

Tilføj CSS til din templates custom stylesheet, såsom user.css i en Cassiopeia-baseret hjemmeside.

Placer JavaScript i template's understøttede custom script placering eller gennem en suitable extension.

Afhængig af konfigureret editor og tekstfiltre, kan Joomla fjerne bestemte elementer eller attributter når indhold gemmes.

Hvis dit markup forsvinder, inspektion af editor og filtering konfiguration frem for at gentage at lime det samme kode.

Sidesidebyggeprogrammer

Det samme princip gælder for visuelle sidesidebyggeprogrammer: brug deres HTML, CSS og JavaScript integrationsmuligheder.

For dynamisk indlæst indhold, initialiser event listeners først efter relevante elementer eksisterer.

Hvis en side indeholder flere bokse, giv hver en unik ID.

11. Test din modal før publicering

En boks der ser korrekt ud på skrivebordet kan stadig have brugbarhedsproblemer.

Test den med en mus, tastatur og mobilenhed.

Test Forventet resultat
Klik åbnings-knap Boksen vises
Tryk Tab Fokus forbliver inden for modalens kontroller
Tryk Shift + Tab Omvendt tastaturnavigation fungerer
Tryk Escape Boksen lukkes når tilladt
Klik Luk eller Annuller Boksen lukkes
Luk boksen Fokus returnerer passende
Åben på mobil Indhold forbliver læsbar og rulbar
Indsend ugyldig formular Valideringsfeedback er synlig
Indsend gyldig formular Application håndterer dataene korrekt
Brug en skælmlæser Boksen har et forståeligt navn

W3C's WCAG teknik H102 giv nyttig vejledning for at validere native modal adfærd.

12. Hvornår bør du bruge en dialog frem for et plugin?

En native dialog er særligt egnet til små, fokuserede interaktioner: bekræftelser, information paneler og simple formularer.

For mere komplekse behov, såsom trin-for-trin workshops, avancerede gallerier, eller dialoger dybtdede med en CMS arbejdsgang, kan et dedikeret komponent eller extension stadig være den mere vedligeholdelsesvenlige mulighed.

Fordelen ved den native tilgang er, at den leverer en solid browser-støttet foundation uden at introducere en anden JavaScript-afhængighed.

Det reducerer mængden af custom fokus og keyboard management du skal implementere selv.

Konklusion: start med browserens indbyggede muligheder

En modalboks skal ikke kræve et stort JavaScript library.

Den native HTML <dialog> element leverer en effektiv foundation for tilgængelige popups, bekræftelsesbeskeder og formularer.

Med showModal(), close(), method="dialog", og få CSS-regler, kan du oprette en interface der fungerer på moderne browsere samtidigt med at benefitter fra indbygget fokus og keyboard adfærd.

For WordPress, Joomla, og custom PHP hjemmesider, dette kan være en effektiv alternative til at installere et andet plugin til en relativt simpel interaktion.

Nøglen er at bruge den native adfærd korrekt, klare kontroller, og teste resultatet med reel tastatur og mobile interaktioner.

Offentlige og tekniske referencer