aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/htmlinputelement/labels/index.md
blob: f2540f72cd0a12d976667bbd0d2709cc57ccce4e (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
---
title: HTMLInputElement.labels
slug: Web/API/HTMLInputElement/labels
tags:
  - API
  - DOM
  - Propriété
  - Étiquettes
translation_of: Web/API/HTMLInputElement/labels
---
{{APIRef("DOM")}}

La propriété en lecture seule **`HTMLInputElement.labels`** renvoie une {{domxref("NodeList")}} (_liste de noeuds_) des éléments {{HTMLElement("label")}} (_étiquette_) associés avec l'élément {{HTMLElement("input")}} (_entrée_).

## Syntaxe

    var labelElements = input.labels;

### Valeur retournée

Une {{domxref("NodeList")}} contenant les éléments `<label>` associés avec l'élément `<input>`.

## Exemple

### HTML

```html
<label id="label1" for="test">Label 1</label>
<input id="test"/>
<label id="label2" for="test">Label 2</label>
```

### JavaScript

```js
window.addEventListener("DOMContentLoaded", function() {
  const input = document.getElementById("test");
  for(var i = 0; i < input.labels.length; i++) {
    console.log(input.labels[i].textContent); // "Label 1" et "Label 2"
  }
});
```

{{EmbedLiveSample("Exemple", "100%", 30)}}

## Spécifications

| Spécification                                                                            | Statut                           | Commentaire          |
| ---------------------------------------------------------------------------------------- | -------------------------------- | -------------------- |
| {{SpecName("HTML WHATWG", "forms.html#dom-lfe-labels", "labels")}} | {{Spec2("HTML WHATWG")}} | Pas de changement.   |
| {{SpecName("HTML5 W3C", "forms.html#dom-lfe-labels", "labels")}}     | {{Spec2("HTML5 W3C")}}     | Définition initiale. |

## Compatibilité des navigateurs

{{Compat("api.HTMLInputElement.labels")}}