From cdaae66e9484aa70066c1c2f9031e68195d5b351 Mon Sep 17 00:00:00 2001
From: Gabe Kangas <gabek@real-ity.com>
Date: Sat, 21 Jan 2023 23:19:17 -0800
Subject: [PATCH] Add skip links for content, player and footer. For #1826

---
 web/components/layouts/Main/Main.tsx              | 11 ++++++++++-
 web/components/ui/Content/Content.tsx             |  2 +-
 web/components/ui/Footer/Footer.tsx               |  2 +-
 web/components/ui/Header/Header.module.scss       | 15 +++++++++++++++
 web/components/ui/Header/Header.tsx               | 14 ++++++++++++++
 .../video/OwncastPlayer/OwncastPlayer.tsx         |  2 +-
 web/pages/embed/chat/readwrite/index.tsx          |  6 +++++-
 7 files changed, 47 insertions(+), 5 deletions(-)

diff --git a/web/components/layouts/Main/Main.tsx b/web/components/layouts/Main/Main.tsx
index 1aa380d05..709a34c20 100644
--- a/web/components/layouts/Main/Main.tsx
+++ b/web/components/layouts/Main/Main.tsx
@@ -11,6 +11,7 @@ import {
   isChatAvailableSelector,
   clientConfigStateAtom,
   fatalErrorStateAtom,
+  appStateAtom,
 } from '../../stores/ClientConfigStore';
 import { Content } from '../../ui/Content/Content';
 import { Header } from '../../ui/Header/Header';
@@ -22,6 +23,7 @@ import { ServerRenderedHydration } from '../../ServerRendered/ServerRenderedHydr
 import { Theme } from '../../theme/Theme';
 import styles from './Main.module.scss';
 import { PushNotificationServiceWorker } from '../../workers/PushNotificationServiceWorker/PushNotificationServiceWorker';
+import { AppStateOptions } from '../../stores/application-state';
 
 const lockBodyStyle = `
 body {
@@ -46,9 +48,11 @@ export const Main: FC = () => {
   const { name, title, customStyles } = clientConfig;
   const isChatAvailable = useRecoilValue<boolean>(isChatAvailableSelector);
   const fatalError = useRecoilValue<DisplayableError>(fatalErrorStateAtom);
+  const appState = useRecoilValue<AppStateOptions>(appStateAtom);
 
   const layoutRef = useRef<HTMLDivElement>(null);
   const { chatDisabled } = clientConfig;
+  const { videoAvailable } = appState;
 
   useEffect(() => {
     setupNoLinkReferrer(layoutRef.current);
@@ -137,7 +141,12 @@ export const Main: FC = () => {
       <Script strategy="afterInteractive" src="/customjavascript" />
 
       <Layout ref={layoutRef} className={styles.layout}>
-        <Header name={title || name} chatAvailable={isChatAvailable} chatDisabled={chatDisabled} />
+        <Header
+          name={title || name}
+          chatAvailable={isChatAvailable}
+          chatDisabled={chatDisabled}
+          online={videoAvailable}
+        />
         <Content />
         {fatalError && (
           <FatalErrorStateModal title={fatalError.title} message={fatalError.message} />
diff --git a/web/components/ui/Content/Content.tsx b/web/components/ui/Content/Content.tsx
index 4e6e3f50a..fe077b0dc 100644
--- a/web/components/ui/Content/Content.tsx
+++ b/web/components/ui/Content/Content.tsx
@@ -115,7 +115,7 @@ const DesktopContent = ({
 
   return (
     <>
-      <div className={styles.lowerHalf}>
+      <div className={styles.lowerHalf} id="skip-to-content">
         <ContentHeader
           name={name}
           title={streamTitle}
diff --git a/web/components/ui/Footer/Footer.tsx b/web/components/ui/Footer/Footer.tsx
index 5ff92b76c..fcce52be1 100644
--- a/web/components/ui/Footer/Footer.tsx
+++ b/web/components/ui/Footer/Footer.tsx
@@ -6,7 +6,7 @@ export type FooterProps = {
 };
 
 export const Footer: FC<FooterProps> = ({ version }) => (
-  <footer className={styles.footer}>
+  <footer className={styles.footer} id="footer">
     <span>
       Powered by <a href="https://owncast.online">{version}</a>
     </span>
diff --git a/web/components/ui/Header/Header.module.scss b/web/components/ui/Header/Header.module.scss
index 9b373b904..c1a9e0978 100644
--- a/web/components/ui/Header/Header.module.scss
+++ b/web/components/ui/Header/Header.module.scss
@@ -42,3 +42,18 @@
   overflow: hidden;
   line-height: 1.4;
 }
+
+.skipLink {
+  position: absolute;
+  left: -10000px;
+  top: auto;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+}
+
+.skipLink:focus {
+  position: static;
+  width: auto;
+  height: auto;
+}
diff --git a/web/components/ui/Header/Header.tsx b/web/components/ui/Header/Header.tsx
index 9d57a20a8..b3c928160 100644
--- a/web/components/ui/Header/Header.tsx
+++ b/web/components/ui/Header/Header.tsx
@@ -2,6 +2,7 @@ import { Tag, Tooltip } from 'antd';
 import { FC } from 'react';
 import cn from 'classnames';
 import dynamic from 'next/dynamic';
+import Link from 'next/link';
 import { OwncastLogo } from '../../common/OwncastLogo/OwncastLogo';
 import styles from './Header.module.scss';
 
@@ -18,14 +19,27 @@ export type HeaderComponentProps = {
   name: string;
   chatAvailable: boolean;
   chatDisabled: boolean;
+  online: boolean;
 };
 
 export const Header: FC<HeaderComponentProps> = ({
   name = 'Your stream title',
   chatAvailable,
   chatDisabled,
+  online,
 }) => (
   <header className={cn([`${styles.header}`], 'global-header')}>
+    {online && (
+      <Link href="#player" className={styles.skipLink}>
+        Skip to player
+      </Link>
+    )}
+    <Link href="#skip-to-content" className={styles.skipLink}>
+      Skip to page content
+    </Link>
+    <Link href="#footer" className={styles.skipLink}>
+      Skip to footer
+    </Link>
     <div className={styles.logo}>
       <div id="header-logo" className={styles.logoImage}>
         <OwncastLogo variant="contrast" />
diff --git a/web/components/video/OwncastPlayer/OwncastPlayer.tsx b/web/components/video/OwncastPlayer/OwncastPlayer.tsx
index 2c033717f..4a21cf624 100644
--- a/web/components/video/OwncastPlayer/OwncastPlayer.tsx
+++ b/web/components/video/OwncastPlayer/OwncastPlayer.tsx
@@ -307,7 +307,7 @@ export const OwncastPlayer: FC<OwncastPlayerProps> = ({
   );
 
   return (
-    <div className={styles.container}>
+    <div className={styles.container} id="player">
       {online && (
         <div className={styles.player}>
           <VideoJS options={videoJsOptions} onReady={handlePlayerReady} />
diff --git a/web/pages/embed/chat/readwrite/index.tsx b/web/pages/embed/chat/readwrite/index.tsx
index 65f0301c1..6d9c8c62c 100644
--- a/web/pages/embed/chat/readwrite/index.tsx
+++ b/web/pages/embed/chat/readwrite/index.tsx
@@ -6,16 +6,20 @@ import {
   currentUserAtom,
   visibleChatMessagesSelector,
   clientConfigStateAtom,
+  appStateAtom,
 } from '../../../../components/stores/ClientConfigStore';
 import Header from '../../../../components/ui/Header/Header';
 import { ClientConfig } from '../../../../interfaces/client-config.model';
+import { AppStateOptions } from '../../../../components/stores/application-state';
 
 export default function ReadWriteChatEmbed() {
   const currentUser = useRecoilValue(currentUserAtom);
   const messages = useRecoilValue<ChatMessage[]>(visibleChatMessagesSelector);
   const clientConfig = useRecoilValue<ClientConfig>(clientConfigStateAtom);
+  const appState = useRecoilValue<AppStateOptions>(appStateAtom);
 
   const { name, chatDisabled } = clientConfig;
+  const { videoAvailable } = appState;
 
   if (!currentUser) {
     return null;
@@ -26,7 +30,7 @@ export default function ReadWriteChatEmbed() {
   return (
     <div>
       <ClientConfigStore />
-      <Header name={name} chatAvailable chatDisabled={chatDisabled} />
+      <Header name={name} chatAvailable chatDisabled={chatDisabled} online={videoAvailable} />
       <ChatContainer
         messages={messages}
         usernameToHighlight={displayName}