String.prototype.link()

La méthode link() permet de créer une chaîne de caractères représentant un élément HTML <a>, ce qui permet d'afficher la chaîne de caractères comme un lien hypertexte vers une URL donnée.

Syntaxe

js
str.link(url);

Paramètres

url

Toute chaîne de caractères pouvant être utilisée comme valeur pour l'attribut href de la balise a. Cette chaîne doit être une URL valide (relative ou absolue) dont les caractères & sont échappés en &amp;, et dont les doubles quotes (") doivent être échappées avec l'entité &quot;.

Valeur de retour

Une chaîne de caractères représentant un élément HTML <a>.

Description

La méthode link permet de créer un fragment HTML avec un lien hypertexte. Le chaîne renvoyée par la méthode peut ensuite être ajoutée au document grâce aux méthodes document.write() ou element.innerHTML.

Les liens créés avec la méthode link deviennent des éléments du tableau links, membre de l'objet document. Voir document.links.

Exemples

L'exemple qui suit affiche le texte "MDN" avec un hyperlien qui envoie l'utilisateur vers le site du Mozilla Developer Network.

js
var texteAffiché = "MDN";
var URL = "https://developer.mozilla.org/";

console.log("Cliquer ici pour revenir sur " + texteAffiché.link(URL));
// Cliquer ici pour revenir sur <a href="https://developer.mozilla.org/">MDN</a>

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-string.prototype.link

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
link
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Deprecated. Not for use in new websites.

Voir aussi