Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

String.prototype.anchor()

La méthode anchor() permet de créer une ancre HTML <a> qui est utilisé comme cible hypertexte.

Syntaxe

js
str.anchor(name);

Paramètres

name

Une chaîne de caractères représentant l'attribut name de la balise à créér.

Valeur de retour

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

Description

On utilise la méthode anchor() pour créer et afficher des ancres dans un document HTML à l'aide de JavaScript.

Ici la chaîne représente le texte que verra l'utilisateur. Le paramètre name représente l'attribut name de l'élément <a>.

Les ancres créées avec la méthode anchor deviennent des éléments accessibles à travers le tableau document.anchors.

Exemples

js
var maChaîne = "Table des matières";

document.body.innerHTML = maChaîne.anchor("ancre_contenu");

produira le code HTML suivant :

html
<a name="ancre_contenu">Table des matières</a>

Prothèse d'émulation (polyfill)

js
if (!String.prototype.anchor) {
  String.prototype.anchor = function (x) {
    return '<a name="' + x + '">' + this + "</a>";
  };
}

Spécifications

Specification
ECMAScript® 2026 Language Specification
# sec-string.prototype.anchor

Compatibilité des navigateurs

Voir aussi