Skip to content

Show that the tutorial strip scrolls, and add a Top link - #24

Merged
cdiddens merged 1 commit into
pyoomph:mainfrom
cdiddens:scroller-affordance
Aug 7, 2026
Merged

Show that the tutorial strip scrolls, and add a Top link#24
cdiddens merged 1 commit into
pyoomph:mainfrom
cdiddens:scroller-affordance

Conversation

@cdiddens

@cdiddens cdiddens commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Tutorial strip

The thumbnails on the front page scroll horizontally, but nothing said so: on macOS and on touch devices the overlay scrollbar only appears while scrolling, so the strip looked like a row that happened to be cut off at the page edge. Four cues now say otherwise, because no single one works on every device:

  • a framed panel around the strip (.scroller-frame), so it reads as one bounded thing;
  • a permanently visible scrollbar, thumb in the menu green #377e22scrollbar-width/scrollbar-color for Firefox, ::-webkit-scrollbar for Blink/WebKit;
  • edge shadows on whichever side still has content, via the background-attachment: local trick, so they disappear by themselves at either end;
  • a hint line← scroll sideways for more examples → — the only cue that survives on a touch screen with no pointer.

No JavaScript, so the site stays script-free.

gen_example_gallery.py changes because the frame and the hint have to be siblings of the <ul>, not part of it — inside it they would scroll away with the thumbnails.

The hint is unconditional: on a very wide monitor it shows even if a couple more thumbnails happen to fit. With 28 entries the strip overflows at any realistic width, and hiding it dynamically would need JavaScript.

Footer

The closing bar was an empty green strip. It now carries a right-aligned Top link with an up arrow, pointing at the existing #page-top anchor — on all three pages, since they share footer.html. It inherits the menu's font, white colour and #DDD hover. scroll-behavior: smooth is added, wrapped in prefers-reduced-motion: no-preference.

Docs

CLAUDE.md records syncing main and deleting the merged branch as part of the publishing flow, rather than as an afterthought.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Fmhceke9votYhvWyGSBKyG

The tutorial thumbnails were horizontally scrollable with nothing to say
so: on macOS and on touch devices the overlay scrollbar only appears
while scrolling, so the strip just looked like a row cut off at the page
edge. Four cues now say otherwise:

- a framed panel around the strip, so it reads as one bounded thing
- a permanently visible scrollbar, thumb in the menu green
- shadows at whichever edge still has content behind it, via the
  background-attachment: local trick, so they vanish at either end
- a "scroll sideways for more examples" line with arrows, which is the
  only cue that survives on a touch screen

No JavaScript, so the site stays script-free. The frame and the hint are
siblings of the <ul> rather than part of it, so they stay put while the
contents scroll - that is why gen_example_gallery.py changes too.

The footer bar, so far an empty green strip, gets a right-aligned "Top"
link with an up arrow pointing at the existing #page-top anchor, on all
three pages. Scrolling is smooth unless prefers-reduced-motion is set.

CLAUDE.md: record syncing main and deleting the merged branch as part of
the publishing flow.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fmhceke9votYhvWyGSBKyG
@cdiddens
cdiddens merged commit 2a5d510 into pyoomph:main Aug 7, 2026
1 check passed
@cdiddens
cdiddens deleted the scroller-affordance branch August 7, 2026 13:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant