Merge pull request #7597 from quarto-dev/bugfix/5403

fix for kbd shortcode a11y issues

src/resources/extensions/quarto/kbd/kbd.lua

@@ -31,7 +31,7 @@ return {
         default_arg_str = pandoc.utils.stringify(args[1])
       end
 
-      return pandoc.RawInline('html', '<kbd ' .. kwargs_str .. '>' .. default_arg_str .. '</kbd>')
+      return pandoc.RawInline('html', '<kbd aria-hidden="true" ' .. kwargs_str .. '>' .. default_arg_str .. '</kbd><span class="visually-hidden">' .. default_arg_str .. '</span>')
     elseif quarto.doc.isFormat("asciidoc") and args and #args == 1 then
       -- get the 'first' kbd shortcut as we can only produce on shortcut in asciidoc
       local shortcutText = pandoc.utils.stringify(args[1]):gsub('-', '+')

src/resources/formats/html/_quarto-rules.scss

@@ -8,6 +8,19 @@
 
 // hidden
 
+// https://github.com/quarto-dev/quarto-cli/issues/5403#issuecomment-1533791947
+.visually-hidden {
+  border: 0;
+  clip: rect(0 0 0 0);
+  height: auto;
+  margin: 0;
+  overflow: hidden;
+  padding: 0;
+  position: absolute;
+  width: 1px;
+  white-space: nowrap;
+}
+
 .hidden {
   display: none !important;
 }

tests/docs/smoke-all/2023/11/15/5403.qmd

@@ -0,0 +1,11 @@
+---
+format: html
+_quarto:
+  tests:
+    html:
+      ensureHtmlElements:
+        - ["span.visually-hidden"]
+        - []
+---
+
+{{< kbd Shift-Control-O >}}