Skip to content

Prototype web 3D device view

The prototype web page can switch its flat device frame into an opt-in 3D view that orbits, rotates and folds through the setPosture postures (src/features/prototype/web/webDevice3d.ts). It is built from CSS 3D transforms on the page’s existing DOM, with no WebGL and no dependency, as a toggle, a posture select, a hinge slider and keyboard orbit. The shown view stays live DOM (crisp, selectable text and an unchanged accessibility tree); only compositor transforms change, so a fold or orbit never re-lays out the prototype. It builds on the page in Prototype web renderer and the multi-panel frames in Prototype web frames for every form factor.

Constraints

  • No network. The page’s CSP is default-src 'none' with every script pinned by hash, so nothing can be lazy-loaded at runtime. Whatever the 3D view needs is inlined, or the page is built without it.
  • Budgets. The inlined script is at most 150 KB and the page at most 2 MiB. Views are pre-rendered on the host; the page script only shows, hides and moves them.
  • Static views. A view is a pre-rendered DOM subtree. Taps do nothing, so the state to keep across a 2D/3D switch is the runtime’s in-memory selection (variant, revision, screen, orientation, zoom), not prototype state.

How the CSS 3D view is built

  • The viewport gets perspective; the stage and the shown view get transform-style: preserve-3d. The device orbit is a rotateX/rotateY on a box inside the stage that holds the views, not on a view. Rotate animates the views’ own transforms, so both views keep the orbit through the turn, and the stage’s pan and zoom stay in screen space outside it.
  • Leaves. The shown frame element stays in place as the fixed leaf, clipped at the hinge line with clip-path; it is never moved or re-rendered. The moving leaf is an overflow: hidden box for the rest of the frame, holding a clone of the frame offset by the hinge position, turned about the hinge line. A frame without a hinge is one leaf with one back plate. CSS cannot paint one subtree in two places, so one leaf is always a copy; the clone is inert and aria-hidden, so assistive technology reads the screen once.
  • Faces. Each leaf has a front and a back plate with backface-visibility: hidden, so coplanar faces never z-fight and a closed device shows its outside rather than a mirrored screen.
  • No clip-path on 3D-transformed elements. In Chromium, a leaf that combined clip-path with its own 3D transform inside the preserve-3d context did not render once turned; an overflow: hidden box did, so only the untransformed fixed leaf uses clip-path.
  • 2D to 3D. Entering 3D wraps the shown view at the flat pose, then transitions to a three-quarter pose; leaving transitions back to flat and removes the added elements when the transition ends. The shown view’s DOM is byte-identical before and after.
  • Hinge axis. A vertical hinge (book) turns the right leaf with rotateY; a horizontal hinge (flip) turns the bottom leaf with rotateX. The axis and hinge position (the hinge’s centre as a share of its panel) come from the frame’s hinge, given in portrait. Landscape turns the frame a quarter counterclockwise, so a book’s hinge becomes horizontal and a flip’s vertical.
  • Scope of the 3D CSS. Every 3D rule applies only while a view is wrapped (data-device3d on body), so the 2D page renders exactly as without the 3D view.

Posture parity

  • The posture select uses the setPosture names (closed, half_opened, opened, tent, flipped, rear_display) and the hinge slider uses degrees with 180 flat and 0 shut, as setPosture’s hingeAngle does. The angle drawn for each posture is the frame’s postures[].hingeDegrees.
  • hingeAngle stops at 180, so tent and flipped (folded backwards past flat) are reachable only by name. The web model draws them above 180 (for example 290 for tent), so the slider runs 0–360.
  • The page does not mirror a live device’s posture.

Reflow during a fold

Posture is a pre-rendered view dimension, like orientation. While the hinge moves, the page shows the starting posture’s view; when the angle crosses a posture threshold it switches to that posture’s view, as a device reflows only when its device state changes. The thresholds are per device and come from the frame’s postures data, not the script. The layout shown is the frame’s posture whose hingeDegrees is nearest the hinge angle, so each threshold lies halfway between two of the frame’s postures. The status line names that posture.

  • The 3D runtime switches views through the 2D runtime’s posture select, so the 2D runtime shows the view and the 3D runtime wraps it like any newly shown view. The select carries data-keep-framing during that change, so the user’s zoom and pan stay.
  • Entering 3D starts from flat. A hinge already moved off flat (a posture chosen before entering) reflows on the first pose.
  • closed is never reflowed to: its view is the cover panel, not the folding inner panel, so shutting keeps the last open layout. Drawing the cover view on the moving leaf’s outside face is not built.
  • Leaving 3D shows the posture and screen the 2D page showed before entering, so the shown view’s DOM is unchanged. A posture whose stack lacked that screen had moved it to the stack’s start.

Device fidelity

Leaves are flat, drawn from the registry’s geometry (screen size, corner radius, bezel, hinge). No third-party device models are used.

Fallback and motion

  • 2D is the default; 3D is opt-in per page view. There is no WebGL fallback; where @supports (transform-style: preserve-3d) fails, the 3D toggle is not offered.
  • Under prefers-reduced-motion: reduce the transforms apply without transitions; 3D poses still work.

Accessibility

  • The 3D toggle is a button with aria-pressed; the posture select has a label; the hinge is a native range input, so arrow keys and assistive technology drive it.
  • With the viewport focused, arrow keys orbit (Shift for larger steps); Shift-drag orbits with a pointer, and a plain drag still pans.
  • A role="status" line states the hinge angle and the posture whose layout is shown.

Background