input-image-alt-decorative
<input type="image"> with alt="" must be appropriate (manual review)
Flags <input type="image"> elements with empty alt for human review (usually not appropriate for functional controls).
Applies to. Applies to <input type="image"> elements whose alt attribute is present but empty once trimmed, and which still carry a name from another source: an ARIA name resolving to non-empty text, or a title. Without that other name there is nothing to weigh the empty alt against, and the control is input-image-alt-present's failure instead. The element must be included in the accessibility tree, and role="presentation"/"none" takes it out of scope unless it is focusable, which restores its role.
Expectation. Human review is required to confirm that the provided text alternative is accurate and appropriate.
Examples
<input type="image" src="submit.png" alt="" title="Submit order">
Empty alt is unusual on a functional control; a title still names it, but worth confirming the empty alt was deliberate.
<input type="image" src="submit.png" alt="Submit order">
Non-empty alt is input-image-alt-quality's question, not this rule's.
How to check
When this rule can’t decide, it reports cantTell and leaves the question to a person. Each question it can ask is listed here under its reason code, with the steps to answer it. A finding carries the same steps as howToCheck, in the scan’s language. See Output schema.
NAME_FROM_ELSEWHERE_REVIEW
- Find the image button the report names and read its computed name in the Accessibility pane (it comes from aria-label, aria-labelledby or title).
- Press the button or read the form to learn what it does.
- Decide whether the name says what the button does.
Pass. The name states the button's action, such as "Submit order" or "Search".
Fail. The name does not say what the button does, for example a file name, address or generic word, which fails WCAG 1.1.1 (H36, F30).