---
name: "wml::std::href"
section: "3"
platform: "linux"
package: "wml"
version: "2.32.0~ds1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/wml::std::href"
---

# wml::std::href(3)

Enhanced Hyperlink

## NAME

wml::std::href - Enhanced Hyperlink

## SYNOPSIS

```
 #use wml::std::href
 <href url="..." [name="..."] [image="..."] [hint="..."] [target="..."]>
```

## DESCRIPTION

This is an interface to the standard HTML anchor tag (`"<a` `href="...">...</a>"`).  The intended use of `"<href>"` is to simplify the creation of hyperlinks. The following

```
  <href url="THE://URL">
  <href url="THE://URL" name="THE_NAME">
  <href url="THE://URL" image="THE_IMG.EXT">
  <href url="THE://URL" name="THE_NAME" image="THE_IMG.EXT">
  <href url="THE://URL" hint="THE_HINT">
  <href url="THE://URL" name="THE_NAME" image="THE_IMG.EXT" hint="THE_HINT">
```

gets expanded to

```
  <a href="THE://URL"><tt>THE://URL</tt></a>
  <a href="THE://URL">THE_NAME</a>
  <a href="THE://URL"><img src="THE_IMG.EXT" alt="THE://URL" border="0"></a>
  <a href="THE://URL"><img src="THE_IMG.EXT" alt="THE_NAME" border="0"></a>
  <a href="THE://URL" onmouseover="self.status='THE_HINT';return true" onmouseout="self.status='';return true" onfocus="self.status='THE_HINT';return true" onblur="self.status='';return true"><tt>THE://URL</tt></a>
  <a href="THE://URL" onmouseover="self.status='THE_HINT';return true" onmouseout="self.status='';return true" onfocus="self.status='THE_HINT';return true" onblur="self.status='';return true"><img src="THE_IMG.EXT" alt="THE_NAME" border="0"></a>
```

## AUTHOR

```
 Ralf S. Engelschall
 rse@engelschall.com
 www.engelschall.com
```

## REQUIRES

```
 Internal: P1, P2
 External: --
```

## SEE ALSO

HTML `"<a>"` and `"<img>"` tags.