A newer version of this documentation is available.

View Latest

WebApp – GUI

The current version of Net iD Client is missing native versions of any dialog on all platforms. Instead the Client WebApp is used to show any GUI.

An implementation is available on all platforms. The basic feature is to show a web browser windows without anything except the web-view presentation. The web-view will be based on the WebKit available for each platform. Beside the presentation, the WebApp will also include a bridge between JavaScript and the native platform to be able to communicate with the plugin from JavaScript.

Windows
$ netidapp.exe -url http://www.islite.com
Linux
$ netidapp -url http://www.islite.com
macOS
$ /Applications/Net\ iD.app/Contents/MacOS/WebApp -url http://www.islite.com

The bridge between JavaScript and native is always active. Use our plugin JavaScript files to build your own WebApp based on our WebApp and HTML/JS/CSS:

_netid.js

Old – not recommened for new applications.

_netid-ng.js

New – recommened for new applications.

Options

Windows, Linux, and macOS

-url <url|show|hide|stop>
url

The address of the web page.

show

This argument requires that there is a specified hidden dialog box to show. This argument is only available on Windows.

hide

This argument requires that there is a specified dialog box to hide. This argument is only available on Windows.

stop

This argument requires that there is a specified dialog box to stop. This argument is only available on Windows.

-title <title>

The title of the dialog box.

-size 0xXXXXYYYY

The size of the dialog box. XXXX for width, YYYY for height. If both values are 100 or less the values are treated as percentage of the screen width and height.

-resizing

User can minimize/maximize and change the size of the dialog box.

-useragent <text>

The useragent text is the string that is presented as the user-agent in the web browser JavaScript environment.

Windows and Linux

-center

Position the dialog box in the middle of the screen.

-position 0xXXXXYYYY

The position of the dialog box. The coordinate system starts in the upper left corner of the screen. XXXX is distance from left to right, and YYYY is distance from top to bottom. 0x7FFF is the maximum value, since 0x8000 will be the bottom right corner.

-fullscreen

Set dialog box to show in full screen.

-system

Position dialog box over all non system dialog boxes.

Windows

-icon auto|dark|light

Black or white iD-logo.

-hidden

Start without showing the dialog. It is also possible to show and hide the dialog box without the need of a restart.

-noclose

User cannot close the dialog box.

-noframe

Remove the dialog box frame. We recommend to use noframe with option -fullscreen.

-notitle

Remove title row.

-shortcuts all|none|<custom>

Specify how to use shortcuts.

all

All shortcuts are allowed.

none

No shortcuts are allowed.

<custom>

Specify allowed shortcuts using "shortcut1;shortcut2", where shortcutN is on the form "Ctrl+Alt+2". If you specify several shortcuts, separate them using a semicolon (;).

The shortcuts ctrl+c, ctrl+v, and ctrl+alt+2 always work, unless you have specified -shortcuts none.
-tool

Make title and dialog frames like tool window instead of a dialog window.

-transparent 0xRRGGBB

The RGB color code to translate to transparent. This option requires -noframe to be specified.

-unique <name>

Unique name. Starting with the same name again will deactivate the first.

Linux

-wait NN

Time to wait until dialog is shown (WebKit is a bit difficult). NN is the number of milliseconds. Default is 3.

Examples

The examples below shows how to start a hidden dialog box, show the dialog box, hide it again, and then stop it.

Example 1. Open a hidden dialog box.

Open a dialog box with a specified name and URL and make it hidden.

$ netidapp.exe -unique MegaCoolDialog -url http://www.islite.com -hidden
Example 2. Show the hidden dialog box.

Show a specified and hidden dialog box.

$ netidapp.exe -unique MegaCoolDialog -url show
Example 3. Hide a dialog box.

Hide a specified dialog box.

$ netidapp.exe -unique MegaCoolDialog -url hide
Example 4. Stop a dialog box.

Stop a specified dialog box.

$ netidapp.exe -unique MegaCoolDialog -url stop
Example 5. Adding a shortcut

To allow the shortcut for writing the dollar sign ($), use the following command:

$ netidapp.exe -url \https://<nipurl> -shortcuts "ctrl+alt+4"