feat: add accessible Skip to Content link

- Add SkipLink component with off-screen styling
- Add translation keys for skip link text
- Integrate SkipLink in App.tsx and wrap content in #main-content
- Add unit tests for SkipLink

Co-authored-by: ragusa-it <196988693+ragusa-it@users.noreply.github.com>
This commit is contained in:
google-labs-jules[bot]
2026-02-07 01:53:13 +00:00
parent 2587b9dd29
commit 7018459185
7 changed files with 82 additions and 8 deletions

View File

@@ -3,7 +3,7 @@ import { BrowserRouter, Routes, Route } from 'react-router-dom';
import { LanguageProvider } from './i18n';
import { Navbar, Footer, FancyCursor, ScrollToTop } from './components/layout';
import { Home } from './pages/Home';
import { PageLoader } from './components/ui';
import { PageLoader, SkipLink } from './components/ui';
import './styles/global.css';
// Lazy load pages to reduce initial bundle size.
@@ -15,17 +15,20 @@ export function App() {
return (
<LanguageProvider>
<BrowserRouter>
<SkipLink />
<ScrollToTop />
<FancyCursor />
<Navbar />
{/* Suspense handles the loading state for lazy-loaded routes */}
<Suspense fallback={<PageLoader />}>
<Routes>
<Route path="/" element={<Home />} />
<Route path="/about" element={<About />} />
<Route path="/contact" element={<Contact />} />
</Routes>
</Suspense>
<div id="main-content" tabIndex={-1} style={{ outline: 'none' }}>
<Suspense fallback={<PageLoader />}>
<Routes>
<Route path="/" element={<Home />} />
<Route path="/about" element={<About />} />
<Route path="/contact" element={<Contact />} />
</Routes>
</Suspense>
</div>
<Footer />
</BrowserRouter>
</LanguageProvider>

View File

@@ -0,0 +1,22 @@
.skipLink {
position: fixed;
top: 1rem;
left: 1rem;
z-index: 9999;
padding: 0.75rem 1.25rem;
background-color: var(--md-sys-color-primary, #ffffff);
color: var(--md-sys-color-on-primary, #000000);
font-weight: 600;
text-decoration: none;
border-radius: 4px;
box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
transform: translateY(-100%);
transition: transform 0.2s cubic-bezier(0.4, 0, 0.2, 1);
outline: 2px solid transparent;
outline-offset: 2px;
}
.skipLink:focus {
transform: translateY(0);
outline: 2px solid var(--md-sys-color-primary, #ffffff);
}

View File

@@ -0,0 +1,12 @@
import { useTranslation } from '../../i18n';
import styles from './SkipLink.module.css';
export function SkipLink() {
const { t } = useTranslation();
return (
<a href="#main-content" className={styles.skipLink}>
{t.nav.skipToContent}
</a>
);
}

View File

@@ -0,0 +1,34 @@
// @vitest-environment jsdom
import { render, screen, cleanup } from '@testing-library/react';
import { describe, it, expect, afterEach, vi } from 'vitest';
import { SkipLink } from '../SkipLink';
// Mock i18n
vi.mock('../../../i18n', () => ({
useTranslation: () => ({
t: {
nav: {
skipToContent: 'Skip to content',
},
},
}),
}));
describe('SkipLink', () => {
afterEach(() => {
cleanup();
});
it('renders a link with correct href and text', () => {
render(<SkipLink />);
const link = screen.getByRole('link', { name: /skip to content/i });
expect(link).toBeTruthy();
expect(link.getAttribute('href')).toBe('#main-content');
});
it('has class attribute for styling', () => {
render(<SkipLink />);
const link = screen.getByRole('link');
expect(link.getAttribute('class')).toBeTruthy();
});
});

View File

@@ -2,3 +2,4 @@ export { Button } from './Button';
export { Card } from './Card';
export { Input, Textarea } from './Input';
export { PageLoader } from './PageLoader';
export { SkipLink } from './SkipLink';

View File

@@ -4,6 +4,7 @@ export const de = {
home: 'Startseite',
about: 'Über uns',
contact: 'Kontakt',
skipToContent: 'Zum Inhalt springen',
},
// Hero Section

View File

@@ -6,6 +6,7 @@ export const en: Translations = {
home: 'Home',
about: 'About',
contact: 'Contact',
skipToContent: 'Skip to content',
},
// Hero Section