Hyperlink

Hyperlink[uri]

represents a hyperlink that jumps to the specified URI when clicked.

Hyperlink[label,uri]

represents a hyperlink to be displayed as label.

Details and Options

  • The following forms of URIs can be used:
  • "string"a URI such as "http://www.wolfram.com"
    URL["url"]an explicit URL
    File["filepath"]a local notebook file
    {"file.nb",None}a complete local notebook file
    {"file.nb","tag"}the first cell with the specified tag in a local notebook file
  • Local notebook files can be specified by relative paths such as "../file.nb". The base of the paths is taken to be the location of the notebook that contains the hyperlink.
  • Hyperlink can be used with graphics or any other expression.
  • Hyperlink objects can appear within graphics.
  • By default, Hyperlink renders label in "Hyperlink" style.
  • When the mouse is over label, it is by default rendered in "HyperlinkActive" style.
  • The following options can be given:
  • ActiveStyle"HyperlinkActive"style to add when hovering over the hyperlink
    BaseStyle"Hyperlink"base styles for the hyperlink
    HyperlinkAction"New"action to take when following the hyperlink
  • Supported URI types include "http", "file", "ftp", and "mailto".
  • URIs that begin with "paclet:" directly access Wolfram System documentation and other resources.
  • Hyperlinks of different types are handled as follows:
  • notebook file URIopen in current Wolfram System session
    non-notebook file URIopen through operating system
    non-file URIopen in a web browser
  • In a standard notebook front end, hyperlinks can be inserted using the Hyperlink item in the Insert menu.
  • clicking a hyperlink will always open a new notebook window, even if an existing window could have been used.
  • In a cloud notebook, Hyperlink with a target outside that notebook will open a new browser window or tab by default. The option HyperlinkAction"Recycled" may be given to reuse the existing view.

Examples

open allclose all

Basic Examples  (2)

Create a link to the documentation:

Scope  (3)

Use Style and other functions to change the appearance of the link:

The label can be any expression:

Convert a URL object to a link:

Options  (10)

ActiveStyle  (1)

Specify the style when the mouse is over the hyperlink:

Show no change in style:

Alignment  (1)

Change the alignment within the link:

Appearance  (1)

Predefined hyperlink appearances:

The same appearances when the hyperlink is clicked:

Background  (1)

Change the background color:

BaselinePosition  (1)

Align the link with surrounding text:

Enabled  (1)

By setting Enabled->False, disable a link:

FrameMargins  (1)

Add margins within the clickable area:

ImageMargins  (1)

Add margins outside of the hyperlink:

ImageSize  (1)

Change the overall size:

HyperlinkAction  (1)

Create a link that recycles the current cloud notebook view:

Applications  (1)

Use hyperlinks on individual curves (click curve to activate):

Properties & Relations  (1)

Use StatusArea to change the message in the status area:

Introduced in 2007
 (6.0)
 |
Updated in 2008
 (7.0)
2020
 (12.1)