Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Accessibility (HTML): Allow aria-label in <a> links #271

Open
tomschr opened this issue Jan 30, 2025 · 0 comments
Open

Accessibility (HTML): Allow aria-label in <a> links #271

tomschr opened this issue Jan 30, 2025 · 0 comments

Comments

@tomschr
Copy link
Member

tomschr commented Jan 30, 2025

Situation

When the DocBook HTML stylesheets creates an <a> link, but without an aria-label. This is an accessibility issue for site checkers like Siteimprove.

Proposed solution

I identified the named template simple.xlink. I see several solutions to this problem:

  • Provide another xsl:param, let's say aria-label that can provide the necessary addition. By default, it could be set to the href attribute or the <link> content.
  • Allow a more fine-granular customization by providing a named template simple.xlink.attr (or whatevery name you like) which is called inside the simple.xlink template. It creates additional attributes.

Reference

https://help.siteimprove.com/support/solutions/articles/80001050610-sia-r11-link-without-a-text-alternative-explained

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant