Arma 3 Scripting

Command in GUI Control

htmlLoad

Also available as Markdown and JSON, or read the original wiki page.

Description

Load HTML from file or URI using given control. File path is relative to current mission dir or an absolute path (with drive letter etc.). The command is subject to restrictions, imposed by CfgCommands class.

Note

Arma 3: Since Arma 3 v2.10 the 'title' attribute is supported within <img> and <a> html tags

Important

For unknown reasons, URL's length is limited to 255 characters.

Syntax

control htmlLoad filename

Parameters:

Returns: Nothing

Examples

Example 1

_control htmlLoad "briefing.html";

Example 2

_control htmlLoad "http://www.bistudio.com/newsfeed/arma3_news.php?build=main&language=English";

Example 3

Display news item:

0 spawn {
    disableSerialization;
    private _html = findDisplay 46 createDisplay "RscCredits" ctrlCreate ["RscHTML", -1];
    _html ctrlSetBackgroundColor [0,0,0,0.8];
    _html ctrlSetPosition [safeZoneX, safeZoneY, safeZoneW, safeZoneH];
    _html ctrlCommit 0;
    _html htmlLoad "http://www.bistudio.com/newsfeed/arma3_news.php?build=main&language=English";
};

See also

ctrlHTMLLoaded · loadFile · preprocessFile · preprocessFileLineNumbers · HTML File Format

Community notes

BrotherhoodOfHam

htmlLoad works with URLs as well as html files.

Killzone_Kid

While htmlLoad surprisingly does work with URLs as pointed above, the operation is blocking, meaning the whole game will freeze until the operation is complete. It is therefore not recommended to use this command in such way.

Benargee

Example use of URL can be found in BIS_fnc_GUInewsfeed with the function browser.

Tupolov

(Arma 3) In order to use URLs, they must be included in CfgCommands -> allowedHTMLLoadURIs. In order to use URIs with params a wildcard * character is supported: Script

_newsOnline = "http://alivemod.com/alive_news.php?map=" + _map + "&mission=" + _mission + "&player=" + _player;
_ctrlHTML htmlLoad _newsOnline;

Config

class CfgCommands {
    allowedHTMLLoadURIs[] += {
        "http://alivemod.com/alive_news.php*"
    };
};