Skip to content

chore: Sync the vendored UI with upstream antora-ui-default, part 2: JS and a11y ports - #920

Merged
lfrancke merged 18 commits into
mainfrom
phase3/js-ports
Aug 13, 2026
Merged

chore: Sync the vendored UI with upstream antora-ui-default, part 2: JS and a11y ports#920
lfrancke merged 18 commits into
mainfrom
phase3/js-ports

Conversation

@lfrancke

@lfrancke lfrancke commented Aug 12, 2026

Copy link
Copy Markdown
Member

Part 2 of the vendored-UI re-sync with upstream, following #906

This PR focuses on the JS and accessibility stuff (after this we have CSS left)

Similar to last time: CLA checks will fail by design so I'll manually merge this but still want a review. See #906 for details.

User-visible

One new feature and it's not very exciting. The ToC that appears on content pages now has a expand/collabse button on hover.

The rest is mostly bugs for edge cases (switching from mobile to desktop view, a console warning and so on).

Four upstream commits did not land

Note

This section is entirely Claude generated and can be ignored. I left it in as a reference should we ever wonder why a certain commit isn't included.

  • fb151724 (overscroll) — already present in all four affected places.
  • 2bcdc3a2 (nav resilience) — already applied; git am detected it.
  • 9c6d2489 (highlight.js none language) — superseded by da14ed68, which is in this PR. Untagged blocks are no longer passed to highlight.js at all, so there is no unknown-language warning left to fix. Upstream made the same move itself, from defining none in 2022-03 to skipping untagged blocks in 2022-07.
  • cdd7b764 (scrollbar normalisation) — deferred. It needs two colour variables that do not exist yet (--scrollbar-track-color, --scrollbar_hover-thumb-color), and picking values is a design decision in a file the planned token work will rewrite. The @media (pointer: fine) gating in it is worth taking separately.

mojavelinux and others added 17 commits August 12, 2026 19:45
- prevents highlight.js from logging a warning about the unknown language "none"
…tate

Upstream did this in header-content.hbs (b35fcda, 86237c9), a partial this
repo replaced with its own header.hbs, so the change could not be ported and
is reapplied here. Ours targets the popup-menu container rather than
upstream's topbar-nav.

The button previously had no accessible name at all, and nothing exposed its
open/closed state; 05-mobile-navbar.js already maintains aria-expanded and now
reads aria-controls, falling back to data-target.

Co-Authored-By: Claude <noreply@anthropic.com>
Companion to upstream's def7144, which guards the same script against a
missing article.doc. Upstream needs no toolbar guard because every one of its
layouts has one; our landing layout does not, so jumpToAnchor could throw on
a page that has an article but no toolbar.

Treats an absent toolbar as a zero offset rather than returning early, so
anchor links keep working instead of silently doing nothing.

Co-Authored-By: Claude <noreply@anthropic.com>
@netlify

netlify Bot commented Aug 12, 2026

Copy link
Copy Markdown

Deploy Preview for stackable-docs ready!

Name Link
🔨 Latest commit 649b2c5
🔍 Latest deploy log https://app.netlify.com/projects/stackable-docs/deploys/6a7e31ca0c8d3a00083d99cd
😎 Deploy Preview https://deploy-preview-920--stackable-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@stackable-cla

stackable-cla Bot commented Aug 12, 2026

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
0 out of 2 committers have signed the CLA.

❌ mojavelinux
❌ ferdnyc
You have signed the CLA already but the status is still pending? Let us recheck it.

@lfrancke lfrancke self-assigned this Aug 12, 2026
@lfrancke lfrancke moved this to Development: Waiting for Review in Stackable Engineering Aug 12, 2026
@lfrancke
lfrancke marked this pull request as ready for review August 12, 2026 21:40
@xeniape xeniape moved this from Development: Waiting for Review to Development: In Review in Stackable Engineering Aug 13, 2026
@xeniape
xeniape self-requested a review August 13, 2026 08:24

@xeniape xeniape left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, just one minor thing

Comment thread ui/src/css/header.css Outdated
Co-authored-by: Xenia <xenia.fischer@stackable.tech>
@lfrancke

Copy link
Copy Markdown
Member Author

Thanks for the review and the fix!

@lfrancke
lfrancke merged commit 5964238 into main Aug 13, 2026
6 of 8 checks passed
@lfrancke
lfrancke deleted the phase3/js-ports branch August 13, 2026 21:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Development: In Review

Development

Successfully merging this pull request may close these issues.

4 participants