url_open_full

Opens a URL on a browser, with a specific target and formatting.

Syntax:

GML Code Example

url_open_full(url, target, options);


Argument Description
url The URL (website address) to link to.
target This is the target area to open the URL in (see description).
options Standard browser options (see description).


Returns: N/A


Description

This will open the specified URL on the browser of the chosen target device, or, if you are using the HTML5 module, in the currently open browser. The "target" parameter that you specify is the same as the standard JavaScript "name" value when you use the open() method (be aware that all but '_self' may result in the browser blocking, or asking the user if they wish to allow it) and the "options" is the same as the JavaScript "specs" parameter for controlling what properties the new window/tab should display (not all browsers may support all features).

Valid targets are:

"_self": Opens the linked document in the same frame as it was clicked (this is default).
"_blank": Opens the linked document in a new window or tab (this will not work if pop-ups are being blocked by the user, in which case you can use the clickable_* functions instead).
"_parent": Opens the linked document in the parent frame.
"_top": Opens the linked document in the full body of the window.

Valid options are:

"height=[px]": The height of the window, with the minimum value being 100.
"width=[px]": The width of the window, with the minimum value being 100.
"left=[px]": The left position of the window.
"top=[px]": The top position of the window (IE only).
"location=[boolean]": Whether or not to display the address field (default is 1).
"menubar=[boolean]": Whether or not to display the menu bar (default is 1).
"resizable=[boolean]": Whether or not the window is resizeable (default is 1).
"scrollbars=[boolean]": Whether or not to display scroll bars (default is 1).
"status=[boolean]": Whether or not to add a status bar (default is 1).
"titlebar=[boolean]": Whether or not to display the title bar. This is ignored unless the calling application is an HTML Application or a trusted dialog box (default is 1);
"toolbar=[boolean]": Whether or not to display the browser tool-bar (default is yes).

NOTE: On the Windows 8 (JS) target platform, this function will work, but additional parameters will be ignored and the default browser will be launched with the given url.


Example:

GML Code Example

url_open_full( 'http://yoyogames.com', '_blank', 'resizable=0, height=200, scrollbars=0');

This would open the YoYo Games homepage in a new window that can't be resized, has a height of 200 pixels and no scrollbars.


Back: HTML5



No Examples Submitted

Does this page need better examples? Be the first to Submit

No Edits Suggested

Is this page unclear or not descriptive enough? Suggest an edit to the page and with enough upvotes your changes will be made.

No Questions Have Been Ask

Do you have a question about this page? Ask it Here