diff --git a/docs/common-issues/clipped-text.md b/docs/common-issues/clipped-text.md new file mode 100644 index 0000000..2401a08 --- /dev/null +++ b/docs/common-issues/clipped-text.md @@ -0,0 +1,50 @@ +# Issue: Text is clipped [Draft] + +Text is present which does not wrap to stay within the bounds of its parent container when user rely on text resizing. Increasing font size causing the text to either extend beyond the container, causing the layout to break or scrollbars to appear, or the text is clipped by the parent container and content is lost. +This create difficulties for people who rely on text to be resized without loss of the content. + + +## To resolve + +Most recent govuk-frontend should containe fix for this issue panel heading +https://github.com/alphagov/govuk-frontend/pull/2347. +Or apply `.text-overflow` class on element + +``` +.text-overflow { + word-wrap: break-word; /* old version of overflow-wrap for IE and Edge and FF < 49*/ + overflow-wrap: anywhere; /* modern, tries to fit word on a new line rather than fitting on remnants of the current line */ +} +``` +## Labels + +- wcag +- wcag 1.4.4 (AA) +- large text + +## Report + +| Status | Level | Issue | Success Criterion | +| ------ | ----- | ----- | ----------------- | +| 🟠 (M) | AA | [#issue]():Text is clipped | 1.4.4 Resize text | + +## Statement + +### Accessibility problems +``` + when text is resized [named] text is cut off and so may not display the entire information intended. +``` + +### Milestones + +``` + when text is resized, content is lost. This fails WCAG 2.1 success criterion 1.4.4 Resize text + date: TBC + +``` + +## References + +[govuk-font mixin - GOV.UK Frontend](https://frontend.design-system.service.gov.uk/sass-api-reference/#govuk-typography-responsive-usage) + +[Understanding Success Criterion 1.4.4 Resize text ](https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-scale.html) diff --git a/docs/common-issues/conditionally-revealing-content.md b/docs/common-issues/conditionally-revealing-content.md index a82c359..e4d1220 100644 --- a/docs/common-issues/conditionally-revealing-content.md +++ b/docs/common-issues/conditionally-revealing-content.md @@ -28,13 +28,15 @@ If the content contains a link then it shouldn't be added as hint text as not al ### Accessibility problems ``` -tbc + when user selects one of the options, hidden content is revealed below the selected option. This content may not be announced by assistive technology ``` ### Milestones ``` -tbc + when text is conditionally revealed, it is unlikely to be discovered by a screen reader user in 'forms mode' as the text is not focusable. This fails WCAG 2.1 success criterion 4.1.2 Name, Role, Value + date: TBC + ``` ## References diff --git a/docs/common-issues/error-message.md b/docs/common-issues/error-message.md index bc6dd95..de6f6d3 100644 --- a/docs/common-issues/error-message.md +++ b/docs/common-issues/error-message.md @@ -13,7 +13,7 @@ Ensure for each error scenario you write [clear and concise error messages](http ## Labels - wcag -- wcag 1.3.1 (A) +- wcag 3.3.3 (AA) - usability - error message @@ -21,7 +21,7 @@ Ensure for each error scenario you write [clear and concise error messages](http | Status | Level | Issue | Success Criterion | | ------ | ----- | ----- | ----------------- | -| 🔴 (H) | A | [#issue](): Error message text | 1.3.1 Info and Relationships | +| 🟠 (M) | AA | [#issue](): Error message text | 3.3.3 Error Suggestion (AA) | ## Statement @@ -41,5 +41,4 @@ tbc [Error message - GOV.UK Design System](https://design-system.service.gov.uk/components/error-message/) -[Understanding Success Criterion 1.3.1: Info and Relationships](https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships) - +[Understanding Success Criterion 3.3.3: Error Suggestion](https://www.w3.org/WAI/WCAG21/Understanding/error-suggestion.html) diff --git a/docs/common-issues/error-summary-links.md b/docs/common-issues/error-summary-links.md index 6f7dbe1..3b94bb6 100644 --- a/docs/common-issues/error-summary-links.md +++ b/docs/common-issues/error-summary-links.md @@ -31,13 +31,15 @@ Ensure you are linking to the correct answer by following the [GOV.UK Design Sys ### Accessibility problems ``` -tbc + the error message link in the error summary does not link to the form element in the error. ``` ### Milestones ``` -tbc + the error message link in the error summary does not contain the valid link destination to the form element in error. This fails WCAG 2.1 success criterion 1.3.1 Info and relationships + date: TBC + ``` ## References diff --git a/docs/common-issues/link-as-button.md b/docs/common-issues/link-as-button.md new file mode 100644 index 0000000..9ce1517 --- /dev/null +++ b/docs/common-issues/link-as-button.md @@ -0,0 +1,41 @@ +# Issue: Link styled as a button [Draft] + +For a link styled as a button, add `role="button"` and `data-module="govuk-button"` to initialise the JavaScript polyfill to ensure it acts as a button. + +- Adding ARIA `role="button"` will identify the link as a button to assistive technologies. +- Adding `data-module="govuk-button"` makes sure that the link responds to the enter and spacebar keypress. + +## To resolve + +Follow guidance [Using links as buttons](https://github.com/hmrc/accessibility/blob/master/docs/design-and-usability-quick-wins.md#using-links-as-buttons). + +## Labels +- wcag +- wcag 4.1.2 (A) +- button +- code quality +- keyboard-only + +## Report + +| Status | Level | Issue | Success Criterion | +| ------ | ----- | ----- | ----------------- | +| 🔴 (H) | A | [#issue](): Link styled as a button | 4.1.2 Name, Role, Value | + +## Statement + +### Accessibility problems +``` +on the [page title] page, the [link text] link has been styled as a button, but is not seen as one with assistive technologies and does not work with the spacebar keypress +``` + +### Milestones +``` +for a link styled as a button, the role="button" and the data-module="govuk-button" is missing to ensure it acts like a button. This fails WCAG 2.1 success criterion 4.1.2: Name, Role, Value +``` + +## References + +[Using links as buttons](https://github.com/hmrc/accessibility/blob/master/docs/design-and-usability-quick-wins.md#using-links-as-buttons) + +[Understanding Success Criterion 4.1.2 Name, Role, Value](https://www.w3.org/WAI/WCAG21/Understanding/name-role-value) diff --git a/docs/common-issues/readme.md b/docs/common-issues/readme.md index 41afdf8..283439d 100644 --- a/docs/common-issues/readme.md +++ b/docs/common-issues/readme.md @@ -30,3 +30,5 @@ - [Timeout dialog missing](https://github.com/hmrc/accessibility/blob/master/docs/common-issues/timeout-dialog.md) Draft - [Timeout dialog doesn't extend session](https://github.com/hmrc/accessibility/blob/master/docs/common-issues/timeout-dialog-cannot-extend-session.md) Draft - [Page title incomplete](https://github.com/hmrc/accessibility/blob/master/docs/common-issues/page-title-incomplete.md) Draft +- [Text is clipped](https://github.com/hmrc/accessibility/blob/master/docs/common-issues/clipped-text.md) Draft +- [Link styled as a button](https://github.com/hmrc/accessibility/blob/master/docs/common-issues/link-as-button.md) Draft \ No newline at end of file diff --git a/docs/common-issues/welsh-translations.md b/docs/common-issues/welsh-translations.md index 46ee039..0eb6309 100644 --- a/docs/common-issues/welsh-translations.md +++ b/docs/common-issues/welsh-translations.md @@ -28,6 +28,21 @@ However it is possible to send an override skip link to the @skipLinkBlock code | ------ | ----- | ----- | ----------------- | | 🟠 (M) | AA | [#issue](): Content not translated to Welsh | 3.1.2 Language of parts | +## Statement + +### Accessibility problems +``` + when switching to the Welsh language version, the parts of the text is not translated. Additionally, the not translated text may not be pronounced correctly by screen readers. + +``` + +### Milestones + +``` + missing Welsh translations and appropriate language attributes on the copy can cause screen readers to mispronounce the copy. This fails WCAG 2.1 success criterion 3.1.2 Language of parts + date: tbc +``` + ## References [Language toggle - HMRC Design System](https://design.tax.service.gov.uk/hmrc-design-patterns/welsh-language-toggle/)