Skip to content

Improve wide-table display on desktop and mobile - #3497

Open
anegg0 wants to merge 2 commits into
masterfrom
table-display-improvements
Open

Improve wide-table display on desktop and mobile#3497
anegg0 wants to merge 2 commits into
masterfrom
table-display-improvements

Conversation

@anegg0

@anegg0 anegg0 commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Description

Make wide reference tables usable on desktop and mobile without widening the page globally (which trades prose measure and the table of contents for table width on every doc).

  • Sticky first column + horizontal scroll on desktop; card-stack on phones (each row becomes a labelled card). Scoped to .stacked-table so plain tables are untouched.
  • Merge the redundant "Solidity interface" and "Go implementation" columns of the generated precompile tables into one Source cell, freeing width for the description. Regenerated all 16 partials.
  • New rehype-table-labels plugin stamps data-label/stacked-table onto markdown tables wider than two columns, so the chain-info tables (including the 8-column RPC table) card-stack on mobile. Colocated test.

Document type

  • Codebase changes

Checklist

  • My code follows the existing code style and conventions
  • I have tested my changes locally with yarn start or yarn build
  • I have checked for broken links
  • I have verified that my changes don't break the build

Additional Notes

Supersedes the global-width approach (branch arbchain-intro-formatting, #3495); that surgery is reverted here.

Wide reference tables (precompile methods, chain-info address and RPC
matrices) never fit a phone and crowd the desktop column. Rather than
widen the page globally, which trades prose measure and the table of
contents for table width on every doc, make wide tables usable at the
natural column width.

- Add _tables.scss: horizontal scroll and a sticky first column on
  desktop, and a card-stack layout on phones where each row becomes a
  labelled card. Scoped to .stacked-table so plain tables are untouched.
- Wrap tables in a scroll container via MDXComponents.
- Merge the redundant Solidity interface and Go implementation columns
  of the generated precompile tables into one Source cell, freeing width
  for the description. Regenerate all 16 partials.
- Add rehype-table-labels to stamp data-label and stacked-table onto
  markdown tables wider than two columns, so the chain-info tables
  card-stack on mobile. Covered by a colocated test.
@vercel

vercel Bot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
arbitrum-docs Ready Ready Preview Jul 31, 2026 7:18pm

Request Review

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