`<url>`

The <url> tag is used to link to an external website. If you are linking to a page within the same document, use <xref> instead.

A <url> may be self-closing, but for accessibility reasons, it is recommended that the <url> wrap text that describes the link. See An Accessible URL for an example.

Syntax

Attributes

Attributes for `<url>`
Attribute	Required?	Values
`href = "…"`	required	`string`
`visual = "…"`	optional	`string`

Children

The following may appear as children: <abbr> <acro> <alert> <articletitle> <attr> <c> <delete> <em> <email> <fillin> <foreign> <init> <insert> <m> <pf> <prefigure> <pubtitle> <quantity> <stale> <tag> <tage> <taxon> <term> Text

Parents

This element may appear as an immediate child of the following elements: <alert> <angles> <articletitle> <attribution> <biblio> <caption> <cell> <dblbrackets> <delete> <em> <entity> <event> <feedback> <fn> <foreign> <insert> <intertext> <li> <line> <p> <prompt> <pubtitle> <q> <shortlicense> <sq> <stale> <subtitle> <support> <term> <title> <tn> <website>

Examples

A Minimal URL

A url with no additional information (generally considered bad practice for accessibility reasons).

The `visual` Attribute

A url with the visual attribute set. If the visual attribute is provided and the <url> tag has no content, then the content of the visual attribute will be shown.

An Accessible URL

A url that has both a simplified form for print (via the visual attribute) and a reasonable text for the web.

<unit><usage>

<url>