docs: improve anchored heading accessibility (bootstrap-vue#4787)

tmorehouse · jacobmllr95 · web-flow · commit 8625e99aab6e · 2020-02-18T06:33:28.000-04:00
Co-authored-by: Jacob Müller &lt;jacob.mueller.elz@gmail.com&gt;
diff --git a/docs/components/anchored-heading.js b/docs/components/anchored-heading.js
@@ -18,7 +18,11 @@ export default {
       'b-link',
       {
         staticClass: 'anchorjs-link',
-        attrs: { to: { hash: `#${props.id}` }, 'aria-label': 'Anchor' }
+        props: { to: { hash: `#${props.id}` } },
+        attrs: {
+          'aria-labelledby': props.id || null,
+          'aria-label': props.id ? null : 'Anchor'
+        }
       },
       [h()]
     )
diff --git a/docs/nuxt.config.js b/docs/nuxt.config.js
@@ -86,7 +86,7 @@ renderer.heading = function(text, level, raw, slugger) {
 
   const anchor =
     ANCHOR_LINK_HEADING_LEVELS.indexOf(level) !== -1
-      ? `<a class="anchorjs-link" href="#${link}" aria-label="Anchor"></a>`
+      ? `<a class="anchorjs-link" href="#${link}" aria-labelledby="${link}"></a>`
       : ''
   const attrs = `id="${link}" class="bv-no-focus-ring"`
   return `<h${level} ${attrs}>${getTextMarkup(text + anchor)}</h${level}>\n`

Original file line number	Diff line number	Diff line change
`@@ -18,7 +18,11 @@ export default {`
`18`	`18`	`'b-link',`
`19`	`19`	`{`
`20`	`20`	`staticClass: 'anchorjs-link',`
`21`		- attrs: { to: { hash: `#${props.id}` }, 'aria-label': 'Anchor' }
	`21`	+ props: { to: { hash: `#${props.id}` } },
	`22`	`+ attrs: {`
	`23`	`+ 'aria-labelledby': props.id \|\| null,`
	`24`	`+ 'aria-label': props.id ? null : 'Anchor'`
	`25`	`+ }`
`22`	`26`	`},`
`23`	`27`	`[h()]`
`24`	`28`	`)`