Örnek Erişilebilirlik Düzeltme Raporu. Harbor & Pine, yaygın erişilebilirlik kusurları içerecek şekilde kurguladığımız ve ardından web sitenizi tarayan motorun aynısıyla test ettiğimiz hayali bir mağazadır.

Web sitenizi ücretsiz tarayın

Örnek: Erişilebilirlik Düzeltme Raporu

harborandpine.example

Platform:
Shopify
Oluşturulma tarihi:
24 Eyl 2026
Test edilen sayfalar:
9
Test motoru:
axe-core 4.13.0

Özet

  • 24 Eyl 2026 tarihinde harborandpine.example sitesinden 9 sayfa (bunların 4 tanesi site haritanızdan) axe-core 4.13.0 ile WCAG 2.2 A ve AA kriterlerine göre test ettik; ayrıca yalnızca klavyeyle bir alışveriş testi yaptık.
  • 8 sorun türü otomatik WCAG testlerinde başarısız oldu (131 tekrar). 8 tanesi Önce düzeltin olarak işaretlendi.
  • Yolculuk engellendiYalnızca klavye kullanan bir alışverişçi şu adımlarda takılıyor: Seçenekleri ve adedi belirleme.
  • 4 madde insan kontrolü gerektiriyor: otomatik testler bunları işaretledi ama karar veremedi.
  • Şunlarla başlayın: Klavye odağı çerez bildiriminde hapsoluyor; Ürün seçenekleri klavyeyle seçilemiyor; Butonların ayırt edilebilir bir metni olmalıdır.

Otomatik testler bir sitedeki erişilebilirlik sorunlarının tamamını değil, bir kısmını bulur. Bu rapor testlerimizin neler bulduğunu ve bunların nasıl düzeltileceğini açıklar. Hukuki tavsiye değildir; ADA, Avrupa Erişilebilirlik Yasası veya herhangi bir yasayla uyumluluğu belgelemez.

Genel bakış

P1 · Önce düzeltinTemel sayfalarda ziyaretçileri engelliyor
8
P2 · Sonra düzeltinCiddi veya orta düzeyde engeller
0
P3 · İyileştirinKüçük sorunlar ve iyi uygulamalar
2

Önem derecesine göre tekrarlar

Kritik
73
Ciddi
58
Orta
25
Küçük
0
Doğrulanmış hatalarOtomatik bir testin başarısız olduğu sorun türleri
10
İnceleme gerekliİşaretlendi, ancak karar için bir insan gerekli
4
Başarılı kontrollerHata bulunmayan otomatik kurallar
32
Test edilmediYolculuk adımları ve manuel kontroller
7

9 sayfa test ettik; bunların 4 tanesi site haritanızdan seçildi. Hedef tarihler önem derecesine dayalı önerilerdir; kesin tarihleri geliştiricinizle birlikte belirleyin.

Web sitesine genel bakış

Test edilen sayfalardaki herkese açık kanıtlardan tespit edildi. Etiket yanlış olabilir; yalnızca hangi ek kontrollerin çalışacağını belirler.

Web sitesi türü

  • Online mağazaYüksek güven
    • Bir mağaza platformu olan Shopify üzerinde çalışıyor
    • Sepete giden bağlantı
    • Ürün veya mağaza bağlantıları
  • Açılış sayfasıOrta güven
    • Yalnızca 6 iç sayfaya bağlantı var

Tespit edilen teknolojiler

  • ShopifyYüksek güven

    Sayfada Shopify dosyaları veya script’leri

Bu site için kontroller

  • Genel kontroller: erişilebilirlik, SEO, hız, güvenlik ve e-posta
  • E-ticaret modülü: koleksiyon, ürün ve sepet sayfaları ile ödeme butonuna kadar klavyeyle alışveriş yolculuğu
  • Shopify notları: tema ve yönetici paneli düzeltme adımları; platformun yönettiği başlıklar ve çerezler bilgi amaçlı gösterilir

Klavyeyle alışveriş yolculuğu

Fare kullanamayan kişiler gibi yalnızca klavyeyle (Tab, Shift+Tab, Enter, Space, Escape) alışveriş yapmayı denedik. Tek kullanımlık bir oturumda sepete bir ürün ekler ve ödeme butonunda dururuz: ödeme sayfasına asla girmez, kişisel veya ödeme bilgisi yazmayız. Hedef: Yalnızca klavye kullanarak ana sayfadan ödeme butonuna ulaşmak.

  1. 01Ana menüye ulaşma

    Başarılı

    21 Tab basışından sonra odak, gezinme menüsündeki “Shop” öğesine ulaştı.

    Beklenen: Ana sayfanın en üstünden Tab tuşuna basıldığında ana menüdeki bağlantılara ulaşılır.

    • Not: Bir çerez bildirimi, “Accept all” butonunda Enter tuşuna basana kadar klavye odağını tuttu.
    Nasıl yeniden oluşturulur

    https://harborandpine.example/

    1. Ana sayfayı açın.
    2. Tarayıcının adres çubuğuna tıklayın, ardından Tab tuşuna art arda basın (Shift+Tab geri gider).

    Gözlemlediğimiz odak sırası

    “Shop”

  2. 02Bir koleksiyondan ürün açma

    Başarılı

    9 Tab basışından sonra odak “Trail Daypack 22L” öğesine ulaştı ve Enter /products/trail-daypack sayfasını açtı.

    Beklenen: Tab ile koleksiyon ızgarasındaki bir ürüne ulaşılır ve Enter ürünün sayfasını açar.

    Nasıl yeniden oluşturulur

    https://harborandpine.example/collections/all

    1. /collections/all adresini açın.
    2. Izgaradaki bir ürün vurgulanana kadar Tab tuşuna basın, ardından Enter tuşuna basın.

    Gözlemlediğimiz odak sırası

    “Harbor & Pine” → “Shop” → “New arrivals” → “Our story” → body > header.site > div.icons > button → “Account” → body > header.site > div.icons > a → “FeaturedPrice, low to highPrice, high to low” → “Trail Daypack 22L”

  3. 03Seçenekleri ve adedi belirleme

    Başarısız

    3 ürün seçeneği klavye odağı alamıyor: “S”, “M”, “L”. Seçenekler fareyle çalışıyor, ancak klavye kullanıcısı bunları seçemez.

    Beklenen: Her ürün seçeneğine (beden, renk, varyant) ve adet alanına Tab ile ulaşılabilir.

    2.1.1 Keyboard · Güven düzeyi: yüksek

    Seçenekleri ve adedi belirleme: başarısız olan öğe, çerçeve içinde
    Seçenekleri ve adedi belirleme: başarısız olan öğe, çerçeve içinde
    Nasıl yeniden oluşturulur

    https://harborandpine.example/products/trail-daypack

    1. /products/trail-daypack adresini açın.
    2. Sayfanın en üstünden Tab tuşuna basın ve Sepete ekle butonundan önce hangi kontrollerin odak aldığını not edin.

    Gözlemlediğimiz odak sırası

    “Harbor & Pine” → “Shop” → “New arrivals” → “Our story” → … 5 öğe daha … → body > header.site > div.icons > a → div.page.product > div.gallery > div.thumbs > button → div.page.product > div.gallery > div.thumbs > button → div.page.product > div.gallery > div.thumbs > button → div.page.product > div > div.swatches > button → div.page.product > div > div.swatches > button → div.page.product > div > div.swatches > button → “1” → “Add to cart”

    Öğe
    <div class="size-option" data-fr="opt-1">S</div>
  4. 04Klavyeyle sepete ekleme

    İnceleme gerekli

    Sepete ekle butonunda Enter çalıştı (üst bilgideki sepet sayısı değişti, “sepete eklendi” mesajı göründü); ancak bir durum mesajı veya odak alan bir iletişim kutusu bulamadık, bu yüzden ekran okuyucu kullanıcıları ürünün eklendiğini duymayabilir.

    Beklenen: Sepete ekle butonunda Enter ürünü sepete ekler ve onay duyurulur: bir durum mesajı, odağı alan bir iletişim kutusu veya sepet sayfası.

    4.1.3 Status Messages · Güven düzeyi: orta

    Klavyeyle sepete ekleme: bu adımdaki sayfa
    Klavyeyle sepete ekleme: bu adımdaki sayfa
    Nasıl yeniden oluşturulur

    https://harborandpine.example/products/trail-daypack

    1. /products/trail-daypack adresini açın.
    2. Sepete ekle butonu odak alana kadar Tab tuşuna basın, ardından Enter tuşuna basın.
    3. Bir onayın duyurulup duyurulmadığını ekran okuyucuyla dinleyin (VoiceOver: Cmd+F5).
  5. 05Sepeti değiştirme ve ödemeye ulaşma

    Başarılı

    4 sepet kontrolünün tamamına ve ödeme butonuna (“Check out”) ulaşıldı (12 Tab basışı). Butona basmadık.

    Beklenen: Adet alanlarının, kaldırma butonlarının ve ödeme butonunun tamamına Tab ile ulaşılabilir.

    Nasıl yeniden oluşturulur

    https://harborandpine.example/cart

    1. Sepete herhangi bir ürün ekleyin ve sepet sayfasını açın.
    2. Tab tuşuna basın ve adet alanlarının, kaldırma butonlarının ve ödeme butonunun odak aldığını kontrol edin.

    Gözlemlediğimiz odak sırası

    “Harbor & Pine” → “Shop” → “New arrivals” → “Our story” → body > header.site > div.icons > button → “Account” → body > header.site > div.icons > a → “1” → tbody > tr > td > button.remove → “2” → tbody > tr > td > button.remove → “Check out”

  6. 06Ödeme

    Test edilmedi

    Ödeme butonunda dururuz: ödeme sayfasına asla girmeyiz, sipariş oluşturmayız veya ödeme bilgisi yazmayız. Shopify’da ödeme sayfalarını temanız değil, Shopify çalıştırır. Ödeme adımını elle kontrol edin (bkz. Manuel kontroller).

İhtarname iddia haritası

İhtarnamedeki her iddia, tarama kanıtlarıyla eşleştirildi. Bu bir olgu karşılaştırmasıdır, hukuki tavsiye değildir.

  • “Images lack alternative text, so product photos are not described.”

    Metin alternatifi olmayan görseller. Test edilen 5 sayfanın 3 tanesinde 10 tekrar.

    image-alt

    Tespit edildi
  • “Text has insufficient color contrast against its background, including sale badges and prices.”

    Düşük renk kontrastı. Test edilen 5 sayfanın 5 tanesinde 16 tekrar.

    color-contrast

    Tespit edildi
  • “The website cannot be navigated using a keyboard alone.”

    Klavye erişimi ve odak. Klavye odağı çerez bildiriminde takılıp kalıyor.

    Tespit edildi
  • “Form fields do not have labels, including the newsletter sign-up and the quantity fields in the cart.”

    Etiketi olmayan form alanları. Test edilen 5 sayfanın 3 tanesinde 4 tekrar.

    select-name, label

    Tespit edildi
  • “Product videos do not have captions.”

    Video ve ses altyazıları. Otomatik taramalar altyazıları değerlendiremez. Her ürün veya marka videosunda doğru altyazılar ve bir metin dökümü olup olmadığını kontrol edin.

    Manuel kontrol
  • “Our client is legally blind and uses screen reader software.”

    Diğer sorunlar. Bu genel bir ifadedir. Temel akışları (arama, ürün sayfası, sepete ekleme, ödeme) VoiceOver veya NVDA gibi bir ekran okuyucuyla test edin.

    Manuel kontrol

Düzeltme planı

Sorumluları ve hedef tarihleriyle birlikte öncelik sırasına göre sorunlar
ÖncelikSorunDurumWCAGTekrar sayısıSorumluHedef tarih
P1Klavye odağı çerez bildiriminde hapsoluyorDoğrulandı2.1.21uygulama sağlayıcısı2026-10-08
P1Ürün seçenekleri klavyeyle seçilemiyorDoğrulandı2.1.11tema geliştiricisi2026-10-08
P1Butonların ayırt edilebilir bir metni olmalıdırDoğrulandı4.1.241tema geliştiricisi2026-10-08
P1Görsellerin alternatif metni olmalıdırDoğrulandı1.1.122içerik editörü2026-10-08
P1Form öğelerinin etiketi olmalıdırDoğrulandı4.1.27tema geliştiricisi2026-10-08
P1Select öğesinin erişilebilir bir adı olmalıdırDoğrulandı4.1.21tema geliştiricisi2026-10-08
P1Bağlantıların ayırt edilebilir bir metni olmalıdırDoğrulandı2.4.4, 4.1.236tema geliştiricisi2026-10-08
P1Öğeler asgari renk kontrastı oranı eşiklerini karşılamalıdırDoğrulandı1.4.322mağaza sahibi (yönetici paneli ayarları)2026-10-08
P3Sayfa içeriğinin tamamı landmark’ların içinde yer almalıdırDoğrulandıİyi uygulama18tema geliştiricisi2026-11-23
P3Başlık seviyeleri yalnızca birer birer artmalıdırDoğrulandıİyi uygulama7tema geliştiricisi2026-11-23

Her sorun nasıl düzeltilir

P1KritikDoğrulanmış hataWCAG 2.1.2

Klavye odağı çerez bildiriminde hapsoluyor

efor: orta · sorumlu: uygulama sağlayıcısı · 2.1.2 No Keyboard Trap

Klavye kullanan biri Tab tuşuna bastığında odak birkaç öğe arasında dönüp duruyor ve sayfanın geri kalanına hiç ulaşmıyor.

Odak hapsolursa yalnızca klavye kullananlar ve ekran okuyucu kullananlar hiç alışveriş yapamaz (WCAG 2.1.2 No Keyboard Trap).

Kanıt

Bulan test
Klavye testi (ana sayfada Tab ile ilerleme)
Durum · güven düzeyi
Doğrulanmış hata · yüksek
Tespit tarihi
24 Eyl 2026 (UTC)
Nerede
1 sayfa genelinde 1 tekrar

Beklenen: Tab tuşuna basmak sayfadaki her etkileşimli öğede sırayla ilerler ve sayfanın geri kalanına geçer.

Gözlemlenen: 40 kez Tab tuşuna basıldıktan sonra odak şu öğeler arasında dönmeye devam etti: Settings, Accept all.

Nasıl yeniden oluşturulur
  1. Ana sayfayı açın.
  2. Adres çubuğuna tıklayın, ardından art arda Tab tuşuna basın.
  3. Odak sürekli aynı birkaç öğeye geri dönüyor.
Hatalı öğeler (6 tanesi gösteriliyor)
button#cc-settings
Settings
button#cc-accept.primary
Accept all
button#cc-settings
Settings
button#cc-accept.primary
Accept all
button#cc-settings
Settings
button#cc-accept.primary
Accept all
Etkilenen sayfalar (1)
  • https://harborandpine.example/

Nasıl düzeltilir

Genel rehberlik
  1. Çerez veya onay bildirimi uygulamanızın ayarlarında bir erişilebilirlik veya odak tuzağı seçeneği olup olmadığına bakın ya da sağlayıcıdan sorunu düzeltmesini isteyin.
  2. Bir modal, odağı yalnızca açıkken içinde tutabilir; Escape tuşuyla kapanmalı ve odağı geldiği yere geri vermelidir.
Yapay zekâyla düzeltinPrompt’u göster

Bunu tema dosyanızla birlikte ChatGPT, Claude, Cursor veya Copilot’a yapıştırın. Yayınlamadan önce değişikliği gözden geçirin.

harborandpine.example adresinde bir Shopify mağazası (Online Store 2.0 teması, Liquid şablonları) yönetiyorum. Bir erişilebilirlik testi bu sorunu buldu ve bunu temamda düzeltmek istiyorum.

Sorun: Klavye odağı çerez bildiriminde hapsoluyor (WCAG 2.1.2).
Nerede: 1 sayfada 1 tekrar, örneğin /.

Hatalı öğelerden biri, tarayıcının oluşturduğu haliyle:
```html
Settings
```

Neden önemli: Odak hapsolursa yalnızca klavye kullananlar ve ekran okuyucu kullananlar hiç alışveriş yapamaz (WCAG 2.1.2 No Keyboard Trap).

Neyin değişmesi gerekiyor:
- Çerez veya onay bildirimi uygulamanızın ayarlarında bir erişilebilirlik veya odak tuzağı seçeneği olup olmadığına bakın ya da sağlayıcıdan sorunu düzeltmesini isteyin.
- Bir modal, odağı yalnızca açıkken içinde tutabilir; Escape tuşuyla kapanmalı ve odağı geldiği yere geri vermelidir.

Yanıtınız için kurallar:
- Yapılacak değişikliği birebir, önce ve sonra hali olarak gösterin ve değişikliğin hangi dosyaya veya ayara yapılacağını belirtin. Önce dosyamı görmeniz gerekiyorsa yapıştırmamı isteyin.
- Görsel tasarımı ve mevcut tüm davranışları aynı bırakın.
- Ürün adı, fiyat veya metin uydurmayın; benim doldurabileceğim yer tutucular kullanın.
- Sonunda düzeltmeyi kendim nasıl kontrol edebileceğimi anlatın.
- Bunun klavyeyle ve bir ekran okuyucuyla nasıl doğrulanacağını da ekleyin.

Düzeltmenizi kontrol edin

  • Ana sayfayı yükleyin, art arda Tab tuşuna basın ve odağın ana menüye ve içeriğe ulaştığını doğrulayın.

Otomatik bir klavye testiyle tespit edildi; elle doğrulayın.

P1KritikDoğrulanmış hataWCAG 2.1.1

Ürün seçenekleri klavyeyle seçilemiyor

efor: orta · sorumlu: tema geliştiricisi · 2.1.1 Keyboard

Beden, renk veya varyant seçenekleri fareye yanıt veriyor ama klavye odağı alamıyor; bu yüzden klavye kullananlar bir varyant seçemiyor.

Ekran okuyucu kullananların birçoğu dahil, yalnızca klavye kullanan müşteriler bu adımı geçemiyor (WCAG 2.1.1).

Kanıt

Bulan test
Klavye yolculuğu
Durum · güven düzeyi
Doğrulanmış hata · yüksek
Tespit tarihi
24 Eyl 2026 (UTC)
Nerede
1 sayfa genelinde 1 tekrar

Beklenen: Her ürün seçeneğine (beden, renk, varyant) ve adet alanına Tab ile ulaşılabilir.

Gözlemlenen: 3 ürün seçeneği klavye odağı alamıyor: “S”, “M”, “L”. Seçenekler fareyle çalışıyor, ancak klavye kullanıcısı bunları seçemez.

Ürün seçenekleri klavyeyle seçilemiyor: çerçeve içine alınmış öğe
Ürün seçenekleri klavyeyle seçilemiyor: çerçeve içine alınmış öğe
Nasıl yeniden oluşturulur
  1. /products/trail-daypack adresini açın.
  2. Sayfanın en üstünden Tab tuşuna basın ve Sepete ekle butonundan önce hangi kontrollerin odak aldığını not edin.
Hatalı öğeler (1 tanesi gösteriliyor)
(ekran görüntüsüne bakın)
<div class="size-option" data-fr="opt-1">S</div>
Etkilenen sayfalar (1)
  • https://harborandpine.example/products/trail-daypack

Nasıl düzeltilir

Genel rehberlik
  1. Seçenek seçicileri görünür etiketli yerel radyo butonlarından (veya bir <select> öğesinden) oluşturun; etiketi renk örneği gibi biçimlendirin.
  2. Özel öğeleri korursanız her seçeneğin tabindex="0", bir role="radiogroup" içinde aria-checked ile role="radio" ve ok tuşları ile Space desteğine ihtiyacı vardır. Yerel radyo butonları bunların hepsini kendiliğinden sağlar.

Kod

Geliştiriciniz için uygulama örnekleri. Temanızın kaynak koduna sahip olmadığımız için dosya konumları kesin yollar değil, ipuçlarıdır.

Önce · bulduğumuz · Temanızın ürün formu (varyant seçici)
<div class="size-option" data-fr="opt-1">S</div>
Sonra · uyarlanacak örnek
<fieldset class="variant-picker">
  <legend>Size</legend>
  <input type="radio" id="size-s" name="Size" value="S" class="visually-hidden">
  <label for="size-s" class="size-option">S</label>
  <input type="radio" id="size-m" name="Size" value="M" class="visually-hidden">
  <label for="size-m" class="size-option">M</label>
</fieldset>

Her seçenek, Tab ile ulaşılabilen ve ok tuşlarıyla değiştirilebilen gerçek bir radyo butonudur; etiket renk örneği stilinizi korur. Kendi seçenek adlarınızı ve değerlerinizi kullanın.

Yapay zekâyla düzeltinPrompt’u göster

Bunu tema dosyanızla birlikte ChatGPT, Claude, Cursor veya Copilot’a yapıştırın. Yayınlamadan önce değişikliği gözden geçirin.

harborandpine.example adresinde bir Shopify mağazası (Online Store 2.0 teması, Liquid şablonları) yönetiyorum. Bir erişilebilirlik testi bu sorunu buldu ve bunu temamda düzeltmek istiyorum.

Sorun: Ürün seçenekleri klavyeyle seçilemiyor (WCAG 2.1.1).
Nerede: 1 sayfada 1 tekrar, örneğin /products/trail-daypack.

Hatalı öğelerden biri, tarayıcının oluşturduğu haliyle:
```html
<div class="size-option" data-fr="opt-1">S</div>
```

Neden önemli: Ekran okuyucu kullananların birçoğu dahil, yalnızca klavye kullanan müşteriler bu adımı geçemiyor (WCAG 2.1.1).

Neyin değişmesi gerekiyor:
- Seçenek seçicileri görünür etiketli yerel radyo butonlarından (veya bir <select> öğesinden) oluşturun; etiketi renk örneği gibi biçimlendirin.
- Özel öğeleri korursanız her seçeneğin tabindex="0", bir role="radiogroup" içinde aria-checked ile role="radio" ve ok tuşları ile Space desteğine ihtiyacı vardır. Yerel radyo butonları bunların hepsini kendiliğinden sağlar.

Önerilen değişiklik (Temanızın ürün formu (varyant seçici)):
```html
<fieldset class="variant-picker">
  <legend>Size</legend>
  <input type="radio" id="size-s" name="Size" value="S" class="visually-hidden">
  <label for="size-s" class="size-option">S</label>
  <input type="radio" id="size-m" name="Size" value="M" class="visually-hidden">
  <label for="size-m" class="size-option">M</label>
</fieldset>
```

Yanıtınız için kurallar:
- Yapılacak değişikliği birebir, önce ve sonra hali olarak gösterin ve değişikliğin hangi dosyaya veya ayara yapılacağını belirtin. Önce dosyamı görmeniz gerekiyorsa yapıştırmamı isteyin.
- Görsel tasarımı ve mevcut tüm davranışları aynı bırakın.
- Ürün adı, fiyat veya metin uydurmayın; benim doldurabileceğim yer tutucular kullanın.
- Sonunda düzeltmeyi kendim nasıl kontrol edebileceğimi anlatın.
- Bunun klavyeyle ve bir ekran okuyucuyla nasıl doğrulanacağını da ekleyin.

Düzeltmenizi kontrol edin

  • Yeniden oluşturma adımlarını yalnızca klavyeyle tekrarlayın.
  • Bu rapordan bir yeniden test isteyin: yolculuk yeniden çalışır.
P1KritikDoğrulanmış hataWCAG 4.1.2

Butonların ayırt edilebilir bir metni olmalıdır

efor: hızlı · sorumlu: tema geliştiricisi · 4.1.2 Name, Role, Value

Bazı butonların erişilebilir bir adı yok; bu yüzden ekran okuyucu kullananlar yalnızca “düğme” sözcüğünü duyuyor.

WCAG 4.1.2, her kontrolün bir adı olmasını ister. Adı olmayan butonlar arasında çoğu zaman adet artırma/azaltma butonları, kapatma butonları ve slider okları bulunur.

Kanıt

Bulan test
axe-core otomatik kuralı
Durum · güven düzeyi
Doğrulanmış hata · yüksek
Tespit tarihi
24 Eyl 2026 (UTC)
Nerede
9 sayfa genelinde 41 tekrar

Beklenen: Butonların ayırt edilebilir bir metni olmalıdır

Gözlemlenen: Öğenin ekran okuyuculara görünür bir iç metni yok. aria-label özniteliği yok ya da boş. aria-labelledby özniteliği yok ya da var olmayan veya boş öğelere başvuruyor. Öğenin title özniteliği yok. Öğenin örtük (öğeyi saran) bir <label> öğesi yok. Öğenin açıkça ilişkilendirilmiş bir <label> öğesi yok. Öğenin varsayılan anlamı role="none" veya role="presentation" ile geçersiz kılınmamış.

Butonların ayırt edilebilir bir metni olmalıdır: / sayfasında çerçeve içine alınmış öğe
Butonların ayırt edilebilir bir metni olmalıdır: / sayfasında çerçeve içine alınmış öğe
Butonların ayırt edilebilir bir metni olmalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Butonların ayırt edilebilir bir metni olmalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Nasıl yeniden oluşturulur
  1. https://harborandpine.example/ adresini Chrome veya Edge’de açın.
  2. DevTools’u (F12) açıp Öğeler (Elements) sekmesine gidin, Ctrl+F (Mac’te Cmd+F) tuşlarına basın ve şunu arayın: .icons > button[type="button"]
  3. DevTools’un Erişilebilirlik (Accessibility) bölmesinde öğenin hesaplanan adı (Name) boş görünür.
  4. Ya da sayfada ücretsiz axe DevTools tarayıcı eklentisini çalıştırın: bunu “button-name” olarak raporlar.
Hatalı öğeler (4 tanesi gösteriliyor)
.icons > button[type="button"]
<button type="button"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"></circle><path d="M20 20l-3.5-3.5"></path></svg></button>
.thumbs > button:nth-child(1)
<button type="button"><img src="/img/daypack.svg"></button>
.thumbs > button:nth-child(2)
<button type="button"><img src="/img/jacket.svg"></button>
.thumbs > button:nth-child(3)
<button type="button"><img src="/img/bottle.svg"></button>
Etkilenen sayfalar (9)
  • https://harborandpine.example/
  • https://harborandpine.example/collections/all
  • https://harborandpine.example/products/trail-daypack
  • https://harborandpine.example/cart
  • https://harborandpine.example/pages/about
  • https://harborandpine.example/products/pine-wool-beanie
  • https://harborandpine.example/products/enamel-camp-mug
  • https://harborandpine.example/products/harbor-lantern
  • https://harborandpine.example/products/insulated-bottle

Nasıl düzeltilir

Sayfanızın işaretleme kodundan oluşturulan kod
  1. Aşağıdaki örneklerde butonları bulun.
  2. Butonun ne yaptığını söyleyen görünür bir metin, görsel olarak gizli bir metin veya bir aria-label ekleyin (örneğin aria-label="Close" veya aria-label="Increase quantity").

Kod

Geliştiriciniz için uygulama örnekleri. Temanızın kaynak koduna sahip olmadığımız için dosya konumları kesin yollar değil, ipuçlarıdır.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<button type="button">…</button>
Sonra · hatalı öğeden oluşturuldu
<button type="button" aria-label="[What this button does]">…</button>

Köşeli parantez içindeki metni, butonun ne yaptığını anlatan bir metinle değiştirin. Butonun içinde görünür bir metin veya görsel olarak gizli bir metin de işe yarar.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<button type="button"><img src="/img/daypack.svg"></button>
Sonra · hatalı öğeden oluşturuldu
<button type="button" aria-label="[Describe the image, e.g. Back view]"><img src="/img/daypack.svg"></button>

Köşeli parantez içindeki metni, butonun ne yaptığını anlatan bir metinle değiştirin. Butonun içinde görünür bir metin veya görsel olarak gizli bir metin de işe yarar.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<button type="button"><img src="/img/jacket.svg"></button>
Sonra · hatalı öğeden oluşturuldu
<button type="button" aria-label="[Describe the image, e.g. Back view]"><img src="/img/jacket.svg"></button>

Köşeli parantez içindeki metni, butonun ne yaptığını anlatan bir metinle değiştirin. Butonun içinde görünür bir metin veya görsel olarak gizli bir metin de işe yarar.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<button type="button"><img src="/img/bottle.svg"></button>
Sonra · hatalı öğeden oluşturuldu
<button type="button" aria-label="[Describe the image, e.g. Back view]"><img src="/img/bottle.svg"></button>

Köşeli parantez içindeki metni, butonun ne yaptığını anlatan bir metinle değiştirin. Butonun içinde görünür bir metin veya görsel olarak gizli bir metin de işe yarar.

Yapay zekâyla düzeltinPrompt’u göster

Bunu tema dosyanızla birlikte ChatGPT, Claude, Cursor veya Copilot’a yapıştırın. Yayınlamadan önce değişikliği gözden geçirin.

harborandpine.example adresinde bir Shopify mağazası (Online Store 2.0 teması, Liquid şablonları) yönetiyorum. Bir erişilebilirlik testi bu sorunu buldu ve bunu temamda düzeltmek istiyorum.

Sorun: Butonların ayırt edilebilir bir metni olmalıdır (WCAG 4.1.2).
Nerede: 9 sayfada 41 tekrar, örneğin /, /collections/all, /products/trail-daypack, /cart.

Hatalı öğelerden biri, tarayıcının oluşturduğu haliyle:
```html
<button type="button"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"></circle><path d="M20 20l-3.5-3.5"></path></svg></button>
```

Neden önemli: WCAG 4.1.2, her kontrolün bir adı olmasını ister. Adı olmayan butonlar arasında çoğu zaman adet artırma/azaltma butonları, kapatma butonları ve slider okları bulunur.

Neyin değişmesi gerekiyor:
- Aşağıdaki örneklerde butonları bulun.
- Butonun ne yaptığını söyleyen görünür bir metin, görsel olarak gizli bir metin veya bir aria-label ekleyin (örneğin aria-label="Close" veya aria-label="Increase quantity").

Önerilen değişiklik (Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)):
```html
<button type="button" aria-label="[What this button does]">…</button>
```

Yanıtınız için kurallar:
- Yapılacak değişikliği birebir, önce ve sonra hali olarak gösterin ve değişikliğin hangi dosyaya veya ayara yapılacağını belirtin. Önce dosyamı görmeniz gerekiyorsa yapıştırmamı isteyin.
- Görsel tasarımı ve mevcut tüm davranışları aynı bırakın.
- Ürün adı, fiyat veya metin uydurmayın; benim doldurabileceğim yer tutucular kullanın.
- Sonunda düzeltmeyi kendim nasıl kontrol edebileceğimi anlatın.
- Bunun klavyeyle ve bir ekran okuyucuyla nasıl doğrulanacağını da ekleyin.

Düzeltmenizi kontrol edin

  • Etkilenen sayfaları yeniden tarayın.
  • Butonları bir ekran okuyucuyla kontrol edin.

Ayrıntılı rehber: https://dequeuniversity.com/rules/axe/4.13/button-name?application=playwright

P1KritikDoğrulanmış hataWCAG 1.1.1

Görsellerin alternatif metni olmalıdır

efor: orta · sorumlu: içerik editörü · 1.1.1 Non-text Content

Görsellerde metin alternatifi eksik; bu yüzden ekran okuyucu kullananlar görsellerin ne gösterdiğini bilemiyor.

WCAG 1.1.1, anlam taşıyan görseller için bir metin alternatifi ister. Bu olmadan ekran okuyucu kullanan biri, bir fotoğrafın hangi ürünü gösterdiğini anlayamaz.

Kanıt

Bulan test
axe-core otomatik kuralı
Durum · güven düzeyi
Doğrulanmış hata · yüksek
Tespit tarihi
24 Eyl 2026 (UTC)
Nerede
7 sayfa genelinde 22 tekrar

Beklenen: Görsellerin alternatif metni olmalıdır

Gözlemlenen: Öğenin alt özniteliği yok. aria-label özniteliği yok ya da boş. aria-labelledby özniteliği yok ya da var olmayan veya boş öğelere başvuruyor. Öğenin title özniteliği yok. Öğenin varsayılan anlamı role="none" veya role="presentation" ile geçersiz kılınmamış.

Görsellerin alternatif metni olmalıdır: / sayfasında çerçeve içine alınmış öğe
Görsellerin alternatif metni olmalıdır: / sayfasında çerçeve içine alınmış öğe
Görsellerin alternatif metni olmalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Görsellerin alternatif metni olmalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Nasıl yeniden oluşturulur
  1. https://harborandpine.example/ adresini Chrome veya Edge’de açın.
  2. DevTools’u (F12) açıp Öğeler (Elements) sekmesine gidin, Ctrl+F (Mac’te Cmd+F) tuşlarına basın ve şunu arayın: img[src$="hero-photo.jpg"]
  3. DevTools’un Erişilebilirlik (Accessibility) bölmesinde öğenin hesaplanan adı (Name) boş görünür.
  4. Ya da sayfada ücretsiz axe DevTools tarayıcı eklentisini çalıştırın: bunu “image-alt” olarak raporlar.
Hatalı öğeler (4 tanesi gösteriliyor)
img[src$="hero-photo.jpg"]
<img src="/img/hero-photo.jpg" loading="lazy">
img[src$="mug.svg"]
<img src="/img/mug.svg">
img[src$="beanie.svg"]
<img src="/img/beanie.svg">
img[src$="jacket.svg"]
<img src="/img/jacket.svg">
Etkilenen sayfalar (7)
  • https://harborandpine.example/
  • https://harborandpine.example/collections/all
  • https://harborandpine.example/products/trail-daypack
  • https://harborandpine.example/products/pine-wool-beanie
  • https://harborandpine.example/products/enamel-camp-mug
  • https://harborandpine.example/products/harbor-lantern
  • https://harborandpine.example/products/insulated-bottle

Nasıl düzeltilir

Sayfanızın işaretleme kodundan oluşturulan kod
  1. Shopify yönetici panelinde Ürünler > [ürün] > Medya bölümünü açın, her görsele tıklayın ve “Alternatif metin” alanını doldurun. Bölüm görselleri için Online Mağaza > Temalar > Özelleştir bölümünü açın ve görselin alternatif metnini bölüm ayarlarında belirleyin.
  2. Bir müşteri için önemli olanı açıklayın: ürün adı, renk ve gösterilen açı (örneğin “Zeytin yeşili kanvas çanta, önden görünüm”).
  3. Dekoratif görsellerde, ekran okuyucuların onları atlaması için boş bir alt özniteliği (alt="") olmalıdır.

Kod

Geliştiriciniz için uygulama örnekleri. Temanızın kaynak koduna sahip olmadığımız için dosya konumları kesin yollar değil, ipuçlarıdır.

Önce · bulduğumuz · Ürün fotoğrafları: Shopify yönetici paneli › Ürünler › Medya › Alternatif metin. Diğer görseller: tema kodunuz
<img src="/img/hero-photo.jpg" loading="lazy">
Sonra · hatalı öğeden oluşturuldu
<img src="/img/hero-photo.jpg" loading="lazy" alt="[Describe the image for a shopper]">

Görselin ne gösterdiğini açıklayın (bir ürün fotoğrafı için: ürün, renk, açı). Görsel yalnızca dekoratifse, ekran okuyucuların onu atlaması için bunun yerine alt="" kullanın.

Önce · bulduğumuz · Ürün fotoğrafları: Shopify yönetici paneli › Ürünler › Medya › Alternatif metin. Diğer görseller: tema kodunuz
<img src="/img/mug.svg">
Sonra · hatalı öğeden oluşturuldu
<img src="/img/mug.svg" alt="[Describe the image for a shopper]">

Görselin ne gösterdiğini açıklayın (bir ürün fotoğrafı için: ürün, renk, açı). Görsel yalnızca dekoratifse, ekran okuyucuların onu atlaması için bunun yerine alt="" kullanın.

Önce · bulduğumuz · Ürün fotoğrafları: Shopify yönetici paneli › Ürünler › Medya › Alternatif metin. Diğer görseller: tema kodunuz
<img src="/img/beanie.svg">
Sonra · hatalı öğeden oluşturuldu
<img src="/img/beanie.svg" alt="[Describe the image for a shopper]">

Görselin ne gösterdiğini açıklayın (bir ürün fotoğrafı için: ürün, renk, açı). Görsel yalnızca dekoratifse, ekran okuyucuların onu atlaması için bunun yerine alt="" kullanın.

Önce · bulduğumuz · Ürün fotoğrafları: Shopify yönetici paneli › Ürünler › Medya › Alternatif metin. Diğer görseller: tema kodunuz
<img src="/img/jacket.svg">
Sonra · hatalı öğeden oluşturuldu
<img src="/img/jacket.svg" alt="[Describe the image for a shopper]">

Görselin ne gösterdiğini açıklayın (bir ürün fotoğrafı için: ürün, renk, açı). Görsel yalnızca dekoratifse, ekran okuyucuların onu atlaması için bunun yerine alt="" kullanın.

Yapay zekâyla düzeltinPrompt’u göster

Bunu tema dosyanızla birlikte ChatGPT, Claude, Cursor veya Copilot’a yapıştırın. Yayınlamadan önce değişikliği gözden geçirin.

harborandpine.example adresinde bir Shopify mağazası (Online Store 2.0 teması, Liquid şablonları) yönetiyorum. Bir erişilebilirlik testi bu sorunu buldu ve bunu temamda düzeltmek istiyorum.

Sorun: Görsellerin alternatif metni olmalıdır (WCAG 1.1.1).
Nerede: 7 sayfada 22 tekrar, örneğin /, /collections/all, /products/trail-daypack, /products/pine-wool-beanie.

Hatalı öğelerden biri, tarayıcının oluşturduğu haliyle:
```html
<img src="/img/hero-photo.jpg" loading="lazy">
```

Neden önemli: WCAG 1.1.1, anlam taşıyan görseller için bir metin alternatifi ister. Bu olmadan ekran okuyucu kullanan biri, bir fotoğrafın hangi ürünü gösterdiğini anlayamaz.

Neyin değişmesi gerekiyor:
- Shopify yönetici panelinde Ürünler > [ürün] > Medya bölümünü açın, her görsele tıklayın ve “Alternatif metin” alanını doldurun. Bölüm görselleri için Online Mağaza > Temalar > Özelleştir bölümünü açın ve görselin alternatif metnini bölüm ayarlarında belirleyin.
- Bir müşteri için önemli olanı açıklayın: ürün adı, renk ve gösterilen açı (örneğin “Zeytin yeşili kanvas çanta, önden görünüm”).
- Dekoratif görsellerde, ekran okuyucuların onları atlaması için boş bir alt özniteliği (alt="") olmalıdır.

Önerilen değişiklik (Ürün fotoğrafları: Shopify yönetici paneli › Ürünler › Medya › Alternatif metin. Diğer görseller: tema kodunuz):
```html
<img src="/img/hero-photo.jpg" loading="lazy" alt="[Describe the image for a shopper]">
```

Yanıtınız için kurallar:
- Yapılacak değişikliği birebir, önce ve sonra hali olarak gösterin ve değişikliğin hangi dosyaya veya ayara yapılacağını belirtin. Önce dosyamı görmeniz gerekiyorsa yapıştırmamı isteyin.
- Görsel tasarımı ve mevcut tüm davranışları aynı bırakın.
- Ürün adı, fiyat veya metin uydurmayın; benim doldurabileceğim yer tutucular kullanın.
- Sonunda düzeltmeyi kendim nasıl kontrol edebileceğimi anlatın.
- Bunun klavyeyle ve bir ekran okuyucuyla nasıl doğrulanacağını da ekleyin.

Düzeltmenizi kontrol edin

  • Etkilenen sayfaları yeniden tarayın.
  • Ürün görsellerinin nasıl seslendirildiğini duymak için bir ekran okuyucu kullanın (Mac’te VoiceOver: Cmd+F5).

Ayrıntılı rehber: https://dequeuniversity.com/rules/axe/4.13/image-alt?application=playwright

P1KritikDoğrulanmış hataWCAG 4.1.2

Form öğelerinin etiketi olmalıdır

efor: hızlı · sorumlu: tema geliştiricisi · 4.1.2 Name, Role, Value

Bazı form alanlarının etiketi yok; bu yüzden ekran okuyucu kullananlar ne girmeleri gerektiğini bilemiyor.

WCAG 1.3.1, 3.3.2 ve 4.1.2, form alanlarının etiketi olmasını ister. Bülten kayıt ve arama alanları bu sorunun en sık görüldüğü yerlerdir.

Kanıt

Bulan test
axe-core otomatik kuralı
Durum · güven düzeyi
Doğrulanmış hata · yüksek
Tespit tarihi
24 Eyl 2026 (UTC)
Nerede
6 sayfa genelinde 7 tekrar

Beklenen: Form öğelerinin etiketi olmalıdır

Gözlemlenen: Öğenin örtük (öğeyi saran) bir <label> öğesi yok. Öğenin açıkça ilişkilendirilmiş bir <label> öğesi yok. aria-label özniteliği yok ya da boş. aria-labelledby özniteliği yok ya da var olmayan veya boş öğelere başvuruyor. Öğenin title özniteliği yok. Öğenin placeholder özniteliği yok. Öğenin varsayılan anlamı role="none" veya role="presentation" ile geçersiz kılınmamış.

Form öğelerinin etiketi olmalıdır: /products/trail-daypack sayfasında çerçeve içine alınmış öğe
Form öğelerinin etiketi olmalıdır: /products/trail-daypack sayfasında çerçeve içine alınmış öğe
Form öğelerinin etiketi olmalıdır: /cart sayfasında çerçeve içine alınmış öğe
Form öğelerinin etiketi olmalıdır: /cart sayfasında çerçeve içine alınmış öğe
Nasıl yeniden oluşturulur
  1. https://harborandpine.example/products/trail-daypack adresini Chrome veya Edge’de açın.
  2. DevTools’u (F12) açıp Öğeler (Elements) sekmesine gidin, Ctrl+F (Mac’te Cmd+F) tuşlarına basın ve şunu arayın: input
  3. DevTools’un Erişilebilirlik (Accessibility) bölmesinde öğenin hesaplanan adı (Name) boş görünür.
  4. Ya da sayfada ücretsiz axe DevTools tarayıcı eklentisini çalıştırın: bunu “label” olarak raporlar.
Hatalı öğeler (2 tanesi gösteriliyor)
input
<input type="number" value="1" min="1">
input[value="2"]
<input type="number" value="2" min="1">
Etkilenen sayfalar (6)
  • https://harborandpine.example/products/trail-daypack
  • https://harborandpine.example/cart
  • https://harborandpine.example/products/pine-wool-beanie
  • https://harborandpine.example/products/enamel-camp-mug
  • https://harborandpine.example/products/harbor-lantern
  • https://harborandpine.example/products/insulated-bottle

Nasıl düzeltilir

Sayfanızın işaretleme kodundan oluşturulan kod
  1. Her alana bir <label for="field-id"> öğesi veya en azından bir aria-label verin.
  2. Yer tutucu metin tek başına etiket sayılmaz.

Kod

Geliştiriciniz için uygulama örnekleri. Temanızın kaynak koduna sahip olmadığımız için dosya konumları kesin yollar değil, ipuçlarıdır.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<input type="number" value="1" min="1">
Sonra · hatalı öğeden oluşturuldu
<input type="number" value="1" min="1" aria-label="Quantity">

Alanın id’si yok; bu yüzden en hızlı çözüm bir aria-label’dır. Görünür bir <label> herkes için daha iyidir. “Quantity” etiket metni alandan tahmin edildi; gerekirse düzenleyin.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<input type="number" value="2" min="1">
Sonra · hatalı öğeden oluşturuldu
<input type="number" value="2" min="1" aria-label="Quantity">

Alanın id’si yok; bu yüzden en hızlı çözüm bir aria-label’dır. Görünür bir <label> herkes için daha iyidir. “Quantity” etiket metni alandan tahmin edildi; gerekirse düzenleyin.

Yapay zekâyla düzeltinPrompt’u göster

Bunu tema dosyanızla birlikte ChatGPT, Claude, Cursor veya Copilot’a yapıştırın. Yayınlamadan önce değişikliği gözden geçirin.

harborandpine.example adresinde bir Shopify mağazası (Online Store 2.0 teması, Liquid şablonları) yönetiyorum. Bir erişilebilirlik testi bu sorunu buldu ve bunu temamda düzeltmek istiyorum.

Sorun: Form öğelerinin etiketi olmalıdır (WCAG 4.1.2).
Nerede: 6 sayfada 7 tekrar, örneğin /products/trail-daypack, /cart, /products/pine-wool-beanie, /products/enamel-camp-mug.

Hatalı öğelerden biri, tarayıcının oluşturduğu haliyle:
```html
<input type="number" value="1" min="1">
```

Neden önemli: WCAG 1.3.1, 3.3.2 ve 4.1.2, form alanlarının etiketi olmasını ister. Bülten kayıt ve arama alanları bu sorunun en sık görüldüğü yerlerdir.

Neyin değişmesi gerekiyor:
- Her alana bir <label for="field-id"> öğesi veya en azından bir aria-label verin.
- Yer tutucu metin tek başına etiket sayılmaz.

Önerilen değişiklik (Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)):
```html
<input type="number" value="1" min="1" aria-label="Quantity">
```

Yanıtınız için kurallar:
- Yapılacak değişikliği birebir, önce ve sonra hali olarak gösterin ve değişikliğin hangi dosyaya veya ayara yapılacağını belirtin. Önce dosyamı görmeniz gerekiyorsa yapıştırmamı isteyin.
- Görsel tasarımı ve mevcut tüm davranışları aynı bırakın.
- Ürün adı, fiyat veya metin uydurmayın; benim doldurabileceğim yer tutucular kullanın.
- Sonunda düzeltmeyi kendim nasıl kontrol edebileceğimi anlatın.
- Bunun klavyeyle ve bir ekran okuyucuyla nasıl doğrulanacağını da ekleyin.

Düzeltmenizi kontrol edin

  • Yeniden tarayın ve label kuralının artık başarısız olmadığını doğrulayın.
  • Her etikete tıklayın ve kendi alanına odaklandığını kontrol edin.

Ayrıntılı rehber: https://dequeuniversity.com/rules/axe/4.13/label?application=playwright

P1KritikDoğrulanmış hataWCAG 4.1.2

Select öğesinin erişilebilir bir adı olmalıdır

efor: hızlı · sorumlu: tema geliştiricisi · 4.1.2 Name, Role, Value

Bir açılır menünün (çoğu zaman sıralama veya varyant seçicinin) etiketi yok.

WCAG 4.1.2, seçim menülerinin erişilebilir bir adı olmasını ister.

Kanıt

Bulan test
axe-core otomatik kuralı
Durum · güven düzeyi
Doğrulanmış hata · yüksek
Tespit tarihi
24 Eyl 2026 (UTC)
Nerede
1 sayfa genelinde 1 tekrar

Beklenen: Select öğesinin erişilebilir bir adı olmalıdır

Gözlemlenen: Öğenin örtük (öğeyi saran) bir <label> öğesi yok. Öğenin açıkça ilişkilendirilmiş bir <label> öğesi yok. aria-label özniteliği yok ya da boş. aria-labelledby özniteliği yok ya da var olmayan veya boş öğelere başvuruyor. Öğenin title özniteliği yok. Öğenin varsayılan anlamı role="none" veya role="presentation" ile geçersiz kılınmamış.

Select öğesinin erişilebilir bir adı olmalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Select öğesinin erişilebilir bir adı olmalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Nasıl yeniden oluşturulur
  1. https://harborandpine.example/collections/all adresini Chrome veya Edge’de açın.
  2. DevTools’u (F12) açıp Öğeler (Elements) sekmesine gidin, Ctrl+F (Mac’te Cmd+F) tuşlarına basın ve şunu arayın: select
  3. DevTools’un Erişilebilirlik (Accessibility) bölmesinde öğenin hesaplanan adı (Name) boş görünür.
  4. Ya da sayfada ücretsiz axe DevTools tarayıcı eklentisini çalıştırın: bunu “select-name” olarak raporlar.
Hatalı öğeler (1 tanesi gösteriliyor)
select
<select><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select>
Etkilenen sayfalar (1)
  • https://harborandpine.example/collections/all

Nasıl düzeltilir

Sayfanızın işaretleme kodundan oluşturulan kod
  1. Seçim menüsüne bağlı bir <label> ya da aria-label="Sort by" gibi bir aria-label ekleyin.

Kod

Geliştiriciniz için uygulama örnekleri. Temanızın kaynak koduna sahip olmadığımız için dosya konumları kesin yollar değil, ipuçlarıdır.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<select><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select>
Sonra · hatalı öğeden oluşturuldu
<select aria-label="[Field label]"><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select>

Alanın id’si yok; bu yüzden en hızlı çözüm bir aria-label’dır. Görünür bir <label> herkes için daha iyidir. Köşeli parantez içindeki metni alanın etiketiyle değiştirin.

Yapay zekâyla düzeltinPrompt’u göster

Bunu tema dosyanızla birlikte ChatGPT, Claude, Cursor veya Copilot’a yapıştırın. Yayınlamadan önce değişikliği gözden geçirin.

harborandpine.example adresinde bir Shopify mağazası (Online Store 2.0 teması, Liquid şablonları) yönetiyorum. Bir erişilebilirlik testi bu sorunu buldu ve bunu temamda düzeltmek istiyorum.

Sorun: Select öğesinin erişilebilir bir adı olmalıdır (WCAG 4.1.2).
Nerede: 1 sayfada 1 tekrar, örneğin /collections/all.

Hatalı öğelerden biri, tarayıcının oluşturduğu haliyle:
```html
<select><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select>
```

Neden önemli: WCAG 4.1.2, seçim menülerinin erişilebilir bir adı olmasını ister.

Neyin değişmesi gerekiyor:
- Seçim menüsüne bağlı bir <label> ya da aria-label="Sort by" gibi bir aria-label ekleyin.

Önerilen değişiklik (Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)):
```html
<select aria-label="[Field label]"><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select>
```

Yanıtınız için kurallar:
- Yapılacak değişikliği birebir, önce ve sonra hali olarak gösterin ve değişikliğin hangi dosyaya veya ayara yapılacağını belirtin. Önce dosyamı görmeniz gerekiyorsa yapıştırmamı isteyin.
- Görsel tasarımı ve mevcut tüm davranışları aynı bırakın.
- Ürün adı, fiyat veya metin uydurmayın; benim doldurabileceğim yer tutucular kullanın.
- Sonunda düzeltmeyi kendim nasıl kontrol edebileceğimi anlatın.
- Bunun klavyeyle ve bir ekran okuyucuyla nasıl doğrulanacağını da ekleyin.

Düzeltmenizi kontrol edin

  • Koleksiyon ve ürün sayfalarını yeniden tarayın.

Ayrıntılı rehber: https://dequeuniversity.com/rules/axe/4.13/select-name?application=playwright

P1CiddiDoğrulanmış hataWCAG 1.4.3

Öğeler asgari renk kontrastı oranı eşiklerini karşılamalıdır

efor: hızlı · sorumlu: mağaza sahibi (yönetici paneli ayarları) · 1.4.3 Contrast (Minimum)

Bazı metinler, az gören kişilerin okuyabileceği kadar arka planından ayrışmıyor.

WCAG 1.4.3, normal metin için en az 4,5:1, büyük metin için en az 3:1 kontrast oranı ister. Soluk fiyatlar, rozetler ve banner’lar az gören kişiler için ve parlak ışıkta herkes için zor okunur.

Kanıt

Bulan test
axe-core otomatik kuralı
Durum · güven düzeyi
Doğrulanmış hata · yüksek
Tespit tarihi
24 Eyl 2026 (UTC)
Nerede
9 sayfa genelinde 22 tekrar

Beklenen: Öğeler asgari renk kontrastı oranı eşiklerini karşılamalıdır

Gözlemlenen: Öğenin renk kontrastı yetersiz: 3.09 (ön plan rengi: #ffffff, arka plan rengi: #e76f51, yazı tipi boyutu: 9.8pt (13px), yazı tipi kalınlığı: normal). Beklenen kontrast oranı: 4.5:1.

Öğeler asgari renk kontrastı oranı eşiklerini karşılamalıdır: / sayfasında çerçeve içine alınmış öğe
Öğeler asgari renk kontrastı oranı eşiklerini karşılamalıdır: / sayfasında çerçeve içine alınmış öğe
Öğeler asgari renk kontrastı oranı eşiklerini karşılamalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Öğeler asgari renk kontrastı oranı eşiklerini karşılamalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Nasıl yeniden oluşturulur
  1. https://harborandpine.example/ adresini Chrome veya Edge’de açın.
  2. DevTools’u (F12) açıp Öğeler (Elements) sekmesine gidin, Ctrl+F (Mac’te Cmd+F) tuşlarına basın ve şunu arayın: .announce
  3. Ölçülen kontrast oranını görmek için Stiller (Styles) bölmesinde öğenin renginin yanındaki renk örneğine tıklayın.
  4. Ya da sayfada ücretsiz axe DevTools tarayıcı eklentisini çalıştırın: bunu “color-contrast” olarak raporlar.
Hatalı öğeler (4 tanesi gösteriliyor)
.announce
<div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div>
article:nth-child(3) > .badge
<span class="badge">Sale</span>
article:nth-child(3) > .price > .compare
<span class="compare">$72</span>
article:nth-child(4) > .price > .compare
<span class="compare">$40</span>
Etkilenen sayfalar (9)
  • https://harborandpine.example/
  • https://harborandpine.example/collections/all
  • https://harborandpine.example/products/trail-daypack
  • https://harborandpine.example/cart
  • https://harborandpine.example/pages/about
  • https://harborandpine.example/products/pine-wool-beanie
  • https://harborandpine.example/products/enamel-camp-mug
  • https://harborandpine.example/products/harbor-lantern
  • https://harborandpine.example/products/insulated-bottle

Nasıl düzeltilir

Sayfanızın işaretleme kodundan oluşturulan kod
  1. Aşağıda listelenen hatalı öğeleri açın ve hata özetindeki ön plan ve arka plan renklerini not edin.
  2. Online Mağaza > Temalar > Özelleştir > Tema ayarları > Renkler bölümünde, etkilenen renk şeması için oran en az 4,5:1 olana kadar metin rengini koyulaştırın veya arka planı açın.
  3. İndirim rozetlerine, yer tutucu metinlere, alt bilgi bağlantılarına ve görsellerin üzerindeki butonlara özellikle dikkat edin.

Kod

Geliştiriciniz için uygulama örnekleri. Temanızın kaynak koduna sahip olmadığımız için dosya konumları kesin yollar değil, ipuçlarıdır.

Önce · bulduğumuz · Tema ayarları › Renkler veya temanızın CSS dosyası
<div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div>
Sonra · hatalı öğeden oluşturuldu
.announce {
  background-color: #b95941; /* was #e76f51: 3.09:1, now 4.59:1 */
}

13px metin için ölçülen oran 3,09:1; WCAG 1.4.3 4,5:1 ister. #b95941 aynı renk tonunu korur ve testi geçer. Seçici, testimizin kullandığı seçicidir; temanız aynı stil için daha genel bir sınıf kullanıyor olabilir.

Önce · bulduğumuz · Tema ayarları › Renkler veya temanızın CSS dosyası
<span class="badge">Sale</span>
Sonra · hatalı öğeden oluşturuldu
.badge {
  background-color: #9f693f; /* was #f4a261: 2.06:1, now 4.59:1 */
}

12px kalın metin için ölçülen oran 2,06:1; WCAG 1.4.3 4,5:1 ister. #9f693f aynı renk tonunu korur ve testi geçer. Seçici, testimizin kullandığı seçicidir; temanız aynı stil için daha genel bir sınıf kullanıyor olabilir.

Önce · bulduğumuz · Tema ayarları › Renkler veya temanızın CSS dosyası
<span class="compare">$72</span>
Sonra · hatalı öğeden oluşturuldu
.compare {
  color: #78736c; /* was #b0a99f: 2.29:1, now 4.62:1 */
}

14px metin için ölçülen oran 2,29:1; WCAG 1.4.3 4,5:1 ister. #78736c aynı renk tonunu korur ve testi geçer. Seçici, testimizin kullandığı seçicidir; temanız aynı stil için daha genel bir sınıf kullanıyor olabilir.

Yapay zekâyla düzeltinPrompt’u göster

Bunu tema dosyanızla birlikte ChatGPT, Claude, Cursor veya Copilot’a yapıştırın. Yayınlamadan önce değişikliği gözden geçirin.

harborandpine.example adresinde bir Shopify mağazası (Online Store 2.0 teması, Liquid şablonları) yönetiyorum. Bir erişilebilirlik testi bu sorunu buldu ve bunu temamda düzeltmek istiyorum.

Sorun: Öğeler asgari renk kontrastı oranı eşiklerini karşılamalıdır (WCAG 1.4.3).
Nerede: 9 sayfada 22 tekrar, örneğin /, /collections/all, /products/trail-daypack, /cart.

Hatalı öğelerden biri, tarayıcının oluşturduğu haliyle:
```html
<div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div>
```

Neden önemli: WCAG 1.4.3, normal metin için en az 4,5:1, büyük metin için en az 3:1 kontrast oranı ister. Soluk fiyatlar, rozetler ve banner’lar az gören kişiler için ve parlak ışıkta herkes için zor okunur.

Neyin değişmesi gerekiyor:
- Aşağıda listelenen hatalı öğeleri açın ve hata özetindeki ön plan ve arka plan renklerini not edin.
- Online Mağaza > Temalar > Özelleştir > Tema ayarları > Renkler bölümünde, etkilenen renk şeması için oran en az 4,5:1 olana kadar metin rengini koyulaştırın veya arka planı açın.
- İndirim rozetlerine, yer tutucu metinlere, alt bilgi bağlantılarına ve görsellerin üzerindeki butonlara özellikle dikkat edin.

Önerilen değişiklik (Tema ayarları › Renkler veya temanızın CSS dosyası):
```css
.announce {
  background-color: #b95941; /* was #e76f51: 3.09:1, now 4.59:1 */
}
```

Yanıtınız için kurallar:
- Yapılacak değişikliği birebir, önce ve sonra hali olarak gösterin ve değişikliğin hangi dosyaya veya ayara yapılacağını belirtin. Önce dosyamı görmeniz gerekiyorsa yapıştırmamı isteyin.
- Görsel tasarımı ve mevcut tüm davranışları aynı bırakın.
- Ürün adı, fiyat veya metin uydurmayın; benim doldurabileceğim yer tutucular kullanın.
- Sonunda düzeltmeyi kendim nasıl kontrol edebileceğimi anlatın.
- Bunun klavyeyle ve bir ekran okuyucuyla nasıl doğrulanacağını da ekleyin.

Düzeltmenizi kontrol edin

  • Taramayı yeniden çalıştırın ve color-contrast kuralının artık görünmediğini doğrulayın.
  • Tam renk değerleriyle bir kontrast kontrol aracında örnek kontrol yapın.

Ayrıntılı rehber: https://dequeuniversity.com/rules/axe/4.13/color-contrast?application=playwright

P3OrtaDoğrulanmış hata

Sayfa içeriğinin tamamı landmark’ların içinde yer almalıdır

efor: orta · sorumlu: tema geliştiricisi

Bazı içerikler bir sayfa landmark’ının (header, nav, main veya footer) içinde değil.

Landmark’lar, ekran okuyucu kullananların sayfanın bölümleri arasında hızla geçiş yapmasını sağlar. Bu, WCAG 1.3.1 ve 2.4.1’i destekleyen bir iyi uygulamadır.

Kanıt

Bulan test
axe-core otomatik kuralı
Durum · güven düzeyi
Doğrulanmış hata · yüksek
Tespit tarihi
24 Eyl 2026 (UTC)
Nerede
9 sayfa genelinde 18 tekrar

Beklenen: Sayfa içeriğinin tamamı landmark’ların içinde yer almalıdır

Gözlemlenen: Sayfa içeriğinin bir kısmı landmark’ların içinde yer almıyor.

Sayfa içeriğinin tamamı landmark’ların içinde yer almalıdır: / sayfasında çerçeve içine alınmış öğe
Sayfa içeriğinin tamamı landmark’ların içinde yer almalıdır: / sayfasında çerçeve içine alınmış öğe
Sayfa içeriğinin tamamı landmark’ların içinde yer almalıdır: /cart sayfasında çerçeve içine alınmış öğe
Sayfa içeriğinin tamamı landmark’ların içinde yer almalıdır: /cart sayfasında çerçeve içine alınmış öğe
Nasıl yeniden oluşturulur
  1. https://harborandpine.example/ adresini Chrome veya Edge’de açın.
  2. DevTools’u (F12) açıp Öğeler (Elements) sekmesine gidin, Ctrl+F (Mac’te Cmd+F) tuşlarına basın ve şunu arayın: .announce
  3. Ya da sayfada ücretsiz axe DevTools tarayıcı eklentisini çalıştırın: bunu “region” olarak raporlar.
Hatalı öğeler (2 tanesi gösteriliyor)
.announce
<div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div>
#cookie-banner > p
<p>We use cookies to improve your experience and measure traffic.</p>
Etkilenen sayfalar (9)
  • https://harborandpine.example/
  • https://harborandpine.example/collections/all
  • https://harborandpine.example/products/trail-daypack
  • https://harborandpine.example/cart
  • https://harborandpine.example/pages/about
  • https://harborandpine.example/products/pine-wool-beanie
  • https://harborandpine.example/products/enamel-camp-mug
  • https://harborandpine.example/products/harbor-lantern
  • https://harborandpine.example/products/insulated-bottle

Nasıl düzeltilir

Genel rehberlik
  1. Dışarıda kalan içerikleri (duyuru çubukları, pop-up’lar, sohbet widget’ları) uygun landmark’ın içine alın veya <main> içine yerleştirin.
Yapay zekâyla düzeltinPrompt’u göster

Bunu tema dosyanızla birlikte ChatGPT, Claude, Cursor veya Copilot’a yapıştırın. Yayınlamadan önce değişikliği gözden geçirin.

harborandpine.example adresinde bir Shopify mağazası (Online Store 2.0 teması, Liquid şablonları) yönetiyorum. Bir erişilebilirlik testi bu sorunu buldu ve bunu temamda düzeltmek istiyorum.

Sorun: Sayfa içeriğinin tamamı landmark’ların içinde yer almalıdır.
Nerede: 9 sayfada 18 tekrar, örneğin /, /collections/all, /products/trail-daypack, /cart.

Hatalı öğelerden biri, tarayıcının oluşturduğu haliyle:
```html
<div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div>
```

Neden önemli: Landmark’lar, ekran okuyucu kullananların sayfanın bölümleri arasında hızla geçiş yapmasını sağlar. Bu, WCAG 1.3.1 ve 2.4.1’i destekleyen bir iyi uygulamadır.

Neyin değişmesi gerekiyor:
- Dışarıda kalan içerikleri (duyuru çubukları, pop-up’lar, sohbet widget’ları) uygun landmark’ın içine alın veya <main> içine yerleştirin.

Yanıtınız için kurallar:
- Yapılacak değişikliği birebir, önce ve sonra hali olarak gösterin ve değişikliğin hangi dosyaya veya ayara yapılacağını belirtin. Önce dosyamı görmeniz gerekiyorsa yapıştırmamı isteyin.
- Görsel tasarımı ve mevcut tüm davranışları aynı bırakın.
- Ürün adı, fiyat veya metin uydurmayın; benim doldurabileceğim yer tutucular kullanın.
- Sonunda düzeltmeyi kendim nasıl kontrol edebileceğimi anlatın.
- Bunun klavyeyle ve bir ekran okuyucuyla nasıl doğrulanacağını da ekleyin.

Düzeltmenizi kontrol edin

  • Etkilenen sayfaları yeniden tarayın.

Ayrıntılı rehber: https://dequeuniversity.com/rules/axe/4.13/region?application=playwright

P3OrtaDoğrulanmış hata

Başlık seviyeleri yalnızca birer birer artmalıdır

efor: orta · sorumlu: tema geliştiricisi

Başlık seviyeleri atlıyor (örneğin H2’den H4’e); bu da sayfa yapısını ekran okuyucu kullananlar için kafa karıştırıcı hale getiriyor.

Ekran okuyucu kullananlar sayfada başlıklar aracılığıyla gezinir. Bu, WCAG 1.3.1’i destekleyen bir iyi uygulamadır.

Kanıt

Bulan test
axe-core otomatik kuralı
Durum · güven düzeyi
Doğrulanmış hata · yüksek
Tespit tarihi
24 Eyl 2026 (UTC)
Nerede
7 sayfa genelinde 7 tekrar

Beklenen: Başlık seviyeleri yalnızca birer birer artmalıdır

Gözlemlenen: Başlık sırası geçersiz.

Başlık seviyeleri yalnızca birer birer artmalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Başlık seviyeleri yalnızca birer birer artmalıdır: /collections/all sayfasında çerçeve içine alınmış öğe
Başlık seviyeleri yalnızca birer birer artmalıdır: /products/trail-daypack sayfasında çerçeve içine alınmış öğe
Başlık seviyeleri yalnızca birer birer artmalıdır: /products/trail-daypack sayfasında çerçeve içine alınmış öğe
Nasıl yeniden oluşturulur
  1. https://harborandpine.example/collections/all adresini Chrome veya Edge’de açın.
  2. DevTools’u (F12) açıp Öğeler (Elements) sekmesine gidin, Ctrl+F (Mac’te Cmd+F) tuşlarına basın ve şunu arayın: article:nth-child(1) > a[href$="trail-daypack"] > h3
  3. Ya da sayfada ücretsiz axe DevTools tarayıcı eklentisini çalıştırın: bunu “heading-order” olarak raporlar.
Hatalı öğeler (3 tanesi gösteriliyor)
article:nth-child(1) > a[href$="trail-daypack"] > h3
<h3>Trail Daypack 22L</h3>
h3
<h3>Reviews</h3>
h3:nth-child(3)
<h3>Started on the trail</h3>
Etkilenen sayfalar (7)
  • https://harborandpine.example/collections/all
  • https://harborandpine.example/products/trail-daypack
  • https://harborandpine.example/pages/about
  • https://harborandpine.example/products/pine-wool-beanie
  • https://harborandpine.example/products/enamel-camp-mug
  • https://harborandpine.example/products/harbor-lantern
  • https://harborandpine.example/products/insulated-bottle

Nasıl düzeltilir

Genel rehberlik
  1. Etkilenen bölümlerdeki başlık seviyelerini, seviye atlamadan sırayla ilerleyecek şekilde düzenleyin.
  2. Görsel stili değil, yalnızca etiketi değiştirin (boyut için CSS sınıfları kullanın).

Kod

Geliştiriciniz için uygulama örnekleri. Temanızın kaynak koduna sahip olmadığımız için dosya konumları kesin yollar değil, ipuçlarıdır.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<h3>Trail Daypack 22L</h3>
Sonra · uyarlanacak örnek
<h2 class="h3">Trail Daypack 22L</h2>

Sayfadaki bir önceki başlığın ardından gelen seviyeyi kullanın (çoğu zaman bir üst seviye) ve görünümü bir sınıfla koruyun. Değiştirmeden önce sayfanın başlık yapısını kontrol edin.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<h3>Reviews</h3>
Sonra · uyarlanacak örnek
<h2 class="h3">Reviews</h2>

Sayfadaki bir önceki başlığın ardından gelen seviyeyi kullanın (çoğu zaman bir üst seviye) ve görünümü bir sınıfla koruyun. Değiştirmeden önce sayfanın başlık yapısını kontrol edin.

Önce · bulduğumuz · Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)
<h3>Started on the trail</h3>
Sonra · uyarlanacak örnek
<h2 class="h3">Started on the trail</h2>

Sayfadaki bir önceki başlığın ardından gelen seviyeyi kullanın (çoğu zaman bir üst seviye) ve görünümü bir sınıfla koruyun. Değiştirmeden önce sayfanın başlık yapısını kontrol edin.

Yapay zekâyla düzeltinPrompt’u göster

Bunu tema dosyanızla birlikte ChatGPT, Claude, Cursor veya Copilot’a yapıştırın. Yayınlamadan önce değişikliği gözden geçirin.

harborandpine.example adresinde bir Shopify mağazası (Online Store 2.0 teması, Liquid şablonları) yönetiyorum. Bir erişilebilirlik testi bu sorunu buldu ve bunu temamda düzeltmek istiyorum.

Sorun: Başlık seviyeleri yalnızca birer birer artmalıdır.
Nerede: 7 sayfada 7 tekrar, örneğin /collections/all, /products/trail-daypack, /pages/about, /products/pine-wool-beanie.

Hatalı öğelerden biri, tarayıcının oluşturduğu haliyle:
```html
<h3>Trail Daypack 22L</h3>
```

Neden önemli: Ekran okuyucu kullananlar sayfada başlıklar aracılığıyla gezinir. Bu, WCAG 1.3.1’i destekleyen bir iyi uygulamadır.

Neyin değişmesi gerekiyor:
- Etkilenen bölümlerdeki başlık seviyelerini, seviye atlamadan sırayla ilerleyecek şekilde düzenleyin.
- Görsel stili değil, yalnızca etiketi değiştirin (boyut için CSS sınıfları kullanın).

Önerilen değişiklik (Tema kodunuz (gösterilen işaretleme kodunu içinde arayın)):
```html
<h2 class="h3">Trail Daypack 22L</h2>
```

Yanıtınız için kurallar:
- Yapılacak değişikliği birebir, önce ve sonra hali olarak gösterin ve değişikliğin hangi dosyaya veya ayara yapılacağını belirtin. Önce dosyamı görmeniz gerekiyorsa yapıştırmamı isteyin.
- Görsel tasarımı ve mevcut tüm davranışları aynı bırakın.
- Ürün adı, fiyat veya metin uydurmayın; benim doldurabileceğim yer tutucular kullanın.
- Sonunda düzeltmeyi kendim nasıl kontrol edebileceğimi anlatın.
- Bunun klavyeyle ve bir ekran okuyucuyla nasıl doğrulanacağını da ekleyin.

Düzeltmenizi kontrol edin

  • Yeniden tarayın ve başlık yapısını HeadingsMap gibi bir tarayıcı eklentisiyle kontrol edin.

Ayrıntılı rehber: https://dequeuniversity.com/rules/axe/4.13/heading-order?application=playwright

Manuel inceleme gerekli

Otomatik testler bunları işaretledi ama karar veremedi; örneğin bir görselin üzerindeki metin veya telefon ekranına sığmayabilecek içerik. Bunlar hata olarak sayılmaz. Geliştiricinizden her birini kontrol etmesini isteyin.

  • İnceleme gerekliWCAG 4.1.3

    Klavye yolculuğu: Klavyeyle sepete ekleme

    Sepete ekle butonunda Enter çalıştı (üst bilgideki sepet sayısı değişti, “sepete eklendi” mesajı göründü); ancak bir durum mesajı veya odak alan bir iletişim kutusu bulamadık, bu yüzden ekran okuyucu kullanıcıları ürünün eklendiğini duymayabilir.

    1 sayfa genelinde 1 tekrar · Bu nasıl kontrol edilir

  • İnceleme gerekliWCAG 1.4.10

    Ürün sayfası, yana kaydırma olmadan dar bir ekrana sığmayabilir

    320 CSS piksel genişlikte (%400 yakınlaştırmaya eşdeğer) sayfa ekrandan 200px daha geniş. Veri tabloları ve haritalar kaydırılabilir; metin ve kontroller kaydırılmamalıdır.

    1 sayfa genelinde 2 tekrar · Bu nasıl kontrol edilir

    Kontrol edilecek öğeler (2 tanesi gösteriliyor)
    div.icons
    <div class="icons"> <button type="button"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"></circle><path d="M20 20l-3.5-3.5"></path></svg></bu
    div
    <div> <p style="color:#6a6a60;font-size:14px">Harbor &amp; Pine</p> <h1>Trail Daypack 22L</h1> <p class="price" style="font-size:22px">$128<span class="compare">$150</span></p> <p class="opt-label">Si
  • İnceleme gerekliWCAG 1.4.10

    Ana sayfa, yana kaydırma olmadan dar bir ekrana sığmayabilir

    320 CSS piksel genişlikte (%400 yakınlaştırmaya eşdeğer) sayfa ekrandan 55px daha geniş. Veri tabloları ve haritalar kaydırılabilir; metin ve kontroller kaydırılmamalıdır.

    1 sayfa genelinde 3 tekrar · Bu nasıl kontrol edilir

    Kontrol edilecek öğeler (3 tanesi gösteriliyor)
    div.icons
    <div class="icons"> <button type="button"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"></circle><path d="M20 20l-3.5-3.5"></path></svg></bu
    article.card
    <article class="card"><span class="badge">Sale</span><a href="/products/trail-daypack"><img src="/img/beanie.svg"><h3>Pine Wool Beanie</h3></a><p class="price">$32<span class="compare">$40</span></p><
    button.btn.light
    <button class="btn light" type="submit">Subscribe</button>
  • İnceleme gerekliWCAG 1.4.3

    Öğeler asgari renk kontrastı oranı eşiklerini karşılamalıdır

    Öğe bir görsel düğümü içerdiği için arka plan rengi belirlenemedi.

    1 sayfa genelinde 1 tekrar · Bu nasıl kontrol edilir

    Kontrol edilecek öğeler (1 tanesi gösteriliyor)
    h1
    <h1>Gear for the long way home</h1>

Düzeltmelerinizi yeniden test edin

Geliştiriciniz değişiklikleri yaptıktan sonra yeniden test edin. Aynı sayfalarda aynı otomatik kontrolleri, klavye testini ve klavye yolculuğunu tekrar çalıştırır, hangi sorunları artık tespit etmediğimizi gösteririz. 5 yeniden test dahildir.

Yeniden testler ücretli raporlarda çalışır.

Manuel kontroller

Otomatik araçlar bunları değerlendiremez. İşi bitmiş saymadan önce bu kontrolleri yapın.

  • Ödemeyi yalnızca klavyeyle tamamlayın: otomatik yolculuğumuz ödeme butonunda durur ve ödeme sayfasına asla girmez.
  • Bir ekran okuyucuyla tekrarlayın (Mac’te VoiceOver: Cmd+F5; Windows’ta NVDA) ve fiyatların, varyantların ve hataların seslendirildiğini doğrulayın.
  • Tarayıcıyı %200’e yakınlaştırın ve hiçbir şeyin üst üste binmediğini veya kaybolmadığını doğrulayın.
  • Ürün ve marka videolarında doğru altyazılar olduğunu kontrol edin.
  • Formları (bülten, iletişim, ödeme) hatalı bilgilerle gönderin ve hataların metinle açıklandığını doğrulayın.
  • Karuselların ve pop-up’ların, Escape tuşu dahil, duraklatılabildiğini veya kapatılabildiğini kontrol edin.

Taslak erişilebilirlik beyanı

Köşeli parantez içindeki kısımları düzenleyin ve metni alt bilgiden bağlantı verilen bir sayfada yayınlayın.

harborandpine.example erişilebilirlik beyanı

Ekran okuyucu, klavyeyle gezinme, ekran büyütme veya başka yardımcı teknolojiler kullananlar dahil herkesin harborandpine.example üzerinden alışveriş yapabilmesini istiyoruz. Web İçeriği Erişilebilirlik Yönergeleri’nin (WCAG) 2.2 sürümünü AA seviyesinde karşılamayı amaçlıyoruz.

Neler yapıyoruz
- Mağazamızı otomatik erişilebilirlik araçlarıyla test ediyor ve buldukları sorunları düzeltiyoruz.
- Temel alışveriş adımlarını (ürünlere göz atma, ürün sayfaları, sepet ve ödeme) klavye ve ekran okuyucuyla test ediyoruz.
- Üçüncü taraf uygulamaları ve widget’ları eklemeden önce erişilebilirlik açısından inceliyoruz.

Bilinen sınırlamalar (24 Eylül 2026 itibarıyla)
- Klavye erişimi ve odak (WCAG 2.1.1). Bunu 2026-10-08 tarihine kadar düzeltmeyi planlıyoruz.
- Adı olmayan bağlantılar ve butonlar (WCAG 2.4.4, 4.1.2). Bunu 2026-10-08 tarihine kadar düzeltmeyi planlıyoruz.
- Metin alternatifi olmayan görseller (WCAG 1.1.1). Bunu 2026-10-08 tarihine kadar düzeltmeyi planlıyoruz.
- Etiketi olmayan form alanları (WCAG 4.1.2). Bunu 2026-10-08 tarihine kadar düzeltmeyi planlıyoruz.
- Düşük renk kontrastı (WCAG 1.4.3). Bunu 2026-10-08 tarihine kadar düzeltmeyi planlıyoruz.

Geri bildirim ve yardım
Mağazamızın herhangi bir bölümünü kullanırken sorun yaşarsanız [e-posta adresiniz] veya [telefon numaranız] üzerinden bizimle iletişime geçin. Bize sayfayı ve sorunu bildirin; satın alma işleminizi tamamlamanıza yardımcı olur ve 5 iş günü içinde yanıt veririz.

Bu beyan 24 Eylül 2026 tarihinde hazırlanmıştır ve en az yılda bir kez gözden geçirilecektir.

Kanıt kaydı

Her sayfa Chromium’da yüklendi ve axe-core 4.13.0 ile test edildi. SHA-256 özeti (hash), her sayfanın ham sonuçlarını tanımlar.

Zaman damgaları ve sonuç özetleriyle (hash) test edilen sayfalar
SayfaTest zamanı (UTC)HTTPSorunlarSHA-256
Ana sayfahttps://harborandpine.example/2026-09-24 14:05:0020015da1e5470a57859a864332912dd1e4f62b4c4f64487ba144865b74879519599a3
Koleksiyon sayfasıhttps://harborandpine.example/collections/all2026-09-24 14:05:092002028d8dfcf5ca953af353264a930a351bea3cf23f98a303874b32e5da355a4c8b0
Ürün sayfasıhttps://harborandpine.example/products/trail-daypack2026-09-24 14:05:182002068a173ddfd16eeeef5e36d6c0fa9d426769f0d96e358c5e35b67608dd84139b4
Sepethttps://harborandpine.example/cart2026-09-24 14:05:27200125b7945c2cdf779dcef2bd8975d96eb8f42d8dedbf10e767ec80199dd22ce257c
İçerik sayfasıhttps://harborandpine.example/pages/about2026-09-24 14:05:362009daf61ae856358a574e63f9357db0bfd9ae6079065acf3aebd5b3c5a7f460e53f
Ek sayfahttps://harborandpine.example/products/pine-wool-beanie2026-09-24 14:08:0020020f708ccd7de34dfb65d59d3716580b6ec15a6420020c8387fa4da4e2ff5bd52d3
Ek sayfahttps://harborandpine.example/products/enamel-camp-mug2026-09-24 14:08:0720019c619bcd29e89d06099d174b9fc19305a42f2fa9bdddb600a750c867fc7477022
Ek sayfahttps://harborandpine.example/products/harbor-lantern2026-09-24 14:08:14200205720b7433b75050ba413ac74c2bd726b0620aaa68f7918083052383257d5c418
Ek sayfahttps://harborandpine.example/products/insulated-bottle2026-09-24 14:08:21200196f1972c22e477c9a63e2dfde1123ed759718f6a75e1606b23f208848691510fd

Kapsam ve yöntem

Neleri test ettik

  • Chromium’da 1366×900 çözünürlükte yüklenen 9 sayfa (ana sayfa, koleksiyon sayfası, ürün sayfası, sepet, içerik sayfası, ek sayfa).
  • WCAG 2.0, 2.1 ve 2.2 A ve AA seviyeleri için axe-core 4.13.0 kuralları ve iyi uygulama kuralları (P3 olarak gösterilir).
  • Bir klavye testi: tuzakları ve eksik odak göstergelerini bulmak için ana sayfada 40 kez Tab tuşuna basıldı.
  • Ana sayfadan ödeme butonuna yalnızca klavyeyle yapılan bir alışveriş yolculuğu (yukarıya bakın).
  • 320 CSS piksel genişlikte yeniden akış (reflow) kontrolü, sayfalar: ana sayfa ve ürün sayfası (WCAG 1.4.10).

Neleri test etmedik

  • Ödeme ve ödeme bilgisi sayfaları, form gönderimleri, hesap sayfaları ve giriş gerektiren sayfalar.
  • Otomatik kuralların ötesinde, bir ekran okuyucunun gerçekte ne seslendirdiği.
  • Video altyazıları ve sesli betimlemeler, PDF belgeleri ve üçüncü taraf çerçevelerin içindeki içerikler.
  • Sade dil, bilişsel erişilebilirlik ve insan değerlendirmesi gerektiren diğer her şey (Manuel kontroller bölümüne bakın).

Sonuçlar nasıl okunur

Doğrulanmış hata
Otomatik bir test veya klavye yolculuğu başarısız oldu; kanıt gösterilir.
İnceleme gerekli
Bir test, karar veremediği bir şeyi işaretledi; bir insanın kontrol etmesi gerekir.
Başarılı
Otomatik kural, test edilen sayfalarda hata bulmadı.
Test edilmedi
Otomatik testlerin burada kapsayabileceği alanın dışında; Manuel kontroller bölümüne bakın.

Bu raporu web siteniz için alın.

Sorunlarınızı ve bunların ihtarnamenizle nasıl eşleştiğini görmek için ücretsiz taramayla başlayın. Erişilebilirlik Düzeltme Raporu tek seferlik $249 tutarındadır ve yaklaşık 10 dakikada hazır olur.

Web sitenizi ücretsiz tarayın

Bu rapor otomatik testlerin sonuçlarını açıklar ve düzeltme rehberliği sunar. Hukuki tavsiye değildir; ADA, Avrupa Erişilebilirlik Yasası veya başka herhangi bir yasayla uyumluluğu belgelemez.