Labeli deialog

Mae Silktide yn gwirio bod deialogau - ffenestri naid sy'n ymddangos dros y dudalen - yn datgan enw y gellir ei ddarllen yn uchel gan , fel bod pobl yn gwybod beth sydd newydd agor.

Caiff deialog ei marcio yn drwy roi'r rôl dialog i elfen. Mae'r rôl yn dweud wrth dechnoleg gynorthwyol fod ffenestr ar wahân wedi ymddangos, ond ar ei phen ei hun nid yw'n dweud at beth y mae'r ffenestr.

<!-- Problem: deialog heb enw hygyrch -->
<div role="dialog">
  <p>Mae eich sesiwn ar fin dod i ben.</p>
</div>

Pam mae hyn yn bwysig

Pan fydd deialog yn agor, mae yn ei chyhoeddi ac yn symud ffocws yr ymwelydd i'w mewn. Os oes gan y deialog enw, mae'r gwrandäwr yn clywed rhywbeth fel "Sesiwn wedi dod i ben, deialog" ac yn deall yr ymyrraeth ar unwaith. Heb enw, dim ond "deialog" y maent yn ei glywed - maent wedi cael eu tynnu oddi wrth yr hyn yr oeddent yn ei wneud heb esboniad, ac mae'n rhaid iddynt archwilio'r cynnwys i ddarganfod pam.

Sut i'w drwsio

Rhowch i bob deialog, gan ddefnyddio un o'r canlynol:

aria-labelledby sy'n pwyntio at id teitl gweladwy'r deialog - yr opsiwn gorau, gan fod ymwelwyr sy'n gweld yn gweld yr un enw:

<!-- Wedi'i drwsio: caiff y deialog ei henwi gan ei phennawd -->
<div role="dialog" aria-labelledby="timeout-title">
  <h2 id="timeout-title">Sesiwn wedi dod i ben</h2>
  <p>Mae eich sesiwn ar fin dod i ben.</p>
</div>

aria-label gyda'r enw fel testun, pan nad oes gan y deialog deitl gweladwy:

<div role="dialog" aria-label="Sesiwn wedi dod i ben">
  ...
</div>

Sut mae Silktide yn profi hyn

Dod o hyd i bob elfen ar bob tudalen y mae ei role yn dialog.
Canfod enw hygyrch pob deialog, o briodoleddau megis aria-label ac aria-labelledby.
Rhoi gwybod am bob deialog y mae ei enw hygyrch ar goll neu'n wag.

Datrys problemau

Dim ond ar ôl rhyngweithio gan ddefnyddiwr y mae fy neialog yn ymddangos

Mae Silktide yn archwilio pob tudalen wrth iddi lwytho. Efallai na chaiff deialog sy'n cael ei hychwanegu at y dudalen yn ddiweddarach - er enghraifft ar ôl clicio botwm - ei phrofi, ond mae angen tag arni o hyd ar gyfer ymwelwyr sy'n ei chyrraedd.

Rwy'n defnyddio'r elfen deialog frodorol

Mae'r gwiriad hwn yn archwilio elfennau sy'n datgan role="dialog" yn benodol. Ni chaiff element <dialog> frodorol heb y rôl honno ei phrofi, ond mae'r canllawiau'n dal i fod yn berthnasol: rhowch enw hygyrch iddi gyda aria-labelledby neu aria-label.