control-name-title-only
Ein Button oder Link sollte seinen Namen nicht nur aus seinem title beziehen
Markiert einen Button oder Link, dessen einziger zugänglicher Name sein title-Attribut ist, das nur beim Überfahren mit der Maus angezeigt wird, zur manuellen Prüfung.
Anwendbarkeit. Buttons und Links im Accessibility Tree mit einem nicht leeren title-Attribut: <a href>, <area href>, <button>, <input> vom Typ button, submit, reset oder image sowie Elemente, denen ihr role-Attribut oder ihre ElementInternals die Rolle button oder link geben.
Erwartung. Die Berechnung des zugänglichen Namens (Accessible Name Computation) nimmt einen title nur dann als Namen, wenn nichts anderes das Element benennt: eine Benennung durch den Autor (aria-labelledby, aria-label), das alt eines Bild-Buttons, der value eines Input-Buttons oder, bei Buttons und Links, ihr Inhalt.
- Etwas anderes als der title benennt das Steuerelement: pass. Der title ist seine Beschreibung, ein Tooltip.
- Der title ist sein einziger Name: cantTell (
NAME_FROM_TITLE_ONLY).
Der Name ist gültig, 4.1.2 ist also erfüllt, aber ein title wird nur beim Überfahren mit der Maus angezeigt: nicht auf Touchscreens, nicht, wenn das Steuerelement den Fokus über die Tastatur erhält, und nicht als Text, den eine Person, die Spracheingabe nutzt, lesen und aussprechen kann. Prüfen Sie, ob das Steuerelement sichtbaren Text erhalten kann oder, wenn es nur ein Icon zeigt, ein aria-label, wobei der title auf Wunsch als Tooltip bleibt.
Was ein Befund meldet.
role: die Rolle des Steuerelements,buttonoderlink.
Diese Felder in data.details helfen, einen Befund zu lesen und zu reproduzieren. Außer reasonCode und den wenigen Feldern, die Ausgabeschema als stabil nennt, sind sie kein stabiler Vertrag: Ein Feld kann in einer Minor-Version umbenannt werden oder wegfallen, bauen Sie also nicht darauf auf.
Beispiele
<button title="Save the draft">Save</button>
Der Text des Buttons benennt ihn; der title ist ein Tooltip.
<button title="Close"><svg aria-hidden="true" width="12" height="12"></svg></button>
Der title ist der einzige Name des Buttons und wird nur beim Überfahren mit der Maus angezeigt. Eine Person prüft, ob er sichtbaren Text oder ein aria-label erhalten kann.
So prüfen Sie es
Wenn diese Regel nicht entscheiden kann, meldet sie cantTell und überlässt die Frage einer Person. Jede Frage, die sie stellen kann, steht hier unter ihrem Reason-Code, mit den Schritten, um sie zu beantworten. Ein Befund enthält dieselben Schritte in howToCheck, in der Sprache des Scans. Siehe Ausgabeschema.
NAME_FROM_TITLE_ONLY
- Betrachten Sie die im Bericht genannte Schaltfläche oder den Link, ohne mit dem Zeiger darüberzufahren.
- Entscheiden Sie, ob das, was sie zeigt (Text oder ein Symbol), ihren Zweck klar macht.
- Springen Sie mit der Tastatur per Tab darauf und beachten Sie, dass der title-Tooltip nicht erscheint.
Bestanden. Der Zweck des Bedienelements geht aus dem Gezeigten klar hervor, oder es erhält sichtbaren Text oder ein aria-label, wobei der title als Tooltip erhalten bleibt.
Nicht bestanden. Der Zweck wird nur durch einen title erklärt, den Nutzende von Tastatur, Touch und Spracheingabe nie sehen (Best Practice, accname 1.2).