---
title: "Tarayıcı ajanının bulabildiği erişilebilir düğmeler"
description: "Bir tarayıcı ajanı \"sepete ekle\" düğmesini süs simgesinden ayırmak zorunda. Ekran okuyucuların kullandığı adlar ve roller, bir denetimi yazılım için de tanınır"
source_url: "https://specoria.com/tr/icgoruler/tarayici-ajanlari-icin-erisilebilir-dugmeler/"
lang: "tr"
---

[İçgörüler](https://specoria.com/tr/icgoruler/) Altyapı

# Tarayıcı ajanının bulabildiği düğmeler: erişilebilirlik, yazılımın mağazanızı görme biçimidir

Bir tarayıcı ajanı "sepete ekle" düğmesini süs simgesinden ayırmak zorunda. Ekran okuyucuların kullandığı adlar ve roller, bir denetimi yazılım için de tanınır yapar. İki WCAG kuralı, mağazalarda sık görülen hatalar ve beş dakikalık bir kontrol.

Yazan [Specoria Ekibi](https://specoria.com/tr/hakkimizda/) 17 Kasım 2026 4 dk okuma

Bu yazıda

- [Erişilebilirlik ajanlar için neden önemli?](https://specoria.com/tr/icgoruler/tarayici-ajanlari-icin-erisilebilir-dugmeler/#erisilebilirlik-ajanlar-icin-neden-onemli)
- [En önemli iki WCAG kuralı](https://specoria.com/tr/icgoruler/tarayici-ajanlari-icin-erisilebilir-dugmeler/#en-onemli-iki-wcag-kurali)
- [Mağazalarda sık görülen hatalar](https://specoria.com/tr/icgoruler/tarayici-ajanlari-icin-erisilebilir-dugmeler/#magazalarda-sik-gorulen-hatalar)
- [Ne yapmalı?](https://specoria.com/tr/icgoruler/tarayici-ajanlari-icin-erisilebilir-dugmeler/#ne-yapmali)
- [Önce insanlara yardım eder](https://specoria.com/tr/icgoruler/tarayici-ajanlari-icin-erisilebilir-dugmeler/#once-insanlara-yardim-eder)
- [Beş dakikalık kontrol](https://specoria.com/tr/icgoruler/tarayici-ajanlari-icin-erisilebilir-dugmeler/#bes-dakikalik-kontrol)
- [Sonuç](https://specoria.com/tr/icgoruler/tarayici-ajanlari-icin-erisilebilir-dugmeler/#sonuc)

Bir insan için "sepete ekle" düğmesi açıktır: fiyatın altındaki, çanta simgeli büyük mor şekil. Yazılım içinse metni ve rolü olmayan, tıklama dinleyicili bir `div` olabilir. Ekran okuyucu onu hiçbir şey olarak okur. "Sepete ekle"yi arayan bir tarayıcı ajanı onu hiç bulamayabilir.

Bu yazıda erişilebilirlik ile ajan hazırlığının neden örtüştüğüne, mağaza denetimleri için en önemli iki WCAG kuralına ve düğmeleri yazılıma görünmez yapan hatalara bakıyoruz.

## Erişilebilirlik ajanlar için neden önemli?

Bir tarayıcı ajanı sayfada yardımcı teknolojiler gibi ilerler: her denetimin ne olduğunu (düğme, bağlantı, alan), adının ne olduğunu ("Sepete ekle", "Beden M") ve hangi durumda olduğunu (seçili, devre dışı) bilmesi gerekir. Ekran okuyucunun "Sepete ekle, düğme" demesini sağlayan bilgi, yazılımın düğmeyi tanımasını sağlayan bilgiyle aynıdır.

Kendi saha çalışmamızda ajanların takıldığı yerlerden biri, kapalı bir shadow DOM içine konmuş ve ajanın göremediği bir ödeme düğmesiydi; ajan ödeme adımına ancak adresi tahmin ederek ulaştı. Tanınamayan denetimler tam olarak bu türden tahmin ekler.

## En önemli iki WCAG kuralı

![Aynı sepete ekle denetimi iki kez: yalnız simgesi olan, adı ve rolü olmayan, yazılımın tanıyamadığı bir div; ve görünür Sepete ekle metnini adı olarak taşıyan, rolü düğme olan, durumunu bildiren ve yazılımın tanıyabildiği gerçek bir düğme öğesi](https://specoria.com/insights/fig/tarayici-ajanlari-icin-erisilebilir-dugmeler-1.svg) Yazılımın tanıyamadığı bir denetim ve tanıyabildiği bir denetim

Web İçeriği Erişilebilirlik Yönergeleri (WCAG 2.2), ajanların ihtiyacını tarif eden iki A düzeyi başarı ölçütü içeriyor:

- **4.1.2 Ad, Rol, Değer.** Betiklerle üretilenler dahil bütün arayüz bileşenlerinde ad ve rol programla belirlenebilir; kullanıcının ayarlayabildiği durum ve değerler programla ayarlanabilir. Düz söylersek: her denetim kodda ne olduğunu ve adını söyler.
- **2.5.3 Addaki Etiket.** Görünür metin etiketi olan bileşenlerde erişilebilir ad görünür metni içerir. W3C etiket metninin adın başında olmasını öneriyor. Düğmede "Sepete ekle" yazıyorsa adı da öyle olmalı; "btn-primary" ya da "Purchase CTA" değil.

A düzeyi en temel uygunluk düzeyi ve bu ikisi en temel ölçütlerden.

## Mağazalarda sık görülen hatalar

- ` ` yerine **rolü olmayan tıklanabilir `div` ve `span`'ler.**
- Sepet, istek listesi, kapat ve arama için metni ve `aria-label`'ı olmayan **yalnız simgeli düğmeler.**
- **Adı olmayan renk daireleri:** ajan "Lacivert"i "Siyah"tan ayıramaz.
- **Durumunu bildirmeyen beden düğmeleri:** hangi bedenin seçili, hangisinin tükenmiş olduğunu hiçbir şey söylemez.
- **Etiketle uyuşmayan adlar:** üzerinde "Hemen al" yazan, erişilebilir adı "submit" olan düğme.
- Sayfanın dışa açmadığı **kapalı shadow DOM ya da iframe içindeki denetimler.**
- ` ` ya da doğru etiketlenmiş bir liste kutusu yerine `div`'lerden kurulmuş **özel açılır listeler.**

## Ne yapmalı?

- **Yerel öğeleri kullanın:** eylemler için ` `, gezinme için ``, seçimler için `` ve ``. Rol ve klavye desteği hazır gelir. - **Her denetime görünür bir metin etiketi verin;** simge olması gerekiyorsa `aria-label` verin ve erişilebilir adın görünür metinle aynı olmasını sağlayın. - **Durumu bildirin:** seçili renk ve bedenler için `aria-pressed` ya da `aria-checked`, tükenmiş seçenekler için nedeni metinde yazılı `disabled`. - **Varyantlara sözle ad verin:** yalnız bir renk ya da kutu değil, "Renk: Lacivert", "Beden: M". - **Temel eylemleri kapalı shadow DOM'un ve başka kaynaktan gelen iframe'lerin dışında tutun** ya da adları ve rolleriyle dışa açıldıklarından emin olun. ## Önce insanlara yardım eder Bunların hiçbiri yalnız yazılım için değil. W3C'nin Addaki Etiket açıklaması insani nedeni veriyor: bilgisayarı sesle kullanan kişiler komutlarında görünür etiketleri kullanır. Düğmede "Sepete ekle" yazıyor ama adı "submit" ise "Sepete ekle'ye tıkla" demek hiçbir şey yapmaz. Ekran okuyucu kullananlar da aynı nedenle adlara, rollere ve durumlara dayanır. Bu, erişilebilirlik işini iki kez gerekçelendirmeyi kolaylaştırıyor: yardımcı teknoloji kullanan müşteriler için engelleri kaldırır ve aynı denetimleri bazı müşterilerin onların yerine gönderdiği ajanlar için kullanılabilir yapar. ## Beş dakikalık kontrol - Bir ürün sayfası açın ve art arda Tab'a basın. Beden seçeneklerine, sepete ekle düğmesine ve sepet bağlantısına yalnız klavyeyle ulaşabiliyor musunuz? - Tarayıcınızın erişilebilirlik denetleyicisini sepete ekle düğmesinde açın. Rol "button", ad "Sepete ekle" mi? - Bir renk dairesine ve tükenmiş bir bedene bakın. Adları ve durumları var mı? - İşletim sisteminizin ekran okuyucusunu bir dakikalığına açın ve ürün sayfasını dinleyin. Onun adlandıramadığı her şeyi bir ajan da bulamayabilir. ## Sonuç Erişilebilirlik ajan hazırlığından ayrı bir proje değil. Bir mağazayı ekran okuyucuyla kullanılabilir yapan adlar, roller ve durumlar, onu yazılımın kullanabileceği hale de getirir. Gerçek düğmeler kullanın, onları insanların gördüğü sözcüklerle etiketleyin, hangi seçeneğin seçili olduğunu bildirin; ikisine birden hizmet edersiniz. Specoria, testindeki eylem kontrolleri kapsamında sepete ekle düğmesinin ilk HTML'de olup olmadığını ve sepet düğmesinin erişilebilir olup olmadığını kontrol eder. Ücretsiz hazırlık testiyle başlayın.

### Kaynaklar

- W3C, [Understanding Success Criterion 4.1.2: Name, Role, Value](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html), WCAG 2.2, erişim 22 Ekim 2026.
- W3C, [Understanding Success Criterion 2.5.3: Label in Name](https://www.w3.org/WAI/WCAG22/Understanding/label-in-name.html), WCAG 2.2, erişim 22 Ekim 2026.
- Specoria İçgörüler, [Yapay zekâ ajanlarını gerçek tarayıcıda 40 kez alışverişe gönderdik](https://specoria.com/tr/icgoruler/yapay-zeka-ajanlarini-gercek-tarayicida-alisverise-gonderdik/)

## İlgili

- [UCP'ye hazırlık: bir profil dosyası ve beş yetenek, her biri mağazanızdaki bir veriye bağlı](https://specoria.com/tr/icgoruler/ucp-isletme-profili-ve-yetenekler/)
- [Ajanın yanlış okuyamayacağı para birimi ve dil: tek adres, tek fiyat, tek para birimi](https://specoria.com/tr/icgoruler/para-birimi-ve-dil/)
- [Tarayıcıların güvenebileceği site haritası: her gün değişen bir mağaza için dürüst lastmod tarihleri](https://specoria.com/tr/icgoruler/site-haritasi-ve-lastmod/)
- [Sepet düğmesi erişilebilir mi?](https://specoria.com/tr/yontem/kontroller/cart-accessible/) Kontrol: nasıl ölçtüğümüz ve nasıl düzeltileceği
- [Sepete ekle düğmesi ilk HTML’de](https://specoria.com/tr/yontem/kontroller/add-to-cart/) Kontrol: nasıl ölçtüğümüz ve nasıl düzeltileceği
- [Ajan ticareti istatistikleri](https://specoria.com/tr/ajan-ticareti-istatistikleri/) Alıntılanabilir, kaynaklı ve tarihli rakamlar
- [Ajan Hazırlık Endeksi 2027](https://specoria.com/tr/endeks/) Kıyaslanan mağazalar nasıl puan aldı, açık veriyle

ÜCRETSİZ TEST

## Mağazanız alışveriş ajanlarına hazır mı?

Bir alışveriş ajanının mağazanızı nasıl okuduğunu saniyeler içinde görün: ücretsiz, anında, e-posta gerekmez.

Ücretsiz test tarayıcınızda çalışır ve JavaScript gerektirir. [Bunun yerine ücretsiz derin denetimi e-postayla isteyin →](https://specoria.com/tr/#iletisim)

Sonucunuz kendi sayfasında açılır. Tamamını görmek isterseniz ücretsiz derin denetim ve panel e-postayla gelir.
