Zoom on Standard Web Pages

Supported In:

Kiosk Pro Basic, Plus and Enterprise

Allows you to control zoom on a webpage using the built-in iOS/iPadOS pinch and double tap gestures. 

Default Value:
  • Allow Viewport to Control Zoom through User-Scalable Property
Other Possible Values:
  • Disable Zoom
  • Always Allow Zoom (WKWebView only)

Zoom in or out occurs when a visitor uses two fingers and drags them away from or toward each other or if a visitor double taps on the screen.

By default, Kiosk Pro will rely on the "user-scalable" attribute set in the page's viewport. You also have the option to disable zooming entirely, or to override the viewport in order to allow zooming regardless.

WKWebView

The default WKWebView browser engine does not include a method for disabling zoom. When using "Disable Zoom", Kiosk Pro injects a script into each page:

var meta = document.createElement('meta');meta.setAttribute('name', 'viewport');meta.setAttribute('content', 'width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no');document.getElementsByTagName('head')[0].appendChild(meta);

UIWebView

The UIWebView browser includes a property called 'scalesPageToFit' which is disabled when using "Disable Zoom". Apple's documentation defines 'scalesPageToFit' as "a boolean value determining whether the webpage scales to fit the view and the user can change the scale."

Alternative to Disable Zoom

If you experience an issue with your page scale when using 'Disable Zoom' and are able to control the page code, you can instead set a viewport meta property in the <head> of your page to prevent zoom when used with the default 'Allow Viewport to Control Zoom through User-Scalable Property':

<meta name="viewport" content="user-scalable=no"/>

Values for Remote Settings Control & Managed App Configuration

Key kp_zoomWithStandardBrowserBehavior
Key Type integer
Default Value 1
Possible Values
  • 0 = Disable Zoom
  • 1 = Allow Viewport to Control Zoom through User-Scalable Property (default)
  • 2 = Always Allow Zoom (WKWebView only)

Change Log

  • Included as an on/off toggle in version 1.0. Restructured in version 9.4.8 to add the ability to allow zoom even when the webpage disables it through a viewport setting

Related Articles

Still stuck? How can we help? How can we help?