peter
1c4f0042d2
- Files toolbar link box (paste button, Enter); a lone http(s) link pasted onto any page opens the one app-wide download dialog, which now names the link; the palette's "Download from a link…" focuses the box on its history entry. - The download tray, bottom right on every page: what waits, runs, is paused or failed (reason + Retry, the queue's right-click / "…" menu), and what finished in this tab as "Done · Open" until closed; folds to a pill (per-account pref); closed, it stays shut — across a reload — until the work changes or something finishes. Back to top steps up over it, the page end keeps clear. - A finish is announced once: "Downloaded: …", whether a phone plays it, Copy link + Open (toasts and notices may carry a second action). - The inbox's ready notice opens the file in its folder: download_done carries job_id + folder_id. - GET /api/downloads is the queue only (in flight, failed, finished in the last 10 minutes), with each row's source key.
79 lines
4.3 KiB
TypeScript
79 lines
4.3 KiB
TypeScript
import { useEffect, useRef } from "react";
|
|
import { createPortal } from "react-dom";
|
|
import { ArrowUp } from "lucide-react";
|
|
import { useTranslation } from "react-i18next";
|
|
import { Pressable } from "./Pressable";
|
|
import { SURFACE } from "./surfaces";
|
|
import { backToTopShown, useBackToTopShown, useCornerLift } from "./backToTopState";
|
|
|
|
// A floating "back to top" button that fades in once the current page's scroll container is
|
|
// scrolled past a threshold, and smooth-scrolls it back to the top. Every page scrolls inside a
|
|
// <main class="overflow-y-auto"> — the normal pages share App's, the channel page renders its own
|
|
// — so this follows whichever one is mounted. Portaled to <body> so its fixed position is
|
|
// viewport-relative regardless of transformed ancestors.
|
|
export default function BackToTop({ dep, threshold = 600 }: { dep?: unknown; threshold?: number }) {
|
|
const { t } = useTranslation();
|
|
// Shared, not local: PageScroller keeps the page's end clear of the button while it is up.
|
|
const show = useBackToTopShown();
|
|
// Over the download tray when it is up: the tray's 1rem inset, its height, then a gap.
|
|
const lift = useCornerLift();
|
|
const scrollerRef = useRef<HTMLElement | null>(null);
|
|
|
|
// Listen on the document in the CAPTURE phase and read the scroller off the event, rather than
|
|
// looking <main> up when this binds. Scroll events don't bubble, but they do capture — and the
|
|
// lookup was a race the lazy pages lost: on the FIRST visit to the channel page its chunk is
|
|
// still loading, so the Suspense fallback is on screen, there is no <main> to find, and the
|
|
// effect gave up for good (its dep never changes again). The button then stayed dead for that
|
|
// whole visit and came back only once the chunk was cached. Nothing to find, nothing to race.
|
|
useEffect(() => {
|
|
const onScroll = (e: Event) => {
|
|
const el = e.target as HTMLElement | null;
|
|
if (!el || el.tagName !== "MAIN") return;
|
|
scrollerRef.current = el;
|
|
backToTopShown.set(el.scrollTop > threshold);
|
|
};
|
|
document.addEventListener("scroll", onScroll, { passive: true, capture: true });
|
|
return () => document.removeEventListener("scroll", onScroll, { capture: true });
|
|
}, [threshold]);
|
|
|
|
// On navigation, re-read where the new page sits: usually the top (so hide), but some pages
|
|
// restore their scroll position. Missing <main> here is now harmless — a page that hasn't
|
|
// rendered hasn't scrolled either, and the listener above picks it up the moment it does.
|
|
useEffect(() => {
|
|
const el = document.querySelector("main");
|
|
scrollerRef.current = el;
|
|
backToTopShown.set(!!el && el.scrollTop > threshold);
|
|
}, [dep, threshold]);
|
|
|
|
// A keyboard press hides the button it was on: the focus goes to the page it scrolled (its <main>
|
|
// is a focus rest, not a Tab stop), not left on an invisible control.
|
|
const toTop = (e: React.MouseEvent) => {
|
|
const main = scrollerRef.current ?? document.querySelector("main");
|
|
main?.scrollTo({ top: 0, behavior: "smooth" });
|
|
if (e.detail === 0) main?.focus({ preventScroll: true });
|
|
};
|
|
|
|
// No aria-label/title attributes: ad-block "annoyance" cosmetic filters (e.g. Brave Shields)
|
|
// commonly hide floating corner buttons via attribute selectors like [aria-label="Back to top"].
|
|
// The accessible name comes from a visually-hidden child instead, which those selectors can't match.
|
|
// Shape (docs/DESIGN.md A2): round because it floats over the content, 3rem (48) on mouse and touch —
|
|
// a lone corner button at a toolbar rung gets lost.
|
|
return createPortal(
|
|
<Pressable
|
|
align="center"
|
|
onClick={toTop}
|
|
// Hidden, it only goes transparent (so it can fade): out of the Tab order as well.
|
|
tabIndex={show ? undefined : -1}
|
|
aria-hidden={show ? undefined : true}
|
|
style={lift ? { bottom: `calc(${lift}px + 1.5rem)` } : undefined}
|
|
className={`fixed bottom-5 right-5 z-chrome inline-flex items-center justify-center size-12 ${SURFACE.floating} glass-hover text-fg hover:text-accent transition-all duration-200 ${
|
|
show ? "opacity-100 translate-y-0" : "opacity-0 translate-y-3 pointer-events-none"
|
|
}`}
|
|
>
|
|
<ArrowUp className="size-5" aria-hidden="true" />
|
|
<span className="sr-only">{t("common.backToTop")}</span>
|
|
</Pressable>,
|
|
document.body,
|
|
);
|
|
}
|