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

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.

Exemple

Utiliser la méthode link()

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

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

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'String.prototype.link' dans cette spécification.
Standard Définition initiale. Implémentée avec JavaScript 1.0. Définie dans l'Annexe B (normative) pour les fonctionnalités ECMAScript additionnelles concernant les navigateurs web.
ECMAScript 2017 Draft (ECMA-262)
La définition de 'String.prototype.link' dans cette spécification.
Projet Définie dans l'Annexe B (normative) pour les fonctionnalités ECMAScript additionnelles concernant les navigateurs web.

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) 1.0 (1.7 ou moins) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) 1.0 (1.0) (Oui) (Oui) (Oui)

Notes relatives à Gecko

  • À partir de Gecko 17.0 (Firefox 17 / Thunderbird 17 / SeaMonkey 2.14) le symbole de double quote " est automatiquement remplacé par l'entité HTML de référence dans le paramètre url.

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,