recursal/MDN huggingface dataset:
<aside> : l'élément aparté
==========================

L'élément **`<aside>`** (en français, « aparté ») représente une partie d'un document dont le contenu n'a qu'un rapport indirect avec le contenu principal du document. Les apartés sont fréquemment présents sous la forme d'encadrés ou de boîtes de légende.

Exemple interactif
------------------

|  |  |
| --- | --- |
| Catégories de contenu | Contenu de flux,
 contenu de section,
 contenu tangible.
  |
| Contenu autorisé | Contenu de flux. |
| Omission de balises | 
 Aucune, la balise d'ouverture et la balise de fermeture sont
 obligatoires.
  |
| Parents autorisés | 
 Tout élément acceptant du
 contenu de flux. Notez qu'un élément `<aside>` ne doit pas être un
 descendant d'un élément
 `<address>`.
  |
| Rôle ARIA implicite | `complementary (en-US)` |
| Rôles ARIA autorisés | feed,
 none,
 note,
 presentation,
 region,
 search |
| Interface DOM | `HTMLElement` |

Attributs
---------

Cet élément ne comprend que les attributs universels.

Notes d'utilisation
-------------------

On ne doit pas utiliser l'élément `<aside>` pour marquer du texte entre parenthèses, ce type de texte est considéré comme faisant partie du flux principal.

Exemples
--------

Dans cet exemple, on utilise `<aside>` afin de baliser un paragraphe d'un article. Ici, le paragraphe n'est pas directement lié au contenu principal de l'article et c'est pour cela qu'on utilise cet élément.


```html
<article>
  <p>
    Le film Disney <cite>La petite Sirène</cite> est sorti en salles en 1989.
  </p>
  <aside>
    <p>Le film a gagné 87 millions de dollars pendant sa sortie initiale.</p>
  </aside>
  <p>Plus d'informations sur le film…</p>
</article>
```

### Résultat

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # the-aside-element |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Les autres éléments en rapport avec les sections : `<body>`, `<article>`, `<section>`, `<nav>`, `<h1>`, `<h2>`, `<h3>`, `<h4>`, `<h5>`, `<h6>`, `<hgroup>`, `<header>`, `<footer>`, `<address>`
* Structures et sections d'un document HTML5
* ARIA : le rôle `complementary` (en-US)
<i>
===

L'élément HTML **`<i>`** représente un morceau de texte qui se différencie du texte principal. Cela peut par exemple être le cas pour des termes techniques, des phrases dans une langue étrangère ou encore l'expression des pensées d'un personnage. Le contenu de cet élément est généralement affiché en italique.

Exemple interactif
------------------

Attributs
---------

Cet élément possède uniquement les attributs universels.

Exemples
--------

### HTML


```html
<p>
  La phrase latine
  <i class="latin"> Veni, vidi, vici </i>
  est souvent employée en littérature.
</p>
```

### Résultat

Notes
-----

Dans certaines versions antérieures de HTML, la balise `<i>` ne jouait qu'un rôle de mise en forme, utilisé pour afficher le texte en italique (de la même façon que la balise <b> était utilisée pour afficher le texte en gras). Désormais, ces balises ont un rôle strictement sémantique et l'élément <i> représente une portion de texte dont la sémantique est différente, la représentation choisie pour cela par le navigateur étant la plupart du temps une mise en italique. Cela signifie que le navigateur affiche généralement le contenu en italique comme c'était le cas auparavant mais que ce traitement de mise en forme n'est plus du tout obligatoire.

Cet élément ne doit être utilisé seulement si aucun autre ne permet d'exprimer la sémantique du contenu de façon plus appropriée. Ainsi :

* `<em>` doit être utilisé pour insister, mettre l'accent sur le contenu
* `<strong>` doit être utilisé pour exprimer l'importance du contenu
* `<mark>` doit être utilisé pour exprimer la pertinence du contenu
* `<cite>` doit être utilisé pour marquer le nom d'une œuvre telle qu'un livre, une pièce ou une chanson.
* `<dfn>` doit être utilisé pour souligner l'occurence d'un mot utilisée pour sa définition

C'est une bonne pratique que d'utiliser l'attribut **`class`** pour identifier les raisons qui poussent à utiliser cet élément. Cela permet par exemple de maintenir la mise en forme du document plus efficacement grâce aux feuilles de style CSS.

Résumé technique
----------------

|  |  |
| --- | --- |
| Catégories de contenu | Contenu de flux,
 contenu phrasé,
 contenu tangible.
  |
| Contenu autorisé | Contenu phrasé. |
| Omission de balises | Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires |
| Parents autorisés | 
 Tout élément acceptant du
 contenu phrasé.
  |
| Rôles ARIA autorisés | Tous les rôles sont autorisés. |
| Interface DOM | Interface DOM `HTMLElement`. |

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # the-i-element |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `<em>` qui permet d'indiquer une emphase et qui ne doit pas être confondu avec l'élément `<i>`
<acronym> : l'élément d'acronyme
================================

**Attention :** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

L'élément HTML **`<acronym>`**, pour les acronymes, permet aux auteurs de pages d'indiquer une suite de caractères composant un acronyme ou l'abréviation d'un mot.

**Note :** Cet élément n'existe plus en HTML5 et ne devrait plus être utilisé. **Les développeuses et développeurs web devraient utiliser l'élément `<abbr>` à la place**.

Attributs
---------

Cet élément n'a pas d'autres attributs que les attributs universels, communs à tous les éléments.

Interface DOM
-------------

Cet élément implémente l'interface `HTMLElement`.

**Note :** Jusqu'à Gecko 1.9.2 (inclus), Firefox implémente l'interface `HTMLSpanElement` pour cet élément.

Exemples
--------


```html
<p>
  Le <acronym title="World Wide Web" lang="en">WWW</acronym>
  n'est qu'une facette d'Internet.
</p>
```

### Résultat

Style par défaut
----------------

Bien que le but de cette balise ne soit simplement qu'un avantage pratique pour l'auteur, son style par défaut varie selon les navigateurs :

* Certains navigateurs comme Internet Explorer lui attribuent le même style qu'un élément `<span>`.
* Opera, Firefox, et quelques autres ajoutent une ligne pointillée sous le contenu de l'élément.
* Quelques navigateurs ajoutent une ligne pointillée en dessous et mettent le contenu en petites majuscules. Pour éviter ce comportement, il est possible d'ajouter `font-variant: none` à la feuille de style CSS.

Il est donc fortement recommandé que les développeurs web ne s'attendent pas à un comportement uniforme concernant ce style par défaut.

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # acronym |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* L'élément HTML `<abbr>`
<plaintext> : l'élément de texte brut (déprécié)
================================================

**Obsolète:** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

L'élément HTML **`<plaintext>`** permet d'afficher du texte qui n'est pas interprété comme du HTML. Il ne possède pas de balise de fermeture, car tout ce qui suit n'est plus considéré comme du HTML.

**Note :** Ne pas utiliser cet élément.

* Il est déprécié depuis HTML 2, et n'a jamais été implementé par tous les navigateurs d'une manière cohérente. De plus, il est obsolète depuis HTML5, et pourra être rendu par les agents-utilisateurs qui l'acceptent comme un élément `<pre>`, qui interprètera le HTML contenu même si ce n'est pas ce qui est souhaité !
* Si l'élément `<plaintext>` est le premier élément de la page (sauf éléments non affichés), n'utilisez pas de HTML. Configurez votre serveur pour servir la page avec le type MIME (en-US) `text/plain`.
* Utilisez plutôt l'élément `<pre>` ou, si c'est sémantiquement approprié, l'élément `<code>`. Échappez éventuellement '`<`', '`>`' et `&` pour que le contenu ne soit pas interprété par inadvertance.
* Une police à chasse fixe peut aussi être obtenue par un simple élément `<div>`, et en appliquant la police générique `monospace` comme valeur pour la propriété CSS `font-family`.

Attributs
---------

Cet élément n'a aucun autre attribut en dehors des attributs universels, communs à tous les éléments.

Interface DOM
-------------

Cet élément implémente l'interface `HTMLElement`.

**Note :** Jusqu'à Gecko 1.9.2 inclus, Firefox implémente l'interface `HTMLSpanElement` pour cet élément.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `<pre>` et `<code>` qui doivent être utilisés à la place
* `<listing>` et `<xmp>`, similaires mais également obsolètes
<caption> : l'élément de légende d'un tableau
=============================================

L'élément **`<caption>`** définit la légende (ou le titre) d'un tableau.

Exemple interactif
------------------

|  |  |
| --- | --- |
| Catégories de contenu | Aucune. |
| Contenu autorisé | Contenu de flux. |
| Omission de balises | 
 La balise de fin peut être absente si l'élément n'est pas immédiatement
 suivi d'un blanc ASCII ou d'un commentaire.
  |
| Parents autorisés | 
 Un élément
 `<table>`
 dont il doit être le premier descendant.
  |
| Rôle ARIA implicite | Pas de rôle correspondant |
| Rôles ARIA autorisés | Aucun. |
| Interface DOM | `HTMLTableCaptionElement` (en-US) |

Attributs
---------

On peut utiliser les attributs universels sur cet élément.

### Attributs obsolètes

**`align`** 
Obsolète

Cet attribut à valeur contrainte indique l'alignement de la légende du tableau par rapport au tableau lui-même. Il peut valoir :

`left`

La légende est affichée à gauche du tableau

`top`

La légende est affichée au-dessus du tableau

`right`

La légende est affichée à droite du tableau

`bottom`

La légende est affichée en dessous du tableau


**Note :** Ne pas utiliser cet attribut. Il a été déprécié. L'élément `<caption>` devrait être mis en forme grâce au CSS. Afin d'obtenir des effets similaires à cet attribut, on utilisera les propriétés CSS `caption-side` et `text-align`.

Notes d'utilisation
-------------------

L'élément `<caption>` devrait être le premier élément enfant de l'élément parent `<table>`.

Quand l'élément `<table>` (étant le parent de l'élément `<caption>`) n'est que l'unique descendant d'un élément `<figure>`, c'est l'élément `<figcaption>` doit être utilisé.

Utiliser la propriété `background-color` sur le tableau ne modifiera pas l'apparence de la légende. Il est également nécessaire d'ajouter une déclaration CSS avec `background-color` sur l'élément `<caption>` pour que celui-ci ait la même couleur.

Exemples
--------

Cet exemple simple présente un tableau qui comprend une légende.

### HTML


```html
<table>
  <caption>
    Légende de l'exemple
  </caption>
  <tr>
    <th>Connexion</th>
    <th>Courriel :</th>
  </tr>
  <tr>
    <td>utilisateur1</td>
    <td>utilisateur1@test.fr</td>
  </tr>
  <tr>
    <td>utilisateur2</td>
    <td>utilisateur2@test.fr</td>
  </tr>
</table>
```


```
caption {
  caption-side: top;
}
table {
  border-collapse: collapse;
  border-spacing: 0px;
}
table,
th,
td {
  border: 1px solid black;
}
```

### Résultat

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # the-caption-element |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Les propriétés CSS particulièrement utiles pour styliser l'élément `<caption>` :
    + `text-align`
    + `caption-side`.
<datalist> : l'élément de liste des données
===========================================

L'élément HTML **`<datalist>`** contient un ensemble d'éléments `<option>` qui représentent les valeurs possibles pour d'autres contrôles.

Exemple interactif
------------------

|  |  |
| --- | --- |
| Catégories de contenu | Contenu de flux,
 contenu phrasé.
  |
| Contenu autorisé | 
 Soit
 du contenu phrasé
 ou zéro ou plusieurs éléments
 `<option>`.
  |
| Omission de balises | 
 Aucune, la balise d'ouverture et la balise de fermeture sont
 obligatoires.
  |
| Parents autorisés | 
 N'importe quel élément qui accepte
 du contenu phrasé.
  |
| Rôle ARIA implicite | `listbox` |
| Rôles ARIA autorisés | Aucun. |
| Interface DOM | `HTMLDataListElement` (en-US) |

Attributs
---------

Cet élément ne possède que les attributs universels, communs à tous les éléments.

Exemples
--------

### HTML


```html
<label for="monNavigateur"
 >Veuillez choisir un navigateur parmi ceux-ci :</label
>
<input list="navigateurs" id="monNavigateur" name="monNavigateur" />
<datalist id="navigateurs">
  <option value="Chrome"></option>
  <option value="Firefox"></option>
  <option value="Internet Explorer"></option>
  <option value="Opera"></option>
  <option value="Safari"></option>
  <option value="Microsoft Edge"></option>
</datalist>
```


#### Résultat

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # the-datalist-element |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* L'élément `<input>` et plus précisément son attribut `list`.
* L'élément `<option>`.
<rtc> : l'élément de conteneur de texte Ruby
============================================

L'élément **`<rtc>`** permet d'ajouter des notations Ruby sémantiques. Il est donc « proche » des éléments liées à la représentation Ruby comme `<rb>`, `<ruby>`. Les éléments `<rb>` peuvent être annotés pour la prononciation (`<rt>`) ou pour la sémantique (`<rtc>`).

Exemple interactif
------------------

Attributs
---------

Cet élément peut utiliser les attributs universels.

Exemples
--------

### HTML


```html
<ruby>
  <rb>旧</rb> <rt>jiù</rt> <rb>金</rb> <rt>jīn</rt> <rb>山</rb> <rt>shān</rt>
  <rtc>San Francisco</rtc>
</ruby>
```


```
.info {
  padding-top: 10px;
  font-size: 36px;
}
```

### Résultat

Résumé technique
----------------

|  |  |
| --- | --- |
| Catégories de contenu | Aucune. |
| Contenu autorisé | 
 Du
 contenu phrasé
 ou des éléments `<rt>`.
  |
| Omission de balises | 
 La balise de fin peut être omise si l'élément est immédiatement suivi
 par un élément `<rb>`,
 `<rtc>` ou `<rt>` ou s'il est
 immédiatement suivi par la balise de fermeture de l'élément parent.
  |
| Parents autorisés | Un élément `<ruby>`. |
| Rôles ARIA autorisés | Tous les rôles sont autorisés. |
| Interface DOM | `HTMLElement` |

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # rtc |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `<ruby>`
* `<rp>`
* `<rb>`
* `<rt>`
* `<rtc>`
<portal> : l'élément de portail
===============================

L'élément HTML **`<portal>`** permet d'embarquer une autre page HTML à l'intérieur de la page courante afin de permettre une navigation plus souple vers de nouvelles pages.

Un élément `<portal>` est semblable à un élément `<iframe>`. Un élément `<iframe>` permet d'embarquer un contexte de navigation séparé. Toutefois, le contenu embarqué dans un élément `<portal>` est plus limité que celui embarqué dans un élément `<iframe>`. En effet, on ne peut pas interagir avec et il ne permet donc pas d'embarquer des éléments d'interface utilisateur. `<portal>` agit comme la prévisualisation du contenu de l'autre page et on peut s'en servir pour naviguer jusqu'à cette page, ce qui permet une transition douce vers le contenu embarqué.

|  |  |
| --- | --- |
| Rôle ARIA implicite | `button` |
| Interface DOM | `HTMLPortalElement` |

Attributs
---------

Cet élément utilise les attributs universels.

`referrerpolicy`

Voir la page de l'en-tête `Referrer-Policy` pour les valeurs. La valeur utilisée sera fournie lors de la requête vers la page située à l'URL fournie par l'attribut `src`.

`src`

L'URL de la page à embarquer.

Exemples
--------

### Exemple simple

L'exemple suivant embarque le contenu de `https://example.com` pour le prévisualiser.


```html
<portal id="exempleportal" src="https://example.com/"></portal>
```

Accessibilité
-------------

La prévisualisation fournie par `<portal>` n'est pas interactive et ne peut donc pas recevoir d'évènements de saisie ou le focus. Aussi, les contenus embarqués via le portail ne sont pas exposés comme des éléments de l'arbre d'accessibilité. Il est possible de naviguer vers le portail ou de l'activer comme pour un bouton. Le comportement par défaut du portail, lorsqu'on clique dessus, est de s'activer.

Par défaut, les portails reçoivent un libellé par défaut qui est le titre de la page embarquée. Si aucun titre n'est présent, le texte visible dans la prévisualisation est concaténé afin de créer un libellé. L'attribut `aria-label` (en-US) peut être utilisé afin de surcharger ce comportement.

Les portails utilisés à des seules fins de prérendu devraient être masqués avec l'attribut HTML `hidden` ou avec la propriété CSS `display` valant `none`.

Lorsqu'on utilise des animations pour l'activation du portail, la caractéristique média `prefers-reduced-motion` devrait être respectée.

Spécifications
--------------

| Specification |
| --- |
| Portals # the-portal-element |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
<big> : l'élément d'agrandissement de texte
===========================================

**Attention :** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

L'élément HTML **`<big>`** (gros) augmente d'une taille la police du texte de l'élément (il permet par exemple de passer de `small` à `medium`, ou de `large` à `x-large`) jusqu'à atteindre la taille maximale autorisée par le navigateur.

**Note :** Cet élément est purement stylistique. Il a été supprimé en HTML5 et ne doit plus être utilisé. Les développeurs web doivent utiliser les propriétés CSS pour remplacer cet élément.

Attributs
---------

Cet élément n'a aucun autre attribut en dehors des attributs universels communs à tous les éléments.

Exemples
--------

Nous voyons ici des exemples montrant l'utilisation de `<big>` suivis d'un exemple montrant comment obtenir les mêmes résultats en utilisant plutôt la syntaxe CSS moderne.

### Utilisation de <big>

Dans cet exemple, on utilise l'élément obsolète `<big>` afin d'augmenter la taille du texte.

#### HTML


```html
<p>
  C'est la première phrase.
  <big>Cette phrase entière phrase est en plus gros caractères.</big>
</p>
```


#### Résultat

### Utilisation de la propriété CSS `font-size`

Cet exemple utilise la propriété CSS `font-size` pour augmenter la taille de la police d'un niveau.

#### CSS


```css
.bigger {
  font-size: larger;
}
```


#### HTML


```html
<p>
  C'est la première phrase.
  <span class="bigger"
 >Cette phrase entière est écrite en plus grosses lettres.</span
 >
</p>
```


#### Résultat

Interface DOM
-------------

Cet élément implémente l'interface `HTMLElement`.

**Note :** Jusqu'à Gecko 1.9.2 inclus, Firefox implémentait l'interface `HTMLSpanElement` pour cet élément.

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # big |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* CSS : `font-size`, `font`
* HTML : `<small>`, `<font>`, `<style>`
* Spécification HTML 4.01 sur la mise en forme utilisant les polices
<noframes> : l'élément alternatif aux frames (obsolete)
=======================================================

**Obsolète:** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

L'élément HTML obsolète **`<noframes>`** est utilisé par les navigateurs qui ne supportent pas les éléments `<frame>`, ou qui sont configurés afin de ne pas les supporter.

`<noframes>` accepte n'importe quel élément HTML valide dans un élément `<body>`, à l'exception des éléments `<frameset>` et `<frame>`.

Cet élément pouvait être utilisé afin d'afficher un message explicatif, destiné à l'utilisateur. Idéalement, le contenu devait présenter des fonctionnalités analogues à la *frame* qui n'était pas prise en charge.

**Note :** Cet élément est aussi entièrement obsolète en HTML5, et doit être evité pour se conformer au standard.

Attributs
---------

Comme tous les autres éléments HTML, cet élément inclut les attributs universels.

Exemples
--------

### HTML


```html
<frameset cols="50%,50%">
  <frame
 src="https://developer.mozilla.org/fr/docs/Web/HTML/Element/frameset" />
  <frame src="https://developer.mozilla.org/fr/docs/Web/HTML/Element/frame" />
  <noframes>
    <p>
      Il semblerait que votre navigateur ne supporte pas les frames, ou qu'il
      est configuré pour ne pas les autoriser.
    </p>
  </noframes>
</frameset>
```

### Résultat

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # noframes |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `<frameset>`
* `<frame>`
<image>
=======

**Obsolète:** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

**Non standard:** Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

L'élément HTML **`<image>`** est un élément obsolète, remplacé depuis longtemps par l'élément standard `<img>`.

**Attention :** Si vous souhaitez afficher des images, c'est l'élément `<img>` qui doit être utilisé.

Bien que les navigateurs essaient de convertir cet élément `<img>`, cela peut avoir des résultats incertains voire inattendus.

Spécifications
--------------

#### No specification found

No specification data found for `html.elements.image`.  
Check for problems with this page or contribute a missing `spec_url` to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* L'élément `<img>` qui doit être utilisé afin d'afficher une image dans un document.
* L'élément `<picture>` qui permet de sélectionner parmi plusieurs images en fonction de requête média afin d'avoir des images *responsive*.