Viewerframe Mode Full May 2026
Wrap your viewerframe in a stable parent <div> with specific aspect ratio (e.g., aspect-ratio: 16/9; ) for inline mode, so the page doesn't collapse when full mode is activated. Mobile Safari Quirks On iOS, viewerframe mode full behaves differently. Safari reserves a "home indicator" bar. You must use the following CSS pseudo-selector to truly hide the UI:
<!-- This will break "mode full" --> <iframe src="viewer.html" sandbox="allow-scripts"></iframe> <!-- Fix: Add allowfullscreen and proper sandbox flags --> <iframe src="viewer.html" allow="fullscreen" sandbox="allow-scripts allow-same-origin"></iframe> Case Study A: Architectural Review A construction firm uses viewerframe mode full on an iPad Pro connected to a 4K monitor. The foreman taps a button, the BIM model viewer expands, hiding the file browser. This allows for pixel-perfect verification of HVAC placements against the actual ceiling grid. The hidden browser tabs reduce distraction. Case Study B: E-commerce Customization A luxury car configurator uses a half-screen viewerframe for selecting paint colors. When the user clicks "Inspect Interior," the viewerframe transitions to mode full . The 3D leather stitching becomes visible at 1:1 scale, increasing conversion trust by 40% (internal metrics). Case Study C: Medical Imaging PACS (Picture Archiving and Communication Systems) web viewers rely on viewerframe mode full to allow radiologists to examine X-rays or MRIs on a black background. The elimination of white UI chrome reduces eye strain and improves diagnostic accuracy. SEO and Performance Considerations Using "viewerframe mode full" can impact your site's performance if not implemented correctly. The "Layout Shift" Warning When you switch a viewerframe from inline to full, you are removing it from the DOM flow and re-rendering it at the top layer (z-index: 9999+). Ensure your CSS does not cause a Cumulative Layout Shift (CLS) when full mode is exited.
:-webkit-full-screen .viewerframe-controls display: none; /* Hide custom controls to avoid double-layering */ viewerframe mode full
| Parameter | Behavior | Typical Use Case | | :--- | :--- | :--- | | | Content remains within the bounds of the webpage, respecting CSS margins, padding, and adjacent sidebars. | Browsing a gallery, reading documentation, watching a video in an article. | | Viewerframe mode full | Content expands to cover the entire monitor; browser UI, taskbar, and surrounding page elements are hidden. | Critical analysis of 3D models, cinematic playback, presentation mode. |
Ensure the viewerframe source and the parent page both use https:// . Problem 3: iFrame Sandboxing If your viewerframe is embedded inside an <iframe> with restrictive attributes, full mode will fail. Wrap your viewerframe in a stable parent <div>
// Hypothetical API for a viewerframe library const myViewer = new ViewerFrame( container: 'canvas-container', mode: 'inline' // initial state ); // Function to trigger full mode function enterFullMode() myViewer.setMode('full'); // Or using native Fullscreen API on the canvas element document.getElementById('viewer-canvas').requestFullscreen();
<video id="corporateVideo" width="100%"> <source src="presentation.mp4" type="video/mp4"> </video> <script> const video = document.getElementById('corporateVideo'); video.addEventListener('loadedmetadata', () => // Request full mode for the viewerframe container const container = document.querySelector('.viewerframe-container'); if (container.requestFullscreen) container.requestFullscreen().catch(err => console.log( Error attempting full mode: $err.message ); ); You must use the following CSS pseudo-selector to
Platforms like Convida (a common source for "viewerframe" parameters) use URL modifiers. To force a shared asset to load directly in full-screen viewer mode, you append the string to the URL: