HTMLTableCellElement : propriété headers

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété headers de l'interface HTMLTableCellElement contient une liste d'identifiants des éléments <th> qui sont des entêtes pour cette cellule spécifique.

Dans cet article

Valeur

Une chaîne de caractères contenant des identifiants séparés par des espaces.

Exemples

Cet exemple liste l'identifiant de la dernière cellule cliquée du tableau :

HTML

html
<table>
  <thead>
    <tr>
      <th rowspan="2" id="h">Devoirs (ID = h)</th>
      <th colspan="3" id="e">Examens (ID = e)</th>
      <th colspan="3" id="p">Projets (ID = p)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th id="e1" headers="e">1 (ID = e1)</th>
      <th id="e2" headers="e">2 (ID = e2)</th>
      <th id="ef" headers="e">Final (ID = ef)</th>
      <th id="p1" headers="p">1 (ID = p1)</th>
      <th id="p2" headers="p">2 (ID = p2)</th>
      <th id="pf" headers="p">Final (ID = pf)</th>
    </tr>
    <tr>
      <td headers="h">15%</td>
      <td headers="e e1">15%</td>
      <td headers="e e2">15%</td>
      <td headers="e ef">20%</td>
      <td headers="p p1">10%</td>
      <td headers="p p2">10%</td>
      <td headers="p pf">15%</td>
    </tr>
  </tbody>
</table>
Identifiants des entêtes de la dernière cellule cliquée&nbsp;:
<output>aucun</output>.

table {
  border-collapse: collapse;
}

th,
td,
table {
  border: 1px solid black;
}

button {
  margin: 1em 1em 1em 0;
}

JavaScript

js
const table = document.querySelector("table");
const output = document.querySelector("output");

table.addEventListener("click", (ev) => {
  output.textContent = ev.target.headers ? ev.target.headers : "none";
});

Résultat

Spécifications

Spécification

HTML
# dom-tdth-headers

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 19 janv. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

API HTML DOM
HTMLTableCellElement
Propriétés d'instance
1. abbr
2. align
3. bgColor
4. cellIndex
5. ch
6. chOff
7. colSpan
8. headers
9. noWrap
10. rowSpan
11. scope
12. vAlign
Héritage
Pages liées à HTML DOM
Guides
1. Utiliser les microtâches en JavaScript avec queueMicrotask()
2. Aller plus loin : Les microtâches et l'environnement d'exécution JavaScript