Files
supabase/apps/www/components/Sections/TimedTabsSection.tsx
Danny White 6f6badae51 fix(eslint): promote require-explicit-tabindex to error (#48170)
## What kind of change does this PR introduce?

Accessibility / lint hardening (Safari keyboard focus).

## What is the current behavior?

`supabase/require-explicit-tabindex` is `'warn'`. Studio’s ratchet was
at 0 but the rule was still ratcheted; www / docs / design-system still
had raw `<button>` / `role="button"` call sites without an explicit
`tabIndex`.

[DEPR-627](https://linear.app/supabase/issue/DEPR-627) · follow-up to
#47984 / #48040

## What is the new behavior?

- Shared config: `'supabase/require-explicit-tabindex': 'error'`
- Swept www / docs / design-system (+ Studio test fixtures the ratchet
skipped)
- Removed the rule from the Studio ratchet + baselines

## To test

Prefer **Safari**. This PR only adds explicit `tabIndex` to raw
`<button>` / `role="button"` call sites — not links, and not controls
that already go through `Button` from `ui`.

### Marketing (`www`) ([staging
link](https://zone-www-dot-com-git-danny-depr-627-promote-req-7ae43c-supabase.vercel.app/))

- [x] Homepage frameworks / dashboard feature tabs — Tab through each
tab button
- [x] Product pages (e.g. `/auth`, `/database`) — section tab switchers
- [x] Narrow viewport — open the hamburger; Tab through menu buttons
- [x] `/partners/catalog` — filter / view controls
- [x] Blog view toggle (list ↔ grid)

### Docs ([staging
link](https://docs-git-danny-depr-627-promote-require-explici-25e46d-supabase.vercel.app/))

- [x] **Desktop (≥ lg):** top-right **⋯ menu** (hamburger icon) — opens
a dropdown that includes Theme. Not a separate theme button.
- [x] **Mobile (< lg):** top-right **hamburger** opens the sheet; close
(X) is the raw button we tagged. Theme inside the sheet uses
`ThemeToggle` / `DropdownMenuTrigger` from `ui` (already supposed to set
`tabIndex`).
- [x] **Code blocks** — copy / language controls
- [x] **Is this helpful?** — X / check are `Button` from `ui` (should
already Tab). After voting **while signed in**, the follow-up “What went
well?” / “How can we improve?” text button is the raw one we tagged.
- [x] **AI Tools → Copy as Markdown** (right rail on a guide) — this is
the only GuidesSidebar control this PR changed. “On this page” TOC items
are **links**, not covered by this lint.
- [x] **Reference docs** (e.g. JS client reference) — section headers
that expand/collapse in the left nav (`Collapsible.Trigger`)
- [x] **Troubleshooting index** — type in the search field, then Tab to
the **clear (X)** control

### Dashboard (`studio`)

No production UI changes in this PR (tests + lint config only). Quick
Safari smoke that prior tabindex work still holds:

- [x] Project sidebar — Tab through primary nav links
- [x] Settings → General — Tab through inputs / buttons
- [x] Storage → Files — Tab a bucket row / file actions
2026-07-23 05:21:15 +10:00

229 lines
6.7 KiB
TypeScript

import 'swiper/css'
import CodeBlock from '~/components/CodeBlock/CodeBlock'
import SectionContainer from '~/components/Layouts/SectionContainer'
import { AnimatePresence, motion, useAnimation } from 'framer-motion'
import { ArrowUpRight } from 'lucide-react'
import Image from 'next/image'
import Link from 'next/link'
import { useEffect, useState, type ReactNode } from 'react'
import { Swiper, SwiperSlide } from 'swiper/react'
import { Button } from 'ui'
interface TabProps {
label: string
paragraph?: string
isActive: boolean
onClick: VoidFunction
progress: number | undefined
intervalDuration?: number
}
const Tab = ({ isActive, label, paragraph, onClick, progress, intervalDuration }: TabProps) => (
<button
tabIndex={0}
onClick={onClick}
className={`text-left text-lg flex flex-col group gap-1 transition-all ${
isActive ? 'flex-2 text-foreground' : 'flex-1 text-foreground-light'
}`}
aria-selected={isActive}
role="tab"
>
<div className="relative w-full h-[2px] bg-border-strong opacity-80 group-hover:opacity-100 rounded-full overflow-hidden">
{isActive && (
<motion.div
className={[
'absolute inset-0 w-full right-full bg-brand h-full transition-opacity',
progress! > 99.7 ? 'opacity-0' : 'opacity-100',
].join(' ')}
style={{ x: `${progress! - 100}%` }}
transition={{ duration: intervalDuration }}
/>
)}
</div>
<div className="md:h-20">
{label}
{isActive && (
<motion.p
initial={{ opacity: 0 }}
animate={{ opacity: 1, transition: { delay: 0.2 } }}
className="hidden md:block mt-1 text-foreground-lighter text-sm"
>
{paragraph}
</motion.p>
)}
</div>
</button>
)
interface Tab {
label: string
paragraph?: string
panel?: ReactNode
colabUrl: string
code?: string
}
interface Props {
title: ReactNode
paragraph: string
cta?: {
label?: string
link: string
}
tabs: Tab[]
intervalDuration?: number
updateFrequency?: number
}
const TimedTabsSection = ({
title,
paragraph,
cta,
tabs,
intervalDuration = 25,
updateFrequency = 10,
}: Props) => {
const [activeTab, setActiveTab] = useState(0)
const [progress, setProgress] = useState(0)
const [apiSwiper, setApiSwiper] = useState(undefined)
const controls = useAnimation()
useEffect(() => {
if (!apiSwiper) return
// @ts-ignore
apiSwiper.slideTo(activeTab)
}, [activeTab])
const restartInterval = (tabIndex: number) => {
setProgress(0)
setActiveTab(tabIndex)
}
const animation = {
width: '100%',
transition: { duration: intervalDuration, ease: 'linear' },
}
useEffect(() => {
const progressIncrement = (100 / intervalDuration) * (updateFrequency / 1000)
controls.start(animation)
const progressInterval = setInterval(() => {
setProgress((prevProgress) => (prevProgress + progressIncrement) % 101)
}, updateFrequency)
return () => {
clearInterval(progressInterval)
setProgress(0)
}
}, [activeTab, controls])
useEffect(() => {
if (progress >= 100.9) {
setActiveTab((prevActiveTab) => (prevActiveTab === tabs.length - 1 ? 0 : prevActiveTab + 1))
}
}, [progress])
const handleTabClick = (tabIndex: number) => {
restartInterval(tabIndex)
}
return (
<SectionContainer className="flex flex-col gap-8">
<div className="flex flex-col lg:flex-row gap-8 xl:gap-10 justify-between">
<div className="w-full lg:w-1/2 gap-2 flex flex-col items-start">
<h2 className="text-3xl xl:text-4xl max-w-[280px] sm:max-w-xs xl:max-w-[360px] tracking-[-1px]">
{title}
</h2>
<p className="text-foreground-lighter mb-4 max-w-sm">{paragraph}</p>
{cta && (
<Button asChild variant="default" size="small" icon={<ArrowUpRight />}>
<Link href={cta.link}>{cta.label ?? 'Explore more'}</Link>
</Button>
)}
</div>
<div className="relative w-full lg:w-1/2 min-h-[300px]">
<Swiper
// @ts-ignore
onSwiper={setApiSwiper}
style={{ zIndex: 0, marginRight: '1px' }}
initialSlide={activeTab}
spaceBetween={0}
slidesPerView={1}
speed={300}
allowTouchMove={false}
>
{tabs.map((tab, i) => (
<SwiperSlide key={i}>
<>
<OpenInColab
colabUrl={tabs[activeTab].colabUrl}
className="hidden md:flex absolute top-4 right-4"
/>
<CodeBlock hideCopy key={i} lang="py" size="large" background="#1A1A1A">
{tab.code}
</CodeBlock>
</>
</SwiperSlide>
))}
</Swiper>
<OpenInColab
colabUrl={tabs[activeTab]?.colabUrl}
className="flex md:hidden relative! top-0! right-0! mt-8 w-full justify-center"
/>
</div>
</div>
<div className="w-full col-span-full flex gap-4 lg:gap-8 xl:gap-10" role="tablist">
{tabs.map((tab, index) => (
<Tab
key={index}
isActive={index === activeTab}
label={tab.label}
paragraph={tab.paragraph}
onClick={() => handleTabClick(index)}
progress={index === activeTab ? progress : undefined}
intervalDuration={intervalDuration}
/>
))}
</div>
<div className="block md:hidden">
<AnimatePresence mode="wait">
<motion.p
key={tabs[activeTab]?.paragraph}
initial={{ opacity: 0 }}
animate={{ opacity: 1, transition: { duration: 0.1, delay: 0.2 } }}
exit={{ opacity: 0, transition: { duration: 0.05 } }}
className="text-foreground-lighter text-sm"
>
{tabs[activeTab]?.paragraph}
</motion.p>
</AnimatePresence>
</div>
</SectionContainer>
)
}
const OpenInColab = ({ colabUrl, className }: { colabUrl: string; className?: string }) => (
<Link
href={colabUrl}
target="_blank"
className={[
'flex items-center z-10 h-10 bg-surface-100 hover:bg-surface-200 hover:text-foreground-lighter text-sm text-foreground-lighter shadow-lg hover:shadow-md rounded-full py-1 px-3 gap-2',
className,
].join(' ')}
>
<Image
className="opacity-100 hover:opacity-80 transition-opacity contrast-[.2] filter"
src="/images/logos/google-colaboratory.svg"
alt="Google Colaboratory logo"
width={30}
height={30}
/>
<span>Open in Colab</span>
</Link>
)
export default TimedTabsSection