String : méthode anchor()

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.

Voir la compatibilité complète
En savoir plus

La méthode anchor() de 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> avec un attribut name (<a name="...">str</a>).

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().

La spécification HTML n'autorise plus l'élément HTML <a> à avoir un attribut name, donc cette méthode ne crée même pas un balisage valide.

Syntaxe

anchor(name)

Paramètres

name: Une chaîne de caractères représentant une valeur name à mettre dans la balise de début générée <a name="...">.

Valeur de retour

Une chaîne de caractères commençant par une balise de début <a name="name"> (les guillemets doubles dans name sont remplacés par "), suivie du texte str, puis d'une balise de fin </a>.

Exemples

Utiliser la méthode `anchor()`

Le code ci-dessous crée une chaîne de caractères HTML puis remplace le corps du document avec celle-ci :

const contenuChaineCaracteres = "Bonjour, le monde";

document.body.innerHTML = contenuChaineCaracteres.anchor("bonjour");

Cela produit le code HTML suivant :

html

<a name="bonjour">Bonjour, le monde</a>

Attention : Ce balisage est invalide, car name n'est plus un attribut valide de l'élément HTML <a>.

Au lieu d'utiliser anchor() et de créer directement du texte HTML, vous devez utiliser les API DOM telles que document.createElement(). Par exemple :

const contenuChaineCaracteres = "Bonjour, le monde";
const elem = document.createElement("a");
elem.innerText = contenuChaineCaracteres;
document.body.appendChild(elem);