String : méthode link()
Obsolète
Évitez d'utiliser cette fonctionnalité dans de nouveaux projets. HTML wrapper methods exist only for backwards compatibility. Use DOM APIs to create elements instead. Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.
Envisagez d'utiliser plutôt les fonctionnalités suivantes : DOM.
La méthode link() des valeurs String crée une chaîne de caractères qui intègre cette chaîne de caractères dans un élément HTML <a> (<a href="...">str</a>), pour être utilisée comme lien hypertexte vers une autre URL.
Note :
Toutes les méthodes d'encapsulation HTML sont obsolètes et ne sont standardisées que pour des raisons de compatibilité. Utilisez plutôt les API DOM telles que document.createElement().
Syntaxe
link(url)
Paramètres
url-
Toute chaîne de caractères qui définit l'attribut
hrefde l'élément<a>; elle doit être une URL valide (relative ou absolue), avec tous les caractères&échappés en&.
Valeur de retour
Une chaîne de caractères commençant par une balise de début <a href="url"> (les doubles quotes dans url sont remplacées par "), suivie du texte str, puis d'une balise de fin </a>.
Exemples
Utiliser la méthode link()
Le code ci-dessous crée une chaîne de caractères HTML, puis remplace le contenu du corps du document par cette chaîne de caractères :
const contenuChaineCaracteres = "MDN Web Docs";
document.body.innerHTML = contenuChaineCaracteres.link(
"https://developer.mozilla.org/",
);
Cela crée au présent le HTML suivant :
<a href="https://developer.mozilla.org/">MDN Web Docs</a>
Au lieu d'utiliser link() et de créer directement du texte HTML, vous devez utiliser les API DOM telles que document.createElement(). Par exemple :
const contenuChaineCaracteres = "MDN Web Docs";
const elem = document.createElement("a");
elem.href = "https://developer.mozilla.org/";
elem.innerText = contenuChaineCaracteres;
document.body.appendChild(elem);
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Language Specification # sec-string.prototype.link |