github / github/erblint-github

Update svg accessible name guidance

Open
#53 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Ruby
Stars
66
Forks
9
Avg merge
9h 26m
Merged PRs (30d)
2

Description

```
1. Add a `` inside the SVG, with the alt text/name.
2. Give the `<title>` an ID.
3. Apply `aria-labelledby` to the SVG, pointing to the ID of the `<title>` inside of it.
```

This approach has maximum compatibility and should be recommended above all other approaches. Not sure if we would necessarily want to flag the other approaches as errors though... 🤔

[GitHub Staff-only link svg-alt-text](https://github.com/github/accessibility/pull/2273/files)

Contributor guide

Open the contributing guide

Research direction

Review the repository's current SVG accessible-name guidance and compare it with the linked GitHub accessibility reference. Decide how the title, ID, and aria-labelledby pattern should be recommended and how alternative approaches should be treated; done means the guidance reflects that decision.

Written by the indexing model from the issue text.

Assessment

Tech stack
ruby
Domain
accessibility, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.