User Tools

Site Tools


harlowe:goto-url

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

harlowe:goto-url [2017/10/09 20:39] (current)
Line 1: Line 1:
 +**(goto-url:​ // [[harlowe:​String|String]]//​) -> //​[[harlowe:​Command|Command]]//​**
  
 +When this [[harlowe:​Command|command]] is used, the player'​s browser will immediately attempt to leave
 +the story'​s page, and navigate to the given URL in the same tab. If this succeeds, then
 +the story session will "​end"​.
 +
 +=== Example usage: ===
 +
 +''​%%(goto-url:​ "​http://​www.example.org/"​)%%''​
 +
 +=== Details: ===
 +
 +If the given URL is invalid, no error will be reported - the browser will simply attempt to
 +open it anyway.
 +
 +Much like the ''​%%<​a>​%%''​ HTML element, the URL is treated as a relative URL if it doesn'​t start
 +with "​http://",​ "​https://",​ or another such protocol. This means that if your story file is
 +hosted at "​http://​www.example.org/​story.html",​ then ''​%%(open-url:​ "​page2.html"​)%%''​ will actually open
 +the URL "​http://​www.example.org/​page2.html"​.
 +
 +=== See also: ===
 +
 +[[harlowe:​open-url|(open-url:​)]]
harlowe/goto-url.txt ยท Last modified: 2017/10/09 20:39 (external edit)