Web Browser Component

The Web Browser comp onent in Designer allows you to embed a full web browser inside of an Ignition Client. This component becomes available in Designer after you download the Web Browser module from the Inductive Automation's website. The Web Browser modu le installs the same way as any other modules. Once this component is added onto a window, it will behave just like any other web browser when it is inside a Client.

Basic Usage

When the Web Browser module is installed, a new section titled Web Browser will appear in the Designer's Component Palette. Drag the Web Browser on to a Vision window just like any other component.

Behavior

Popups AllowedPopups are allowed by default. If unchecked, popup windows will not be shown to the user.Zoom LevelZoom level is set to 0.0 by default. Positive numbers zoom in, negative numbers zoom out. The zoom level will not be applied until the page has finished loading.Show Navigation ButtonsShow Navigation Buttons is checked by default. If unchecked, the user will not see the forward, back, or reload buttons, and will not be able to type a URL into the navigation bar. They will still be able to navigate by clicking links on web pages.

Data

 

 

Mode

Mode controls whether Starting URL or Starting HTML will be used.

Starting URL

Starting URL is blank by default. When the client is started, the Web Browser will navigate to the URL entered here if mode is URL.

Starting HTML

Starting HTML is

<html><body>&nbsp;</body></html>

by default, which gives a blank page. When the client is started, the Web Browser will load the HTML entered here if the mode is HTML.

Use Proxies

Use Proxies is unchecked by default. If checked, the Web Browser will try to use the proxy settings below.

HTTP Proxy Server

HTTP Proxy Server sets the proxy server for HTTP connections. This setting is only used when Use Proxies is checked.

HTTP Proxy Port

HTTP Proxy Port sets the proxy port for HTTP connections. This setting is only used when Use Proxies is checked.

HTTPS Proxy Server

HTTPS Proxy Server sets the proxy server for HTTPS connections. This setting is only used when Use Proxies is checked.

HTTPS Proxy Port

HTTPS Proxy Port sets the proxy port for HTTPS connections. This setting is only used when Use Proxies is checked.

FTP Proxy Server

FTP Proxy Server sets the proxy server for FTP connections. This setting is only used when Use Proxies is checked.

FTP Proxy Port

FTP Proxy Port sets the proxy port for FTP connections. This setting is only used when Use Proxies is checked.

Proxy Exceptions

Domains listed here, such as <local>, will not use the proxy server. This setting is only used when Use Proxies is checked.

Use Proxy Authentication

If Use Proxy Authentication is checked, the browser will use the username and password below for proxy authentication. This setting is only used when Use Proxies is checked.

Proxy Username

The username to use for proxy authentication. This setting is only used when Use Proxies and Use Proxy Authentication are checked.

Proxy Password

The password to use for proxy authentication. This setting is only used when Use Proxies and Use Proxy Authentication are checked.

Advanced Usage

The underlying browser component is available in scripting through the getBrowser() method. Documentation on the browser component is available at the JxBrowser Programmer’s Guide. The Inductive Automation support team is unable to provide detailed advice on scripting with this component. Furthermore, they are unable to provide troubleshooting beyond the basic functionality of the module.

Next...