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

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 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

Spécification
ECMAScript® 2027 Language Specification
# sec-string.prototype.anchor

Compatibilité des navigateurs

Voir aussi