From ec741923f7653dcbff5a423f0b1130d2e7c9d323 Mon Sep 17 00:00:00 2001
From: userquin <userquin@gmail.com>
Date: Sat, 6 Apr 2024 00:26:22 +0200
Subject: [PATCH] feat(a11y): add access keys shortcuts

---
 components/main/MainContent.vue                    |  5 +++++
 components/skip/SkipContent.ts                     | 14 ++++++++++++++
 components/skip/SkipContentLink.vue                |  5 +++++
 constants/access-keys.ts                           |  6 ++++++
 layouts/default.vue                                |  1 +
 locales/en.json                                    |  3 ++-
 locales/es.json                                    |  3 ++-
 pages/settings.vue                                 |  2 +-
 pages/settings/about/index.vue                     |  2 +-
 pages/settings/interface/index.vue                 |  2 +-
 pages/settings/language/index.vue                  |  2 +-
 pages/settings/notifications/index.vue             |  2 +-
 pages/settings/notifications/notifications.vue     |  2 +-
 .../settings/notifications/push-notifications.vue  |  2 +-
 pages/settings/preferences/index.vue               |  2 +-
 pages/settings/profile/appearance.vue              |  2 +-
 pages/settings/profile/featured-tags.vue           |  2 +-
 pages/settings/profile/index.vue                   |  2 +-
 pages/settings/users/index.vue                     |  2 +-
 19 files changed, 47 insertions(+), 14 deletions(-)
 create mode 100644 components/skip/SkipContent.ts
 create mode 100644 components/skip/SkipContentLink.vue
 create mode 100644 constants/access-keys.ts

diff --git a/components/main/MainContent.vue b/components/main/MainContent.vue
index 312b5e52..8a55a165 100644
--- a/components/main/MainContent.vue
+++ b/components/main/MainContent.vue
@@ -6,6 +6,8 @@ defineProps<{
   back?: boolean
   /** Do not applying overflow hidden to let use floatable components in title */
   noOverflowHidden?: boolean
+  /** Show the skip content link */
+  skipContent?: string
 }>()
 
 const container = ref()
@@ -26,6 +28,9 @@ const containerClass = computed(() => {
 
 <template>
   <div ref="container" :class="containerClass">
+    <SkipContentLink v-if="skipContent">
+      {{ $t(skipContent) }}
+    </SkipContentLink>
     <div
       sticky top-0 z10
       pt="[env(safe-area-inset-top,0)]"
diff --git a/components/skip/SkipContent.ts b/components/skip/SkipContent.ts
new file mode 100644
index 00000000..872a4b01
--- /dev/null
+++ b/components/skip/SkipContent.ts
@@ -0,0 +1,14 @@
+// @unocss-include
+import { accessKeys } from '~/constants/access-keys'
+
+export default defineComponent({
+  setup() {
+    const { t } = useI18n()
+    return () => h('a', {
+      id: 'skip',
+      class: 'sr-only',
+      href: '#skip-content',
+      accesskey: accessKeys.SkipContent,
+    }, t(`a11y.skip_navigation`))
+  },
+})
diff --git a/components/skip/SkipContentLink.vue b/components/skip/SkipContentLink.vue
new file mode 100644
index 00000000..c3b92201
--- /dev/null
+++ b/components/skip/SkipContentLink.vue
@@ -0,0 +1,5 @@
+<template>
+  <NuxtLink id="skip-content" sr-only>
+    <slot />
+  </NuxtLink>
+</template>
diff --git a/constants/access-keys.ts b/constants/access-keys.ts
new file mode 100644
index 00000000..82b8aa3e
--- /dev/null
+++ b/constants/access-keys.ts
@@ -0,0 +1,6 @@
+export const accessKeys = {
+  Home: 'S',
+  SkipContent: '1',
+  Search: '2',
+  Shortcuts: '3',
+} as const
diff --git a/layouts/default.vue b/layouts/default.vue
index ecf6c106..5634302f 100644
--- a/layouts/default.vue
+++ b/layouts/default.vue
@@ -16,6 +16,7 @@ const isGrayscale = usePreferences('grayscaleMode')
 
 <template>
   <div h-full :data-mode="isHydrated && isGrayscale ? 'grayscale' : ''" data-tauri-drag-region>
+    <SkipContent />
     <main flex w-full mxa lg:max-w-80rem class="native:grid native:sm:grid-cols-[auto_1fr] native:lg:grid-cols-[auto_minmax(600px,2fr)_1fr]">
       <aside class="native:w-auto w-1/8 md:w-1/6 lg:w-1/5 xl:w-1/4 zen-hide" hidden sm:flex justify-end xl:me-4 native:me-0 relative>
         <div sticky top-0 w-20 xl:w-100 h-100dvh flex="~ col" lt-xl-items-center>
diff --git a/locales/en.json b/locales/en.json
index 645eab0c..d8990ab1 100644
--- a/locales/en.json
+++ b/locales/en.json
@@ -4,7 +4,8 @@
     "loading_titled_page": "Loading {0} page, please wait",
     "locale_changed": "Language changed to {0}",
     "locale_changing": "Changing language, please wait",
-    "route_loaded": "Page {0} loaded"
+    "route_loaded": "Page {0} loaded",
+    "skip_navigation": "Skip navigation"
   },
   "account": {
     "authorize": "Authorize to follow",
diff --git a/locales/es.json b/locales/es.json
index c5d5bf6a..6323fb89 100644
--- a/locales/es.json
+++ b/locales/es.json
@@ -4,7 +4,8 @@
     "loading_titled_page": "Cargando página {0}, espera por favor",
     "locale_changed": "Idioma cambiado a {0}",
     "locale_changing": "Cambiando idioma, espera por favor",
-    "route_loaded": "Página {0} cargada"
+    "route_loaded": "Página {0} cargada",
+    "skip_navigation": "Saltar navegación"
   },
   "account": {
     "authorize": "Autorizar seguimiento",
diff --git a/pages/settings.vue b/pages/settings.vue
index 1f53497f..cd5464c8 100644
--- a/pages/settings.vue
+++ b/pages/settings.vue
@@ -18,7 +18,7 @@ const isRootPath = computed(() => route.name === 'settings')
   <div>
     <div min-h-screen flex>
       <div border="e base" :class="isRootPath ? 'block lg:flex-none flex-1' : 'hidden lg:block'">
-        <MainContent>
+        <MainContent :skip-content="isRootPath ? 'nav.settings' : undefined">
           <template #title>
             <div timeline-title-style flex items-center gap-2 @click="$scrollToTop">
               <div i-ri:settings-3-line />
diff --git a/pages/settings/about/index.vue b/pages/settings/about/index.vue
index d025514a..08f1245d 100644
--- a/pages/settings/about/index.vue
+++ b/pages/settings/about/index.vue
@@ -17,7 +17,7 @@ function handleShowCommit() {
 </script>
 
 <template>
-  <MainContent back-on-small-screen>
+  <MainContent back-on-small-screen skip-content="settings.about.label">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <span>{{ $t('settings.about.label') }}</span>
diff --git a/pages/settings/interface/index.vue b/pages/settings/interface/index.vue
index 94ef7e97..2639fd4c 100644
--- a/pages/settings/interface/index.vue
+++ b/pages/settings/interface/index.vue
@@ -7,7 +7,7 @@ useHydratedHead({
 </script>
 
 <template>
-  <MainContent back-on-small-screen>
+  <MainContent back-on-small-screen skip-content="settings.interface.label">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <span>{{ $t('settings.interface.label') }}</span>
diff --git a/pages/settings/language/index.vue b/pages/settings/language/index.vue
index 9359af71..ae465b3f 100644
--- a/pages/settings/language/index.vue
+++ b/pages/settings/language/index.vue
@@ -15,7 +15,7 @@ const status = computed(() => {
 </script>
 
 <template>
-  <MainContent back-on-small-screen>
+  <MainContent back-on-small-screen skip-content="settings.language.label">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <span>{{ $t('settings.language.label') }}</span>
diff --git a/pages/settings/notifications/index.vue b/pages/settings/notifications/index.vue
index 467dae7f..48490e4b 100644
--- a/pages/settings/notifications/index.vue
+++ b/pages/settings/notifications/index.vue
@@ -12,7 +12,7 @@ useHydratedHead({
 </script>
 
 <template>
-  <MainContent back-on-small-screen>
+  <MainContent back-on-small-screen skip-content="settings.notifications.label">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <span>{{ $t('settings.notifications.label') }}</span>
diff --git a/pages/settings/notifications/notifications.vue b/pages/settings/notifications/notifications.vue
index 0cb65cda..12124de8 100644
--- a/pages/settings/notifications/notifications.vue
+++ b/pages/settings/notifications/notifications.vue
@@ -11,7 +11,7 @@ useHydratedHead({
 </script>
 
 <template>
-  <MainContent back>
+  <MainContent back skip-content="settings.notifications.notifications.label">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <div i-ri:test-tube-line />
diff --git a/pages/settings/notifications/push-notifications.vue b/pages/settings/notifications/push-notifications.vue
index af5d93ed..cce6ce32 100644
--- a/pages/settings/notifications/push-notifications.vue
+++ b/pages/settings/notifications/push-notifications.vue
@@ -14,7 +14,7 @@ useHydratedHead({
 </script>
 
 <template>
-  <MainContent back>
+  <MainContent back skip-content="settings.notifications.push_notifications.label">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <span>{{ $t('settings.notifications.push_notifications.label') }}</span>
diff --git a/pages/settings/preferences/index.vue b/pages/settings/preferences/index.vue
index b0d6d235..09e8737c 100644
--- a/pages/settings/preferences/index.vue
+++ b/pages/settings/preferences/index.vue
@@ -9,7 +9,7 @@ const userSettings = useUserSettings()
 </script>
 
 <template>
-  <MainContent back-on-small-screen>
+  <MainContent back-on-small-screen skip-content="settings.preferences.label">
     <template #title>
       <h1 text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         {{ $t('settings.preferences.label') }}
diff --git a/pages/settings/profile/appearance.vue b/pages/settings/profile/appearance.vue
index 54d40954..54bd1ac6 100644
--- a/pages/settings/profile/appearance.vue
+++ b/pages/settings/profile/appearance.vue
@@ -103,7 +103,7 @@ onReactivated(refreshInfo)
 </script>
 
 <template>
-  <MainContent back>
+  <MainContent back skip-content="settings.profile.appearance.title">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <span>{{ $t('settings.profile.appearance.title') }}</span>
diff --git a/pages/settings/profile/featured-tags.vue b/pages/settings/profile/featured-tags.vue
index 491bf8b7..0ca91a52 100644
--- a/pages/settings/profile/featured-tags.vue
+++ b/pages/settings/profile/featured-tags.vue
@@ -11,7 +11,7 @@ useHydratedHead({
 </script>
 
 <template>
-  <MainContent back>
+  <MainContent back skip-content="settings.profile.featured_tags.label">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <div i-ri:test-tube-line />
diff --git a/pages/settings/profile/index.vue b/pages/settings/profile/index.vue
index 5b40258c..4f2f5096 100644
--- a/pages/settings/profile/index.vue
+++ b/pages/settings/profile/index.vue
@@ -11,7 +11,7 @@ useHydratedHead({
 </script>
 
 <template>
-  <MainContent back-on-small-screen>
+  <MainContent back-on-small-screen skip-content="settings.profile.label">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <span>{{ $t('settings.profile.label') }}</span>
diff --git a/pages/settings/users/index.vue b/pages/settings/users/index.vue
index b44e9781..5f4f0a09 100644
--- a/pages/settings/users/index.vue
+++ b/pages/settings/users/index.vue
@@ -66,7 +66,7 @@ async function importTokens() {
 </script>
 
 <template>
-  <MainContent back-on-small-screen>
+  <MainContent back-on-small-screen skip-content="settings.users.label">
     <template #title>
       <div text-lg font-bold flex items-center gap-2 @click="$scrollToTop">
         <span>{{ $t('settings.users.label') }}</span>