String.prototype.anchor()

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

Syntaxe

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

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

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

produira le code HTML suivant :

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

Prothèse d'émulation (polyfill)

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

Spécifications

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'String.prototype.anchor' dans cette spécification.
Standard Définition initiale. Implémentée avec JavaScript 1.0. Défini dans l'annexe (normative) B sur les fonctionnalités additionnelles des navigateurs web.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
anchor
Obsolète
Chrome Support complet OuiEdge Support complet 12Firefox Support complet 1
Notes
Support complet 1
Notes
Notes Starting with version 17, the quotation mark (") is replaced by its HTML reference character (") in strings supplied for the name parameter.
IE Aucun support NonOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Voir aussi