aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/html/element/dir/index.html
blob: 40e8f2b9c8c3e4a5462a10ce94d7ca4d03d81ca3 (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
---
title: '<dir> : l''élément de répertoire'
slug: Web/HTML/Element/dir
tags:
  - Directory
  - Element
  - HTML
  - HTML Lists
  - Deprecated
  - Reference
  - Web
  - dir
  - lists
translation_of: Web/HTML/Element/dir
browser-compat: html.elements.dir
---
<div>{{HTMLRef}}</div>

<div class="warning">
  <p><strong>Attention :</strong> Cette fonctionnalité est obsolète. Bien qu'encore supportée par des navigateurs, son utilisation est découragée pour tout nouveau projet. Évitez de l'utiliser.</p>
</div>

<p>L'élément HTML <strong><code>&lt;dir&gt;</code></strong> (pour <em>directory</em>) est utilisé comme un conteneur pour un répertoire (c'est-à-dire un ensemble de fichiers). Des styles et icônes peuvent être appliqués par l'agent utilisateur. Cet élément obsolète ne doit pas être utilisé, il peut être remplacé par l'élément <a href="/fr/docs/Web/HTML/Element/ul"><code>&lt;ul&gt;</code></a> qui permet de représenter des listes et, entre autres, des listes de fichiers.</p>

<div class="warning">
  <p><strong>Attention :</strong> Cet élément ne doit pas être utilisé. Bien que présent dans les premières spécifications HTML, il a été déprécié dans HTML 4, et rendu obsolète avec HTML5. Il faudra privilégier l'élément <a href="/fr/docs/Web/HTML/Element/ul"><code>&lt;ul&gt;</code></a>. De plus, aucun navigateur majeur ne prend en charge cet élément.</p>
</div>

<h2 id="dom_interface">Interface DOM</h2>

<p>Cet élément implémente l'interface <a href="/fr/docs/Web/API/HTMLDirectoryElement"><code>HTMLDirectoryElement</code></a>.</p>

<h2 id="attributes">Attributs</h2>

<p>Comme pour tous les autres éléments HTML, on peut utiliser <a href="/fr/docs/Web/HTML/Global_attributes">les attributs universels</a> sur cet élément.</p>

<dl>
  <dt><code>compact</code></dt>
  <dd>Cet attribut booléen indique que la liste doit être rendue avec un affichage compact. L'interprétation de cet attribut dépend de l'agent utilisateur. Il ne fonctionne pas dans tous les navigateurs.
  <div class="warning">
    <p><strong>Attention :</strong> Cet attribut ne doit pas être utilisé, car il a été déprécié. L'élément <a href="/fr/docs/Web/HTML/Element/dir"><code>&lt;dir&gt;</code></a> doit être mis en forme en utilisant <a href="/fr/docs/Web/CSS">CSS</a>. Pour obtenir un effect visuel similaire à l'attribut <code>compact</code>, la propriété CSS <a href="/fr/docs/Web/CSS/line-height"><code>line-height</code></a> peut être utilisé avec la valeur <code>80%</code>.</p>
  </div>
  </dd>
</dl>

<h2 id="specifications">Spécifications</h2>

<p>Ne fait pas partie des spécifications actuelles.</p>

<h2 id="browser_compatibility">Compatibilité des navigateurs</h2>

<p>{{Compat}}</p>

<h2 id="see_also">Voir aussi</h2>

<ul>
  <li>Les autres éléments HTML utilisés pour les listes : <a href="/fr/docs/Web/HTML/Element/ol"><code>&lt;ol&gt;</code></a>, <a href="/fr/docs/Web/HTML/Element/ul"><code>&lt;ul&gt;</code></a>, <a href="/fr/docs/Web/HTML/Element/li"><code>&lt;li&gt;</code></a>, and <a href="/fr/docs/Web/HTML/Element/menu"><code>&lt;menu&gt;</code></a>;</li>
  <li>Les propriétés CSS qui peuvent être utilisées pour mettre en forme l'élément <code>&lt;dir&gt;</code> :
    <ul>
      <li>La propriété <a href="/fr/docs/Web/CSS/list-style"><code>list-style</code></a> est utile pour choisir l'apparence des puces.</li>
      <li><a href="/fr/docs/Web/CSS/CSS_Lists_and_Counters/Using_CSS_counters">Les compteurs CSS</a> sont utiles pour gérer des listes imbriquées complexes.</li>
      <li>La propriété <a href="/fr/docs/Web/CSS/line-height"><code>line-height</code></a> est utile pour reproduire l'attribut déprécié <a href="/fr/docs/Web/HTML/Element/dir#attr-compact"><code>compact</code></a>.</li>
      <li>La propriété <a href="/fr/docs/Web/CSS/margin"><code>margin</code></a> est utile pour contrôler l'indentation de la liste.</li>
    </ul>
  </li>
</ul>