blob: 6d235268f4078d94a161d36a1089afe810d342dd (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
---
title: String.prototype.anchor()
slug: Web/JavaScript/Reference/Global_Objects/String/anchor
tags:
- JavaScript
- Méthode
- Prototype
- Reference
- String
- polyfill
translation_of: Web/JavaScript/Reference/Global_Objects/String/anchor
original_slug: Web/JavaScript/Reference/Objets_globaux/String/anchor
---
{{JSRef}}
La méthode **`anchor()`** permet de créer une ancre HTML {{HTMLElement("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 {{HTMLElement("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 {{HTMLElement("a")}}.
Les ancres créées avec la méthode `anchor` deviennent des éléments accessibles à travers le tableau {{domxref("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 | État | Commentaires |
| -------------------------------------------------------------------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| {{SpecName('ES6', '#sec-string.prototype.anchor', 'String.prototype.anchor')}} | {{Spec2('ES6')}} | 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
{{Compat("javascript.builtins.String.anchor")}}
## Voir aussi
- {{jsxref("String.prototype.link()")}}
|
