Web View

This component embeds a web browser view into your Project. No browser controls are shown, only the page
itself.

The browser is the default provided by the operating system, so has the same features and limitations as
that browser

  • Windows: Internet Explorer 11 (not Edge). Note: a registry key is required for standalone (published) Windows apps, see below.
  • MacOS: Safari
  • Android: Android web view (not Chrome)
  • iOS: Mobile Safari

The web view displays the default URL when first shown. You can use the Set Web View URL action to
navigate the web view to a different URL.

If a Umajin component goes over top of the web view, it will be hidden and a placeholder displayed instead.


Properties for Web View Component

NameWhen components are placed on a page they appear highlighted blue in the scene tree and can
be renamed by double clicking in this panel and typing the new name. Components can also be
set to be visible/invisible on the page, using the ‘eye’ icon on this panel.
Position and SizeSets position and size. As long as measurements are maintained as percentages it deals
automatically with dynamic layout and resizing for different devices and orientations. You
can use millimeters to control aspects of size like width or height on order to create a web
view component thats size will be maintained across devices.
Default URLDisplays default Umajin URL which can be edited to display desired URL.
Clear on hideIf checked, the web page will be unloaded by setting URL to about:blank when a different app page is selected.

Actions

The action Set Web View URL (JS: set_web_view_url) will cause navigation to a new URL.


Events

The Web View Component has 3 special events that you can add actions to. These can be found under the Actions Tab.

On Progressfires as the URL is downloading. Parameters: [url] the URL being loaded.
On Completefires when the component has completed loading the URL. Parameters: [url] the final URL that was loaded (in case of redirects this could be different to the original request)
On Errorfires when an error occurs loading the URL. Parameters: [url] the final URL that was being loaded. [error] The error message.
On URL Change

fires whenever the URL changes, even just the #anchor part. This can be useful to receive information out of the web page by encoding it into the anchor part of the URL using window.location.hash =. from Javascript on the page. Parameters: [url] the new URL.

Note: not implemented on Android.


API calls

webViewRunJavascript  Runs Javascript in the context of the web page.


Using WebView in Standalone Windows Apps

If you want to run your app standalone on Windows:

The Web View component in Editor uses an embedded Internet Explorer ActiveX component on Windows. By default this control defaults to ancient “IE7 compatible” view.

To make it more useful, we need to configure the embedded IE control into a more modern rendering mode, using the registry key at

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION

Add a DWORD named <yourappname>.exe and set it’s value to decimal 11000

For more information: Internet Explorer Browser Emulation