Web ve Geliştirme

HTML, CSS ve JavaScript ile Erişilebilir Modal Diyaloglar Nasıl Oluşturulur

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

Yerel HTML dialog öğesini kullanarak erişilebilir modal diyaloglar oluşturun. Pop-up'ları açıp kapatmayı, klavye odaklamasını yönetmeyi, arka planları stillendirmeyi ve JavaScript kütüphanesi olmadan onay diyalogları oluşturmayı öğrenin.

Bir ziyaretçi web sitenizdeki bir düğmeye tıklar. Bir form, bir onay mesajı veya ek bilgi içeren bir açılır pencere belirir.

Görsel açılır pencereyi oluşturmak kolaydır. Onu bir klavye, bir ekran okuyucu ve bir mobil tarayıcı ile doğru şekilde çalıştırmak ise bambaşka bir meseledir.

Birçok özel modal uygulaması, odağı yönetmek, sayfa ile etkileşimi engellemek ve Escape tuşunu işlemek için büyük miktarda JavaScript'e dayanır.

Modern HTML daha basit bir yaklaşım sunar: yerel <dialog> öğesi.

Modal bir iletişim kutusundan beklenen davranışların çoğunu doğrudan tarayıcı içinde sağlar. Bir çerçeve veya eklenti yüklemeden, az miktarda HTML, CSS ve JavaScript ile işlevsel bir açılır pencere oluşturabilirsiniz.

Bu öğreticide, yeniden kullanılabilir bir modal oluşturacağız, ona stil vereceğiz, bir onay iletişim kutusu ekleyeceğiz ve gerçek web sitelerinde önemli olan erişilebilirlik ayrıntılarını inceleyeceğiz.

1. Modal bir iletişim kutusunu sıradan bir açılır pencereden farklı kılan nedir?

Modal bir iletişim kutusu, ziyaretçinin ana sayfaya dönmeden önce arayüzün belirli bir bölümüyle etkileşime girmesini geçici olarak gerektirir.

Tipik örnekler şunlardır:

  • Bir öğenin silinmesini onaylama.
  • Bir iletişim formu gösterme.
  • Bir sayfadan ayrılmadan önce onay isteme.
  • Ek ürün bilgisi gösterme.
  • Bir uygulama ayarını düzenleme.

Doğru şekilde uygulanmış bir modal, amacını açıkça belirtmeli, onu kapatmanın belirgin bir yolunu sunmalı ve klavye odağını uygun şekilde yönetmelidir.

Yerel <dialog> öğesi hem modal hem de modal olmayan davranışı destekler.

Yöntem Davranış
showModal() Bir modal açar ve belgenin geri kalanını etkisiz hale getirir
show() Modal olmayan bir iletişim kutusu açar
close() İletişim kutusunu kapatır
method="dialog" Bir form düğmesinin iletişim kutusunu kapatmasına izin verir

Modal davranışı, tarayıcı tarafından sağlanan odak yönetimini ve klavye etkileşimini içerir.

2. İlk HTML modalınızı oluşturun

Basit bir örnekle başlayalım: bir başlık, biraz metin ve bir kapatma düğmesi içeren bir iletişim kutusu açan bir düğme.

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

İşlevsel bir modal iletişim kutusu oluşturmak için bu kadarı yeterlidir.

Ziyaretçi düğmeye tıkladığında, showModal() iletişim kutusunu sayfa içeriğinin üzerinde açar.

Tarayıcı birkaç önemli davranışı otomatik olarak yönetir:

  • İletişim kutusu, sıradan sayfa içeriğinin üzerine, üst katmana girer.
  • Belgenin geri kalanı etkisiz hale gelir.
  • Klavye odağı iletişim kutusunun içine taşınır.
  • Escape tuşuna basmak normalde onu kapatır.
  • İletişim kutusu kapandığında odak normalde açan düğmeye geri döner.

Kapatma düğmesi method="dialog" kullanır, bu nedenle bir JavaScript olay işleyicisi gerektirmez.

3. İletişim kutusuna CSS ile stil verin

Varsayılan iletişim kutusu çalışır, ancak görünümü basittir.

Ona yuvarlatılmış köşeler, rahat boşluklar, duyarlı bir genişlik ve bir arka plan katmanı verebiliriz.

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 sözde öğesi, modal bir iletişim kutusunun arkasındaki katmana stil verir.

Yalnızca iletişim kutusu showModal() gibi bir yöntemle modally olarak görüntülendiğinde görünür.

show() ile açılan bir iletişim kutusu, aynı modal arka plan katmanı davranışını otomatik olarak almaz.

Neden üst katmanı kullanmalısınız?

Geleneksel özel açılır pencereler genellikle giderek büyüyen z-index değerlerine dayanır.

showModal() ile açılan bir modal iletişim kutusu, tarayıcının üst katmanına girer; bu da birçok yığın bağlamı sorununu önler.

Bu, özellikle yapışkan başlıklar, kayan bileşenler ve karmaşık sayfa oluşturucular içeren web sitelerinde faydalıdır.

4. Klavye erişilebilirliğini anlayın

Bir modal, fare olmadan çalışmalıdır.

Ziyaretçinin web sitenizde Tab tuşunu kullanarak gezindiğini düşünün. Bir modal açıldığında, yanlışlıkla arkasındaki sayfaya geçmeden kontrolleriyle etkileşime girebilmelidir.

Yerel modal iletişim kutusu bu davranışta yardımcı olur.

W3C, HTML dialog öğesini, iletişim kutusu kapandığında odak sınırlaması ve odağın geri dönmesi dahil olmak üzere erişilebilir modal iletişim kutuları oluşturmak için bir teknik olarak tanımlar.

İletişim kutusuna erişilebilir bir ad verin

Görünür bir başlık kullanın ve aria-labelledby ile ona başvurun:

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

Bu, yardımcı teknolojilere iletişim kutusu için anlamlı bir ad verir.

Başlangıç odağını dikkatlice seçin

autofocus özniteliği, modal açıldığında odağı alması gereken kontrolü belirtebilir.

Bilgilendirici bir iletişim kutusu için kapatma düğmesine odaklanmak uygun olabilir.

Illustration of the article's main concept

Bir form için, ilk girdiye odaklanmak daha anlamlı olabilir.

Yıkıcı bir onay için, İptal gibi daha güvenli eyleme odaklanmak genellikle tercih edilir.

tabindex özniteliğini doğrudan <dialog> öğesinin üzerine yerleştirmekten kaçının; HTML spesifikasyonu bu özniteliği öğenin kendisinde yasaklar.

Her zaman görünür bir kapatma düğmesi sağlayın

Escape normalde bir modal iletişim kutusunu kapatsa da, görünür bir kapatma kontrolü esastır.

Mobil ziyaretçilerin fiziksel bir klavyesi olmayabilir ve bazı kullanıcılar Escape'in bir açılır pencereyi kapatabileceğini bilmeyebilir.

5. İki düğmeli bir onay iletişim kutusu oluşturun

Şimdi daha kullanışlı bir örnek oluşturalım: kayıtlı bir öğenin silinmesini onaylama.

Ziyaretçi İptal veya Sil seçeneklerini seçebilmelidir.

HTML, method="dialog" ve iletişim kutusunun returnValue özelliği aracılığıyla uygun bir mekanizma sağlar.

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

Önemli ayrıntı şudur: bir method="dialog" formu içindeki bir düğmeye tıklamak iletişim kutusunu kapatır ve returnValue değerini ayarlar.

Kodumuz, kullanıcının confirm seçip seçmediğini kontrol eder.

Değeri açmadan önce sıfırlamak, kullanıcı iletişim kutusunu Escape ile kapatırsa önceki bir onayın yeni bir onayla karıştırılmasını önler.

Örnek, kasıtlı olarak hiçbir şeyi silmez. Gerçek bir uygulamada, onaylanan eylem, gerekli yetkilendirme ve CSRF korumalarıyla kendi PHP uç noktanızı veya uygulama denetleyicinizi çağıracaktır.

6. Onay iş akışını test edin

Kullanışlı bir gösterim, her biri bir Sil düğmesi içeren kayıtlı öğe listesidir. Sil'e tıklamak bir onay iletişim kutusu açmalıdır. İptal, öğeye dokunmadan bırakmalıdır; Onayla yalnızca seçilen öğeyi kaldırmalıdır.

Bu, gerçek web sitesi verilerini değiştirmeden onay akışını gösterir.

7. Bir iletişim kutusunun içine iletişim formu ekleyin

Bir iletişim formu başka yaygın bir kullanım durumudur.

Ancak bir iletişim kutusunu kapatmak ile verileri bir sunucuya göndermek arasında önemli bir fark vardır.

method="dialog" içeren bir form açılır pencereyi kapatır. PHP arka ucunuza geleneksel bir HTTP isteği göndermez.

Gerçek bir iletişim formu için normal bir form gönderimi veya bir AJAX isteği kullanın.

Örneğin:

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

Gönder düğmesi formu normal şekilde gönderir.

İptal düğmesi, formu göndermeden iletişim kutusunu kapatmalıdır:

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

PHP işleyiciniz yine de gönderilen verileri doğrulamalı, istenmeyen iletişim koruması uygulamalı ve anlamlı bir başarı veya hata yanıtı döndürmelidir.

Bir modal iletişim kutusu arayüzü iyileştirir; sunucu tarafı form güvenliğinin yerini almaz.

8. Kullanıcılar iletişim kutusunu dışarıya tıklayarak kapatabilir mi?

Birçok web sitesi, ziyaretçilerin bir açılır pencereyi arka plan katmanına tıklayarak kapatmasına izin verir.

Bu davranış genellikle light dismiss (hafif kapatma) olarak adlandırılır.

Modern HTML, bir iletişim kutusunun dış etkileşim, platform kapatma istekleri veya açık kontroller aracılığıyla kapatılıp kapatılamayacağını belirtebilen closedby özniteliğini içerir.

Örneğin:

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

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

closedby="any" değeri, bunu destekleyen tarayıcılarda light-dismiss davranışına izin verir.

Ancak, daha yeni iletişim kutusu özellikleri için destek, hedef tarayıcılarınıza karşı kontrol edilmelidir. Temel showModal() ve close() API'leri daha geniş çapta yerleşmiştir.

Kritik onay iletişim kutuları için, yanlışlıkla dışarıya tıklayarak kapatma istenmeyebilir.

Tüm durumlarda, görünür bir kapatma veya iptal kontrolü bulundurun.

9. Bu yaygın uygulama hatalarından kaçının

Technical workflow illustration

open özniteliğini ekleyerek bir modalı açmak

Bu kod:

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

şununla aynı davranışı sağlamaz:

dialog.showModal();

open özniteliği iletişim kutusunu modal olmayan şekilde görüntüler. Belgenin geri kalanını otomatik olarak etkisiz hale getirmez.

Gerçek bir modal gerektiğinde showModal() kullanın.

Bir modalı kapatmak için open özniteliğini kaldırmak

Aktif bir modaldan open özniteliğini manuel olarak kaldırmaktan kaçının.

Şunu kullanın:

dialog.close();

Bu, amaçlanan yaşam döngüsünü izler ve uygun kapatma davranışını sağlar.

Düğme yerine bir bağlantı kullanmak

Bir arayüz eylemini açan kontrol genellikle bir düğme olmalıdır:

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

Başka bir kaynağa gezinme için bağlantılar kullanın.

Odak görünürlüğünü unutmak

Klavye ile gezinen kullanıcılar, hangi kontrolün etkin olduğuna dair görünür bir işarete ihtiyaç duyar.

Tarayıcı odak ana hatlarını yerine yenisini koymadan kaldırmak yerine, net bir :focus-visible stili koruyun.

İletişim kutusunu gizli bir kapsayıcının içine yerleştirmek

Bir üst kapsayıcı gizliyse veya bir CMS çevreleyen işaretlemeyi dinamik olarak değiştiriyorsa, iletişim kutusu beklenmedik şekilde davranabilir.

Sayfa oluşturucu entegrasyonları için, kararlı bir kapsayıcı tercih edin ve JavaScript'in iletişim kutusu belgeye yerleştirildikten sonra çalıştığından emin olun.

10. Bir iletişim kutusunu WordPress veya Joomla'ya entegre edin

Yerel dialog öğesini kullanmak için yalnızca bir eklenti oluşturmanız gerekmez.

Basit bir web sitesi için entegrasyon üç bölümden oluşur:

Bölüm Nereye gider
HTML işaretlemesi Özel HTML bloğu, modül, şablon veya sayfa oluşturucu öğesi
CSS Tema veya şablon özel CSS'i
JavaScript Tema/şablon özel JavaScript'i veya desteklenen bir kod enjeksiyonu özelliği

WordPress

WordPress'te, hesabınız ve düzenleyici yapılandırmanız gerekli işaretlemeye izin verdiği sürece HTML'i bir Özel HTML bloğuna yerleştirebilirsiniz.

Stili, temanızın desteklediği özel CSS mekanizması aracılığıyla ekleyin.

JavaScript için, tema destekli bir komut dosyası alanı, bir alt tema veya JavaScript'i doğru şekilde işleyen saygın bir kod ekleme eklentisi kullanın.

Bazı düzenleyiciler ve güvenlik yapılandırmaları <script> öğelerini filtreler. Bir içerik bloğuna doğrudan yapıştırılan JavaScript'in çalışacağını varsaymaktan kaçının.

Joomla

Joomla'da, bir Özel modül veya uygun HTML işaretlemesine izin veren bir düzenleyici iletişim kutusunu içerebilir.

CSS'i, Cassiopeia tabanlı bir sitede user.css gibi, şablonunuzun özel stil sayfasına ekleyin.

JavaScript'i şablonun desteklediği özel komut dosyası konumuna veya uygun bir eklenti aracılığıyla yerleştirin.

Yapılandırılan düzenleyiciye ve metin filtrelerine bağlı olarak, Joomla içerik kaydedildiğinde belirli öğeleri veya öznitelikleri kaldırabilir.

İşaretlemeniz kaybolursa, aynı kodu tekrar tekrar yapıştırmak yerine düzenleyiciyi ve filtreleme yapılandırmasını inceleyin.

Sayfa oluşturucular

Aynı ilke görsel sayfa oluşturucular için de geçerlidir: onların HTML, CSS ve JavaScript entegrasyon yeteneklerini kullanın.

Dinamik olarak yüklenen içerik için, olay dinleyicilerini yalnızca ilgili öğeler mevcut olduktan sonra başlatın.

Bir sayfa birden fazla iletişim kutusu içeriyorsa, her birine benzersiz bir kimlik (ID) verin.

11. Yayınlamadan önce modalınızı test edin

Masaüstünde doğru görünen bir iletişim kutusu yine de kullanılabilirlik sorunlarına sahip olabilir.

Onu bir fare, klavye ve mobil cihazla test edin.

Test Beklenen sonuç
Açan düğmeye tıkla İletişim kutusu belirir
Tab'a bas Odak modalın kontrolleri içinde kalır
Shift + Tab'a bas Ters klavye gezinmesi çalışır
Escape'e bas İzin verildiğinde iletişim kutusu kapanır
Kapat veya İptal'e tıkla İletişim kutusu kapanır
İletişim kutusunu kapat Odak uygun şekilde geri döner
Mobilde aç İçerik okunabilir ve kaydırılabilir kalır
Geçersiz form gönder Doğrulama geri bildirimi görünür
Geçerli form gönder Uygulama verileri doğru şekilde işler
Bir ekran okuyucu kullan İletişim kutusunun anlaşılır bir adı vardır

W3C'nin WCAG H102 tekniği, yerel modal davranışını doğrulamak için faydalı rehberlik sağlar.

12. Bir iletişim kutusunu ne zaman bir eklenti yerine kullanmalısınız?

Yerel bir iletişim kutusu, küçük ve odaklanmış etkileşimler için özellikle uygundur: onaylar, bilgi panelleri ve basit formlar.

Daha karmaşık ihtiyaçlar için, örneğin çok adımlı sihirbazlar, gelişmiş galeriler veya bir CMS iş akışıyla derinlemesine entegre edilmiş iletişim kutuları için, özel bir bileşen veya eklenti hâlâ daha sürdürülebilir bir seçenek olabilir.

Yerel yaklaşımın avantajı, başka bir JavaScript bağımlılığı getirmeden sağlam, tarayıcı destekli bir temel sağlamasıdır.

Ayrıca, kendiniz uygulamanız gereken özel odak ve klavye yönetimi miktarını da azaltır.

Sonuç: tarayıcının yerleşik yetenekleriyle başlayın

Bir modal iletişim kutusu, büyük bir JavaScript kitaplığı gerektirmek zorunda değildir.

Yerel HTML <dialog> öğesi, erişilebilir açılır pencereler, onay mesajları ve formlar için etkili bir temel sağlar.

showModal(), close(), method="dialog" ve birkaç CSS kuralıyla, yerleşik odak ve klavye davranışından yararlanırken modern tarayıcılar genelinde çalışan bir arayüz oluşturabilirsiniz.

WordPress, Joomla ve özel PHP web siteleri için, bu, nispeten basit bir etkileşim için başka bir eklenti yüklemeye karşı verimli bir alternatif olabilir.

Anahtar, yerel davranışı doğru şekilde kullanmak, net kontroller sağlamak ve sonucu gerçek klavye ve mobil etkileşimlerle test etmektir.

Resmi ve teknik referanslar