Merge pull request #44 from digital-land/accessibility_page

Accessibility page

index.js

@@ -12,6 +12,7 @@ import formWizard from './src/routes/form-wizard/index.js'
 import validationMessageLookup from './src/filters/validationMessageLookup.js'
 import toErrorList from './src/filters/toErrorList.js'
 import hash from './src/utils/hasher.js'
+import accessibility from './src/routes/accessibility.js'
 
 const { govukMarkdown } = xGovFilters
 
@@ -81,8 +82,11 @@ app.use((req, res, next) => {
   }
 })
 
+// routing
 app.use('/', formWizard)
 
+app.use('/accessibility', accessibility)
+
 // error handler
 app.use((err, req, res, next) => {
   logger.info({

src/routes/accessibility.js

@@ -0,0 +1,11 @@
+import express from 'express'
+import nunjucks from 'nunjucks'
+
+const router = express.Router()
+
+router.get('/', (req, res) => {
+  const accessibilityPage = nunjucks.render('accessibility.html', {})
+  res.send(accessibilityPage)
+})
+
+export default router

src/views/accessibility.html

@@ -0,0 +1,84 @@
+{% extends "layouts/main.html" %}
+
+{% set pageName = 'Accessibility statement for publish planning and housing data for England' %}
+
+{% set markdownContent %}
+
+# Accessibility statement for publish planning and housing data for England
+
+This accessibility statement applies to the publish planning and housing data for England service (publish.development.digital-land.info).
+
+This service is run by the Department for Levelling Up, Housing and Communities (DLUHC). We want as many people as possible to be able to use this service. For example, that means you should be able to:
+
+-   change colours, contrast levels and fonts using browser or device settings
+-   zoom in up to 400% without the text spilling off the screen
+-   navigate most of the service using a keyboard or speech recognition software
+-   listen to most of the service using a screen reader (including the most recent versions of JAWS, NVDA and VoiceOver)
+
+We've also made the service text as simple as possible to understand.
+
+[AbilityNet](https://mcmw.abilitynet.org.uk/) has advice on making your device easier to use if you have a disability.
+
+## How accessible this service is
+
+
+We know some parts of this service are not fully accessible:
+
+-   some field names may not be read out correctly by a screen reader
+
+## Feedback and contact information
+
+If you find any problems not listed on this page or think we're not meeting accessibility requirements, contact: <digitalland@levellingup.gov.uk>.
+
+If you need information on this service in a different format, like accessible PDF, large print, easy read, audio recording or braille, email <digitalland@levellingup.gov.uk>.
+
+We'll consider your request and get back to you in 5 business days.
+
+## Enforcement procedure
+
+The Equality and Human Rights Commission (EHRC) is responsible for enforcing the Public Sector Bodies (Websites and Mobile Applications) (No. 2) Accessibility Regulations 2018 (the 'accessibility regulations'). If you're not happy with how we respond to your complaint, [contact the Equality Advisory and Support Service (EASS)](https://www.equalityadvisoryservice.com/).
+
+## Technical information about this service's accessibility
+
+The Department for Levelling Up, Housing and Communities (DLUHC) is committed to making this service accessible, in accordance with the Public Sector Bodies (Websites and Mobile Applications) (No. 2) Accessibility Regulations 2018.
+
+### Compliance status
+
+This service is partially compliant with the [Web Content Accessibility Guidelines version 2.1](https://www.w3.org/TR/WCAG21/) AA standard, due to the non-compliance listed below.
+
+## Non-accessible content
+
+The content listed below is non-accessible for the following reasons.
+
+### Non-compliance with the accessibility regulations
+
+#### Some content is not suitable for screen readers
+
+The service uses field names from the data standards. These are written in lower case, which means they may not always be read out correctly by screen readers. For example, 'document-url' may not spell out the letters of URL. This fails WCAG 2.1 success criterion 3.1.6 (Pronunciation).
+
+We plan to review field names in 2024.
+
+### Disproportionate burden
+
+There’s no content that's considered a disproportionate burden to change.
+
+### Content that's not within the scope of the accessibility regulations
+
+There’s no content that’s outside the scope of the accessibility regulations.
+
+## Preparation of this accessibility statement
+
+This statement was prepared on 9 January 2023. It was last reviewed on 9 January 2023.
+
+This service was last tested on 4 January 2023.  The test was carried out by the internal design team. 
+
+We plan to do further testing in 2024.
+
+
+{% endset %}
+
+{% block content %}
+
+    {{markdownContent | govukMarkdown(headingsStartWith="xl") | safe}}
+
+{% endblock content %}

test/acceptance/pages_load_ok.test.js

@@ -29,3 +29,8 @@ test.describe('without a valid session, the user can not access the later pages'
     await checkSessionExpired(page, '/upload')
   })
 })
+
+// the accessibility page loads ok
+test('/accessibility loads ok', async ({ page }) => {
+  await checkRouteResponse(page, '/accessibility', 200)
+})