Əsas məzmuna keç
FrontDepth, Ana səhifə

Əlçatanlıq və i18n

ARIA, accessible name və fokus idarəetməsi

Brauzer səhifəni köməkçi texnologiyalara necə təqdim edir: semantik HTML, accessibility tree və accessible name-dən başlayıb ARIA rolları və state-lərinə, roving tabindex kimi klaviatura şablonlarına, modal dialoqlara, live region-lara və tətbiqdə fokus idarəetməsinə qədər.

JuniorMiddleSeniorYenilənib: 16 noyabr 2026

Oxu səviyyəsi

Seçilmiş səviyyəyə qədər olan bölmələr göstərilir.

Başlamazdan əvvəl

İlkin şərt yoxdur.

Bu mövzu Junior səviyyəsindən başlayır.

JuniorKonsepsiya

Semantik HTML və accessibility tree

Brauzer markup-dan ağacını, DOM-dan isə ikinci bir ağac qurur: accessibility tree (əlçatanlıq ağacı). Screen reader-lər, səslə idarəetmə proqramları və switch cihazları piksellərə baxmır. Onlar bu ağacı əməliyyat sisteminin accessibility API-si vasitəsilə oxuyur. Ağacdakı hər node-un rolu (button, link, heading, checkbox), adı ("Save", "Search"), state və property-ləri (pressed, expanded, checked, disabled), bəzi rollarda isə həm də dəyəri olur.

Native HTML elementləri bunların hamısını sənin yerinə doldurur:

HTML
<button type="button">Save</button>
<div class="btn" onclick="save()">Save</div>

<button> "Save" adlı button rolu ilə təqdim olunur. O, tab ardıcıllığındadır, Enter və Space onu işə salır, disabled atributu isə onu tab ardıcıllığından çıxarır və deaktiv kimi bildirir. <div> adi konteynerdir: rolu yoxdur, fokus almır, klaviaturadan işə düşmür. Siçanla işləyən istifadəçi iki eyni düymə görür. Klaviatura istifadəçisi ikincisinə çata bilmir, screen reader isə onu adi mətn kimi oxuyur.

Düzgün element sənə nə verir

  • <a href>: link. Fokus alır, Enter ilə açılır və screen reader-in linklər siyahısında görünür. href olmadan nə link sayılır, nə də fokus alır.
  • <button>: cari səhifədə hansısa əməliyyat, məsələn "Menyunu aç", "Sil" və ya "Növbəti slayd".
  • <label for> və <input>: adı olan sahə. Label-ə klikləmək sahəni də fokuslayır.
  • <h1>–<h6>, <nav>, <main>, <header>, <footer>: başlıqlar və landmark-lar. Screen reader istifadəçiləri bütün səhifəni dinləmək əvəzinə bunlar arasında keçid edir.
  • <ul> / <ol>: "list, 5 items" kimi oxunur, istifadəçi məzmunun nə qədər olduğunu bilir.
  • <dialog>, <details> / <summary>, <select>: klaviatura dəstəyi hazır olan tam widget-lər.

Faydalı qayda: link harasa aparır (URL dəyişir), button isə nəsə edir. Modal açan "link" və başqa səhifəyə keçirən "button" insanları çaşdırır: onlar bir şey eşidir, başqa şey alır.

Ağaca baxmaq

Chrome və Firefox DevTools-da seçilmiş elementin hesablanmış rolunu, adını və state-lərini göstərən Accessibility paneli var. Chrome isə Elements panelində DOM ağacının yerinə bütöv accessibility tree-ni də göstərə bilir. Screen reader gözləmədiyin nəsə oxuyursa, ilk baxmalı olduğun yer budur.

WCAG 2.2-nin 4.1.2 Name, Role, Value meyarı (A səviyyəsi) hər interfeys komponenti üçün məhz bu məlumatı tələb edir. Native HTML bunu default olaraq ödəyir; custom widget isə bunu özü təmin etməlidir, ARIA da elə burada lazım olur.

JuniorKonsepsiya

Kontrol accessible name-i haradan alır

Accessible name (əlçatan ad) fokus kontrola gələndə screen reader-in dediyi sözdür ("Search, edit text"). Səslə idarə edən istifadəçi kontrolu işə salmaq üçün də bu adı deyir ("click Search"), screen reader-in link və form sahələri siyahılarında da məhz bu ad görünür. Adın haradan götürüldüyünü Accessible Name and Description Computation (accname) spesifikasiyası müəyyən edir. Sadələşdirsək, boş olmayan mətn verən ilk mənbə qalib gəlir:

  1. aria-labelledby: istinad edilən elementlərin mətni, id-lərin sırası ilə. İstinad edilən element gizli olsa belə işləyir.
  2. aria-label: elementin özündə yazılmış sətir.
  3. Native label: form sahələri üçün <label>, <img> üçün alt, cədvəl üçün <caption>, fieldset üçün <legend>.
  4. Məzmun: adını məzmundan alan rollarda (button, link, heading, tab və s.) daxili elementlərin mətni, içindəki şəkillərin alt-ı da daxil olmaqla.
  5. title, ən son variant kimi. Mətn sahələri üçün HTML-AAM title-dan sonra placeholder-i də əlavə edir.
HTML
<button type="button" aria-label="Close dialog">
  <svg aria-hidden="true" viewBox="0 0 16 16">…</svg>
</button>

<h2 id="billing-title">Billing address</h2>
<section aria-labelledby="billing-title">…</section>

<label for="email">Email</label>
<input id="email" type="email" autocomplete="email" aria-describedby="email-hint">
<p id="email-hint">We send the receipt here.</p>

<a href="/cart"><img src="/icons/cart.svg" alt="Cart"></a>

aria-describedby təsvir (description) əlavə edir: o, addan və roldan sonra oxunur. Köməkçi mətnlər və xəta mesajları üçün düzgün yer budur, ad isə qısa qalır.

Tez-tez rast gəlinən səhvlər

  • Adı olmayan, yalnız ikondan ibarət düymələr. <button><svg>…</svg></button> sadəcə "button" kimi oxunur. Düyməyə aria-label (və ya vizual gizlədilmiş mətn) ver, dekorativ ikonu isə aria-hidden="true" ilə işarələ.
  • Label əvəzinə placeholder. İstifadəçi yazmağa başlayan kimi yox olur, adətən kontrastı zəifdir və ad hesablanmasında yalnız ən son ehtiyat variantdır. Görünən <label> saxla, placeholder-dən ən çoxu nümunə format üçün istifadə et.
  • Görünən mətnlə ziddiyyət təşkil edən ad. WCAG 2.5.3 Label in Name (A səviyyəsi): kontrolun görünən mətn label-i varsa, accessible name bu mətni ehtiva etməlidir, ən yaxşısı lap əvvəldə. Üstündə "Buy" yazılan, adı isə "Add product to basket" olan düymə səslə idarəetmədə işləmir: istifadəçi "click Buy" deyir və heç nə baş vermir.
  • Adi <div> və ya <span> üzərində aria-label. WAI-ARIA 1.2 generic rolunu (və paragraph kimi başqalarını) adlandırmağı qadağan edir, ona görə screen reader bu adı nəzərə almaya bilər. Ad interaktiv elementlərə, landmark-lara, şəkillərə və oxşar rollara aiddir.
  • "Read more" adlı on link. Linklər siyahısında onları bir-birindən ayırmaq olmur. Elementin adını link mətninə daxil et: görünən şəkildə və ya vizual gizlədilmiş mətn kimi.

Bu platformadakı Signup form və Product grid challenge-ları əsasən adlar haqqındadır: problemlərin bir hissəsini axe tapır, qalanları isə yalnız səhifəni Tab ilə gəzib hər kontrolun əslində necə adlandığını yoxlayanda üzə çıxır.

JuniorVeb platforma

Klaviatura ilə istifadə, tab ardıcıllığı və görünən fokus

Çox insan heç vaxt siçandan istifadə etmir: yalnız klaviatura ilə işləyənlər, screen reader istifadəçiləri, həmçinin switch cihazı və ya səslə idarəetmə ilə işləyənlər — bunlar da arxa planda klaviatura interfeysindən istifadə edir. WCAG 2.1.1 Keyboard (A səviyyəsi) bütün funksionallığın klaviaturadan işləməsini, 2.1.2 No Keyboard Trap (A səviyyəsi) isə fokusun istənilən komponentdən çıxa bilməsini tələb edir.

Gözlənilən düymələr:

  • Tab / Shift+Tab interaktiv elementlər arasında keçir.
  • Enter linki açır və düyməni işə salır; Space düyməni işə salır və checkbox-u dəyişir.
  • Ox düymələri composite widget-lərin içində hərəkət edir: radio qrupları, tab-lar, menyular, listbox-lar.
  • Escape dialoqları, menyuları və popup-ları bağlayır.

Tab ardıcıllığı və tabindex

Ardıcıl fokus sırası fokuslana bilən elementlərin DOM-dakı sırasıdır. tabindex elementin fokuslanmasını dəyişir:

HTML
<div role="button" tabindex="0">In the tab order, at its DOM position</div>
<h1 tabindex="-1">Focusable from script only</h1>
<input tabindex="3">
  • tabindex="0" elementi DOM-dakı yerində tab ardıcıllığına əlavə edir. Bunu rolu və klaviatura idarəsi olan custom widget üçün işlət. Adi mətni fokuslanan etmək yalnız lazımsız dayanacaqlar yaradır.
  • tabindex="-1" elementi element.focus() ilə fokuslanan edir, amma Tab onu keçib gedir. Fokus hədəfləri (yeni görünüşün başlığı, xətaların xülasəsi) və roving tabindex-in aktiv olmayan elementləri üçün işlədilir.
  • Müsbət dəyərlər (1 və yuxarı) hər şeydən əvvəl, rəqəm sırası ilə gəzilir. APG bunlardan qəti şəkildə çəkinməyi tövsiyə edir: bir müsbət dəyər bütün səhifənin sırasını dəyişir və markup dəyişən kimi pozulur. WCAG 2.4.3 Focus Order (A səviyyəsi) mənanı qoruyan sıra tələb edir, ona görə sıranı DOM-u düzəltməklə düzəlt.

Blokları yerini dəyişən CSS (order, flex-direction: row-reverse, grid-də yerləşdirmə) yalnız vizual sıranı dəyişir, fokus isə yenə DOM-u izləyir. Bu ikisi fərqlənəndə klaviatura istifadəçisi fokusun ora-bura atıldığını görür.

Native disabled kontrol tab ardıcıllığından çıxır. aria-disabled="true" isə onu fokuslanan saxlayır: istifadəçi kontrolu tapa və niyə əlçatan olmadığını oxuya bilir, amma onda işə düşməsinin qarşısını özün almalısan.

Görünən fokus

WCAG 2.4.7 Focus Visible (AA səviyyəsi): klaviatura istifadəçisi fokusun harada olduğunu görməlidir. Klassik bug reset stylesheet-dəki *:focus { outline: none; } sətridir. Bunun əvəzinə :focus-visible-ı stilləşdir (Baseline, mart 2022-dən geniş əlçatandır). Brauzer onu klaviatura fokusu (və çox vaxt skriptlə köçürülmüş fokus) üçün tətbiq edir, düyməyə siçanla klikləyəndən sonra isə adətən yox:

CSS
:focus-visible {
  outline: 3px solid var(--focus-ring);
  outline-offset: 2px;
}

WCAG 2.2 həmçinin 2.4.11 Focus Not Obscured (Minimum) (AA səviyyəsi) meyarını əlavə etdi: fokuslanmış element sənin öz məzmunun, məsələn sticky header və ya cookie banner tərəfindən tamamilə örtülməməlidir. Header-in hündürlüyünə bərabər scroll-padding-top görünüşə gətirilən elementləri header-in altında saxlayır.

MiddleKonsepsiya

ARIA: rollar, state-lər, property-lər və istifadə qaydaları

WAI-ARIA yalnız accessibility tree-nin nə bildirdiyini dəyişən atributlar toplusudur. role rolu təyin edir. aria-* atributları isə istifadə zamanı dəyişən state-ləri (aria-expanded, aria-selected, aria-checked, aria-pressed, aria-invalid, aria-current) və əlaqələri təsvir edən, nadir hallarda dəyişən property-ləri (aria-controls, aria-labelledby, aria-describedby, aria-haspopup) təyin edir.

ARIA heç bir davranış əlavə etmir. role="button" <div>-i fokuslanan etmir, Enter-i klikə çevirmir və görünüşünü dəyişmir. APG bunu "rol bir vəddir" (a role is a promise) kimi ifadə edir: istifadəçiyə həmin rolun klaviatura davranışını vəd edirsən, sonra da onu yazmalı olursan.

HTML
<div role="button" tabindex="0" aria-pressed="false">Bold</div>

<button type="button" aria-pressed="false">Bold</button>

div-ə hələ də Enter və Space üçün keydown handler, deaktiv vəziyyət və fokus stilləri lazımdır. button-da isə bunların hamısı artıq var; toggle düyməyə çevrilməsi üçün ona yalnız aria-pressed lazım idi.

ARIA-dan istifadə qaydaları

W3C-nin Using ARIA sənədi dörd qayda sadalayır:

  1. Lazım olan semantika və davranışı olan native HTML elementindən istifadə edə bilirsənsə, ondan istifadə et. Bu, "ARIA-nın birinci qaydası"dır.
  2. Native semantikanı, həqiqətən məcbur deyilsənsə, dəyişmə. <h2 role="tab"> başlıq olmaqdan çıxır. <button>-u başlığın içinə qoy və ya rolu wrapper-ə ver.
  3. Bütün interaktiv ARIA kontrolları klaviatura ilə işləməlidir. role="slider" əlavə edirsənsə, ox düymələrini də yazmalısan.
  4. Fokuslanan elementdə role="presentation" və ya aria-hidden="true" işlətmə. Klaviatura istifadəçisi screen reader üçün mövcud olmayan bir şeyin üstünə düşər.

APG də "No ARIA is better than bad ARIA" başlığı altında eyni fikri deyir: səhv ARIA interfeysi ona güvənən insanlara yanlış təqdim edir, bu isə ümumiyyətlə ARIA olmamasından daha pisdir.

State-lər UI-ı izləməlidir

ARIA state-ləri istifadəçi ilə müqavilədir. İnterfeys dəyişəndə atribut da onunla birlikdə dəyişir: menyu açıq olduqca menyu düyməsində aria-expanded, yalnız bir tab-da aria-selected="true", cari səhifənin naviqasiya linkində aria-current="page". Tez-tez rast gəlinən bug: atribut markup-da bir dəfə yazılır və heç vaxt yenilənmir, nəticədə screen reader açıq menyu üçün "collapsed" deyir. React-də atributu UI-ı idarə edən eyni state-dən çıxar:

JSX
function FiltersToggle({ open, onToggle }) {
  return (
    <button
      type="button"
      aria-expanded={open}
      aria-controls="filters"
      onClick={onToggle}
    >
      Filters
    </button>
  );
}

React boolean dəyəri "true" və ya "false" sətri kimi render edir, ARIA da məhz bunu gözləyir.

Atributun həmin rol üçün mövcud olub-olmadığını da yoxla: aria-checked checkbox, radio və switch-lərə, aria-selected isə tab, option və grid xanalarına aiddir. Rolun dəstəkləmədiyi atributları həm axe, həm də Accessibility paneli göstərir.

MiddleNümunə

Composite widget-lər: tab-lar və roving tabindex

Çoxlu elementdən ibarət widget-lər (tab-lar, radio qrupları, menyular, listbox-lar, toolbar-lar, grid-lər) composite widget adlanır. Tab widget-in içinə bir dəfə girir və ondan bir dəfə çıxır, içindəki elementlər arasında isə ox düymələri ilə hərəkət edilir. Səkkiz tab-ı olan tablist səkkiz yox, bir Tab dayanacağı tutur.

APG-nin Tabs şablonu:

  • Konteynerin role="tablist" rolu və adı var; hər tab-da role="tab", aria-selected və aria-controls olur; hər panelin role="tabpanel" rolu və öz tab-ına istinad edən aria-labelledby-ı olur.
  • Tab fokusu aktiv tab-a gətirir, növbəti Tab isə panelə keçir. İçində fokuslanan elementi olmayan panel tabindex="0" alır ki, onun mətninə çatmaq mümkün olsun.
  • Sol / sağ ox əvvəlki / növbəti tab-a keçir və sonlarda dövrə vurur; Home və End (istəyə bağlı) birinci və sonuncu tab-a atlayır.
  • Avtomatik aktivləşmə (fokus hərəkət etdikcə panel dəyişir) panellər gözə çarpan gecikmə olmadan göstərilirsə tövsiyə olunur. Panel əvvəlcə yüklənməlidirsə, əl ilə aktivləşmə seç: oxlar fokusu daşıyır, Enter və ya Space seçir.

Roving tabindex

Yalnız bir tab-da tabindex="0" olur: seçilmiş tab-da. Qalanlarının hamısında tabindex="-1" olur. Ox düymələri 0-ı yeni tab-a keçirir və onun üzərində focus() çağırır:

JSX
function Tabs({ tabs }) {
  const [active, setActive] = useState(0);
  const refs = useRef([]);

  function onKeyDown(event) {
    const last = tabs.length - 1;
    const next = {
      ArrowRight: active === last ? 0 : active + 1,
      ArrowLeft: active === 0 ? last : active - 1,
      Home: 0,
      End: last,
    }[event.key];
    if (next === undefined) return;
    event.preventDefault();
    setActive(next);
    refs.current[next].focus();
  }

  return (
    <>
      <div role="tablist" aria-label="Account settings" onKeyDown={onKeyDown}>
        {tabs.map((tab, i) => (
          <button
            key={tab.id}
            ref={(el) => {
              refs.current[i] = el;
            }}
            type="button"
            role="tab"
            id={`tab-${tab.id}`}
            aria-selected={i === active}
            aria-controls={`panel-${tab.id}`}
            tabIndex={i === active ? 0 : -1}
            onClick={() => setActive(i)}
          >
            {tab.label}
          </button>
        ))}
      </div>
      {tabs.map((tab, i) => (
        <div
          key={tab.id}
          role="tabpanel"
          id={`panel-${tab.id}`}
          aria-labelledby={`tab-${tab.id}`}
          tabIndex={0}
          hidden={i !== active}
        >
          {tab.content}
        </div>
      ))}
    </>
  );
}

Bu, avtomatik aktivləşmədir: fokusun yerini dəyişmək həm də seçim edir. tabIndex={0} yalnız seçilmiş tab-da olduğu üçün kənardan gələn Tab həmişə məhz onun üzərinə düşür.

aria-activedescendant

Alternativ yol DOM fokusunu konteynerdə saxlayır və aria-activedescendant-a "aktiv" elementin id-sini yazır; köməkçi texnologiya həmin elementi fokuslanmış sayır. Vurğulamanı özün çəkirsən və elementi özün görünüşə gətirirsən. Combobox üçün adi seçim budur: oxlar variantlar arasında gəzərkən fokus mətn sahəsində qalmalıdır. Elementlərin özləri fokus ala bilirsə, roving tabindex daha sadədir.

Aktiv olmayan panelləri gizlətmək

Aktiv olmayan panellər sadəcə görünməz olmamalı, hamı üçün aradan qalxmalıdır: hidden, ümumiyyətlə render etməmək və ya vizual gizlətmənin üstündən inert (animasiyalı keçid üçün). Yalnız opacity: 0 və ya aria-hidden ilə gizlədilmiş panellərin link və düymələri tab ardıcıllığında qalır.

Tabs challenge-ı sənə düzəltmək üçün yarımçıq tab widget-i verir.

SeniorVeb platforma

Məzmunu gizlətmək və dəyişiklikləri elan etmək

"Gizli" sözü üç fərqli şey deməkdir və bunları qarışdırmaq çoxlu bug-a səbəb olur:

ÜsulGörünürAccessibility tree-dədirFokus alır
hidden, display: none, visibility: hiddenyoxyoxyox
aria-hidden="true"bəliyoxbəli
vizual gizlədən CSSyoxbəlibəli
opacity: 0, sıfır hündürlük, ekrandan kənara çıxarmaqyoxbəlibəli
inertbəliyoxyox
  • hidden / display: none məzmunu hamı üçün aradan qaldırır: bağlı menyular, aktiv olmayan tab panelləri. Tələ: hidden brauzerin öz display: none qaydası ilə işləyir və .panel { display: grid; } kimi istənilən müəllif qaydası onu üstələyir, nəticədə "gizli" panel yenidən görünür. Baza stillərinə [hidden] { display: none !important; } əlavə et.
  • aria-hidden="true" məzmunu yalnız köməkçi texnologiyadan gizlədir: mətnin yanındakı dekorativ ikonlar, artıq elan olunmuş bir şeyin vizual təkrarı. Heç vaxt fokuslanan elementdə və ya onu ehtiva edən konteynerdə işlətmə (ARIA-nın dördüncü qaydası).
  • Vizual gizlədilmiş mətn yalnız screen reader üçündür, məsələn "Read more about the Trail backpack" və ya fokus alanda görünən skip link:
CSS
.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  margin: -1px;
  padding: 0;
  overflow: hidden;
  clip-path: inset(50%);
  white-space: nowrap;
  border: 0;
}

Live region-lar

Məzmun dəyişəndə fokus yerindən tərpənmirsə ("Saved" toast-ı, axtarış nəticələrinin sayı, asinxron yoxlamadan sonra çıxan xəta), screen reader heç nə demir. O, dəyişikliyi yalnız live region içində baş verəndə elan edir:

HTML
<div id="cart-status" role="status" class="visually-hidden"></div>
JavaScript
async function addToCart(product) {
  await api.addToCart(product.id);
  document.getElementById("cart-status").textContent = `${product.name} added to cart`;
}
  • role="status"-un implicit dəyərləri aria-live="polite" və aria-atomic="true"-dur: mesaj istifadəçi boş olanda oxunur. Mesajların çoxu üçün bunu işlət. WCAG 4.1.3 Status Messages (AA səviyyəsi) status mesajlarının rol və ya property vasitəsilə təqdim olunmasını tələb edir ki, köməkçi texnologiya onları fokusu köçürmədən çatdıra bilsin.
  • role="alert" assertive-dir (aria-live="assertive", aria-atomic="true") və o an oxunan hər şeyi kəsir. Onu təcili, vaxta həssas xətalar üçün saxla.
  • Region dəyişiklikdən əvvəl mövcud olmalıdır. Screen reader artıq tanıdığı region-dakı dəyişiklikləri elan edir. Onu bir dəfə, boş halda render et (məsələn, layout-da), sonra mətnini dəyiş. <div role="status">Saved</div>-i bir addımda əlavə etmək çox vaxt eşidilmir; MDN qeyd edir ki, role="alert" istisnadır və sonradan əlavə olunanda da elan edilir.
  • Az elan et. Hər hadisəyə bir qısa mesaj, hər düymə basışına elan yox (canlı nəticə sayına tətbiq et), daim dəyişən məzmunun, məsələn işləyən saatın ətrafında live region yox.
SeniorTipik səhvlər

Dinamik tətbiqlərdə fokus və avtomatik yoxlamaların görmədikləri

Single-page tətbiqdə DOM istifadəçinin gözü qarşısında dəyişir. Fokuslanmış element silinəndə document.activeElement <body> olur: növbəti Tab səhifənin lap əvvəlindən başlayır, screen reader isə ümumiyyətlə heç nə deməyə bilər. UI-ın fokuslanmış elementi sildiyi və ya əvəzlədiyi hər yerdə qərar lazımdır.

  • Fokusdakı elementin silinməsi. Fokusu növbəti elementə, element sonuncu idisə əvvəlkinə, siyahı boşalıbsa siyahının başlığına köçür.
  • Route dəyişikliyi. Yeni görünüş səhifə yüklənmədən çıxır, ona görə heç nə elan olunmur. Onun <h1>-ini (tabindex="-1" ilə) fokusla, document.title-ı yenilə və ya səhifəni live region-da elan et. Next.js-də hazır route announcer var: o, əvvəlcə document.title-ı, sonra <h1>-i, sonra pathname-i oxuyur. Klient tərəfində routing mövzusu bunu ətraflı izah edir.
  • Popover, menyu və inline redaktorların bağlanması. Fokusu trigger-ə qaytar: "Save"-dən sonra yenidən görünən "Edit" düyməsini fokusla.
  • "Load more" və sonsuz siyahılar. Fokusu birinci yeni elementə köçür və ya düymədə saxla və neçə element əlavə olunduğunu elan et.
  • Form xətaları. Uğursuz göndərişdən sonra birinci səhv sahəni və ya sahələrə link verən xəta xülasəsini fokusla; hər mesajı aria-describedby ilə öz sahəsinə bağla və aria-invalid="true" təyin et.
JavaScript
function removeTodo(button) {
  const buttons = [...list.querySelectorAll("button.remove")];
  const i = buttons.indexOf(button);
  const next = buttons[i + 1] ?? buttons[i - 1];
  button.closest("li").remove();
  (next ?? listHeading).focus();
}

listHeading-in tabindex="-1" atributu var: o, skriptdən fokus ala bilir, amma Tab dayanacağına çevrilmir. React-də eyni məntiqi state yeniləndikdən sonra işə sal, məsələn fokuslanacaq id-ni yadda saxla və siyahı yenidən render olunandan sonra effektdə focus() çağır.

Avtomatik yoxlamalar nəyi tapır, nəyi tapmır

Lighthouse-un accessibility auditi də daxil olmaqla, axe-core DOM üzərində qaydaları yoxlayır: çatışmayan adlar, rolun dəstəkləmədiyi ARIA atributları, kontrast, təkrarlanan id-lər, label-i olmayan sahələr. Onu hazırlayan Deque şirkəti deyir ki, axe-core WCAG problemlərinin orta hesabla 57%-ni avtomatik tapır, bəzi nəticələri isə əl ilə yoxlanmaq üçün "incomplete" kimi qeyd edir. Onun qiymətləndirə bilmədiyi şeylər:

  • fokus sırası məntiqlidirmi, dialoq bağlananda fokus geri qayıdırmı;
  • widget-də ox düymələri işləyirmi, Escape onu bağlayırmı;
  • ad sadəcə mövcuddur, yoxsa həqiqətən mənalıdır ("button 1", "image");
  • live mesaj düzgün anda və bir dəfə elan olunurmu.

A11y Hunt challenge-larında axe problemlərinin yalnız klaviatura ilə gəzəndə üzə çıxan problemlərlə qarışıq verilməsinin səbəbi budur. Praktik qayda: reqressiyaları tutmaq üçün lint (eslint-plugin-jsx-a11y) və komponent və end-to-end testlərində axe, sonra hər kritik axın üçün klaviatura ilə yoxlama (hamısını Tab ilə keç, hər widget-i aç və bağla, siçana toxunma), Accessibility panelində adlara baxış və VoiceOver və ya NVDA kimi screen reader ilə sınaq.

SeniorMüsahibə məsləhətləri

Müsahibə üçün məsləhətlər

30 saniyəlik cavab. "Köməkçi texnologiya accessibility tree-ni oxuyur: rol, ad, state. Semantik HTML bu ağacı doldurur və klaviatura dəstəyini pulsuz verir, ona görə mən oradan başlayıram. ARIA yalnız ağacın nə bildirdiyini dəyişir və heç bir davranış əlavə etmir, ona görə onu custom widget-lərdəki boşluqları doldurmaq üçün işlədirəm və state-lərini UI ilə sinxron saxlayıram. Sonra fokusu idarə edirəm: həmişə görünən, məntiqli sırada, məzmun açılanda, bağlananda və ya yox olanda isə şüurlu şəkildə köçürülən."

Gözlənilən suallar

  • Bu kliklənən div-i əlçatan et. Ən yaxşı cavab: onu <button> ilə əvəz et. Həqiqətən mümkün deyilsə, sonra sənin üzərinə düşən hər şeyi sadala: rol, tabindex="0", Enter və Space, deaktiv vəziyyət, fokus stilləri.
  • Screen reader bu düymənin adını haradan bilir? Adın hesablanması: aria-labelledby, aria-label, native label və ya alt, məzmun, title. 2.5.3 Label in Name meyarını da qeyd et.
  • Əlçatan modal qur. showModal() ilə <dialog> və ya əl ilə: rol, aria-modal, ad, səhifədə inert, Escape, fokusun içəri gəlməsi və geri qayıtması. İlkin fokusu niyə məhz ora verdiyini izah et.
  • Tab-lar və ya menyu üçün klaviatura dəstəyi. Bir Tab dayanacağı, içəridə oxlar, roving tabindex və ya aria-activedescendant, avtomatik və əl ilə aktivləşmə.
  • aria-hidden, display: none və vizual gizlətmə. Hər biri məzmunu kimdən gizlədir və fokuslanan məzmunda aria-hidden niyə bug-dır.
  • "Saved" mesajını necə elan edərsən? Əvvəlcədən mövcud olan live region, role="status", mətn sonradan dəyişdirilir.
  • Əlçatanlığı necə test edirsən? Avtomatik yoxlamalar, üstəlik klaviatura ilə gəzinti, Accessibility paneli və screen reader; avtomatika problemlərin yalnız bir hissəsini tapır.

Bal itirdən səhvlər

  • "Əlçatan olsun deyə ARIA əlavə et." Davranışı olmayan ARIA pozulmuş vəddir, səhv ARIA isə heç olmamasından pisdir.
  • Əvəzində başqa fokus stili vermədən outline: none.
  • Sıranı DOM-u düzəltmək əvəzinə müsbət tabindex ilə "düzəltmək".
  • Hər yerdə aria-label: adi div-lərdə və ya görünən mətni başqa sözlərlə əvəz edərək.
  • Lighthouse-da 100 balı "əlçatandır" kimi qəbul etmək.

Senior səviyyəni göstərən məqamlar

Ayrı-ayrı düzəlişlərdən yox, sistemdən danış: məhsul komandaları yenidən yazmasın deyə design system-də əlçatan primitivlər (dialog, tabs, menu, combobox); CI-da lint və axe, kritik axınlar üçün klaviatura testləri; bütün tətbiq üçün route dəyişikliklərində vahid fokus siyasəti. Hədəfi adlandır, adətən WCAG 2.2 AA səviyyəsi, və tətbiq olunduğu yerlərdə hüquqi konteksti, məsələn 28 iyun 2025-ci ildən qüvvədə olan European Accessibility Act-i.

JuniorYoxlama siyahısı

ARIA-nı və fokus idarəetməsini review edərkən nəyi yoxlamalı

Bu siyahını özün yazmadığın UI kodunda işlət: komanda yoldaşının pull request-i, kitabxananın komponenti və ya AI assistentinin təklifi. Siçanla işləyən səhifə klaviatura ilə əlçatmaz, screen reader üçün isə səssiz ola bilər, axe də bunun yalnız bir hissəsini tutur.

  • Kliklənən hər element native-dirmi: əməliyyat üçün <button>, keçid üçün <a href>? <div onclick>-in nə Tab dayanacağı, nə Enter və Space dəstəyi, nə də rolu olur. Siçanı kənara qoy və dəyişikliyi Tab ilə keç.
  • Hər kontrolun görünən mətnini ehtiva edən mənalı adı varmı? Hesablanmış ada DevTools-un Accessibility panelində bax; sadəcə "button" və ya ekrandakı yazıdan fərqli ad screen reader və səslə idarəetmə istifadəçiləri üçün işləmir.
  • Hər role həmin rolun davranışı ilə birlikdə gəlirmi? ARIA yalnız accessibility tree-nin nə bildirdiyini dəyişir: div-dəki role="button"-a yenə də tabindex="0", Enter və Space lazımdır.
  • Fokus həmişə görünürmü? Əvəzində başqa fokus stili verilməyən outline: none axtar, fokusu :focus-visible ilə stilləşdir və sticky header-in fokuslanmış elementi gizlətmədiyini yoxla.
  • Nəsə açılanda, bağlananda və ya silinəndə fokus hara gedir? Fokusdakı element silinəndə document.activeElement <body> olur və növbəti Tab səhifənin lap əvvəlindən başlayır. Hər əməliyyatdan sonra document.activeElement-i konsola çıxar; bağlanan menyu fokusu öz trigger-inə qaytarmalıdır.
  • ARIA state-ləri UI-ı izləyirmi? aria-expanded, aria-selected və aria-pressed UI-ı idarə edən state-dən gəlməlidir. Kontrolun vəziyyətini dəyiş və Accessibility panelinə bax.
  • Tab ardıcıllığı vizual sıraya uyğundurmu, görünməyən məzmunda dayanacaq yoxdurmu? Müsbət tabindex bütün səhifənin sırasını dəyişir, CSS order yalnız blokların yerini dəyişir, fokus isə izləyir; opacity: 0 və ya aria-hidden ilə gizlədilmiş məzmun da fokus almağa davam edir.

Özünü yoxla

  • Məşq

    Kodun nəticəsini təxmin et, açıq müsahibə suallarına cavab ver və özünü qiymətləndir.

    3 nəticə sualı · 3 açıq sual

  • Quiz

    İzahlı test sualları və yekun nəticə.

    6 sual

Bu mövzudan istifadə edən praktiki işlər.