adobe / adobe/aem-core-wcm-components

[Link] Relevance of title attributes

Open
#2,897 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
795
Forks
775
Avg merge
3d 22h
Merged PRs (30d)
8

Description

## Feature Request

In French-speaking countries, for accessibility audit we use the RGAA accessibility guidelines, for the links it's a little stricter than WCAG.

**Is your feature request related to a problem? Please describe.**
For each text link with a link title (title attribute), the content of this attribute is not enought relevant for RGAA auditors.

**Describe the solution you'd like**
The link title must contain at least the textual content.

To take into account to go further :
- If a title proposal is entered manually by the editor, and if this proposal is different from the textual content then we will use a concatenation of these two elements for the title attribute
- If a proposed title is entered manually by the writer, and if the textual content is included in the manually entered title proposal then the title attribute will consist only of the proposed title
- If a title proposal is entered manually by the editor, and if the textual content is stricly equal to this proposal then the title attribute shouldn't be generated (shouldn't display anything on hover)

In the code, edit "PN_LINK_TITLE_ATTRIBUTE" around line 130 of aem-core-wcm-components/bundles/core/src/main/java/com/adobe/cq/wcm/core/components/internal/link/LinkBuilderImpl.java

**Example**
`My label`

- link title = "My label - new window"
- textual content = "My label"

**Documentation**

- RGAA 6.1.5 : https://accessibilite.numerique.gouv.fr/methode/criteres-et-tests/#6.1.5 (In french)
- WCAG 2.4.4 : https://www.w3.org/WAI/WCAG21/Understanding/link-purpose-in-context.html
- WCAG H33 : https://www.w3.org/TR/WCAG-TECHS/H33.html
- RAWeb 6.1.5 : https://accessibilite.public.lu/fr/raweb1/criteres.html#test-6-1-5 (In french)

Contributor guide

Open the contributing guide

Research direction

Start in aem-core-wcm-components/bundles/core/src/main/java/com/adobe/cq/wcm/core/components/internal/link/LinkBuilderImpl.java, around PN_LINK_TITLE_ATTRIBUTE. Trace how the link title and textual content are obtained, then compare the behavior with the RGAA 6.1.5 rules and examples in the issue. Done means the generated title follows each stated equality, inclusion, and concatenation case.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
accessibility, web-dev
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.