recursal/MDN huggingface dataset:
<bdo> : l'élément de remplacement bidirectionnelle
==================================================

L'élément HTML **`<bdo>`** (pour élément de remplacement du texte bidirectionnel) est utilisé afin d'outrepasser la direction du texte. Cela permet d'imposer une direction donnée à un texte. L'orientation du texte est inversée mais pas celle des caractères.

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

Les caractères du texte sont dessinés à partir du point de départ dans la direction donnée ; l'orientation des caractères individuels n'est pas affectée (les caractères ne sont donc pas dessinés vers l'arrière, par exemple).

|  |  |
| --- | --- |
| 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ôle ARIA implicite | Pas de rôle correspondant |
| Rôles ARIA autorisés | Tous les rôles sont autorisés. |
| Interface DOM | `HTMLElement`. Auparavant et jusqu'à Gecko 1.9.2 (Firefox 4) inclus, Firefox
 implémente l'interface
 `HTMLSpanElement`
 pour cet élément.
  |

Attributs
---------

Comme pour tous les éléments, on peut appliquer les attributs universels.

**`dir`**

La direction du texte au sein de l'élément. Cet attribut peut valoir :

* `ltr` : pour un texte allant de gauche à droite (*left-to-right*).
* `rtl` : pour un texte allant de droite à gauche (*right-to-left*).

Exemples
--------


```html
<!-- Change la direction du texte -->
<p>Ce texte se lit de gauche à droite.</p>
<p><bdo dir="rtl">Ce texte se lit de droite à gauche.</bdo></p>
```

### Résultat

Notes
-----

La spécification HTML 4 ne définissait pas d'évènement pour cet élément. Ils ont été ajoutés en XHTML. Ceci était probablement un oubli de la spécification HTML 4.

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

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

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

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

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

* Élément HTML associé : `<bdi>`
<frameset> : l'élément contenant des frames
===========================================

**Attention :** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la prendre en charge, 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 **`<frameset>`** est utilisé pour contenir les éléments `<frame>`.

**Note :** L'utilisation de cadres étant désormais déconseillée au profit de l'utilisation de `<iframe>`, cet élément n'est généralement pas utilisé par les sites web modernes.

Attributs
---------

Comme tous les autres éléments HTML, cet élément prend en charge les attributs universels.

`cols`

Cet attribut définit le nombre et la taille des espaces horizontaux dans un `<frameset>`.

`rows`

Cet attribut définit le nombre et la taille des espaces verticaux dans un `<frameset>`.

Exemple
-------


```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" />
</frameset>
```

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

| Specification |
| --- |
| HTML Standard # frameset |

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

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

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

* L'élément `<frame>`
* L'élément `<iframe>`
<sup> : l'élément de mise en exposant
=====================================

L'élément HTML **`<sup>`** est utilisé, pour des raisons typographiques, afin d'afficher du texte en exposant (plus haut et généralement plus petit) par rapport au bloc de texte environnant.

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

Attributs
---------

Cet élément inclut uniquement les attributs universels.

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

Cet élément devrait uniquement être utilisé pour des raisons typographiques lorsque la position du texte est liée à la signification de ce texte (par exemple pour une formule mathématiques) ou aux règles typographiques (par exemple en français pour Mlle, Mme ou Cie).

Ainsi, on n'utilisera pas `<sup>` afin d'obtenir un effet visuel d'un logo par exemple. Pour un simple effet de mise en forme (hors typographie), on utilisera plutôt la propriété `vertical-align`, utilisée avec la valeur `super` (voire avec une valeur numérique si on souhaite être plus précis).

Voici quelques cas d'utilisation (non exhaustifs) pour `<sup>` :

* L'utilisation d'exposants dans une formule mathématique : x
 2
 .
    + Dans le cadre de formules complexes, MathML peut s'avérer plus pertinent que l'enchaînement d'éléments `<sub>` et `<sup>`.
* L'affichage de lettres supérieures pour respecter certaines conventions typographiques (ex. M
 lle
 ).
* La représentation de nombres ordinaux : 7
 e
 art.
Exemples
--------

### Puissance mathématique

#### HTML


```html
<p>Voici la fonction exponentielle : e<sup>x</sup>.</p>
```


#### Résultat

### Lettres supérieures

Bien que, techniquement, le lettrage supérieur ne corresponde pas à la mise en exposant, on voit souvent `<sup>` utilisé pour certaines abréviations.

#### HTML


```html
<p>Robert a présenté son rapport à M<sup>lle</sup> Bernard.</p>
```


#### Résultat

### Nombres ordinaux

#### HTML


```html
<p>
  Voici comment le nombre ordinal cinquième est écrit dans différentes langues
</p>
<ul>
  <li>en français : 5<sup>e</sup></li>
  <li>en anglais : 5<sup>th</sup></li>
</ul>
```


#### Résultat

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

|  |  |
| --- | --- |
| Catégories de contenu | Contenu de flux,
 contenu phrasé.
  |
| 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 | `HTMLElement` |

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

| Specification |
| --- |
| HTML Standard # the-sub-and-sup-elements |

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

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

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

* L'élément HTML `<sub>` permet un effet de mise en indice. Il est à noter que l'élément `<sub>` et l'élément `<sup>` ne peuvent pas être utilisés simultanément. Pour afficher le symbole chimique d'un élément, il faudra utiliser MathML pour représenter à la fois le numéro atomique et le nombre de masse.
* Les éléments MathML `<msub>`, `<msup> (en-US)` et `<msubsup> (en-US)`.
* La propriété CSS `vertical-align`.
<span>
======

L'élément HTML **`<span>`** est un conteneur générique en ligne (*inline*) pour les contenus phrasés. Il ne représente rien de particulier. Il peut être utilisé pour grouper des éléments afin de les mettre en forme (grâce aux attributs `class` ou `id` et aux règles CSS) ou parce qu'ils partagent certaines valeurs d'attribut comme `lang`. Il doit uniquement être utilisé lorsqu'aucun autre élément sémantique n'est approprié. `<span>` est très proche de l'élément `<div>`, mais l'élément `<div>` est un élément de bloc, alors que `<span>` est un élément en ligne.

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

Attributs
---------

Cet élément inclut uniquement les attributs universels.

Exemples
--------

### HTML


```html
<p><span>Un peu de texte</span></p>
```

### CSS


```css
p span {
  background: green;
}
```

### Résultat

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

|  |  |
| --- | --- |
| Catégories de contenu | Contenu de flux,
 contenu phrasé.
  |
| 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é, ou tout élément acceptant du
 contenu de flux.
  |
| Rôles ARIA autorisés | Any |
| Interface DOM | `HTMLSpanElement` (avant HTML 5, l'interface
 était `HTMLElement`)
  |

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

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

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

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

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

* `<div>`
<font> : l'élément de police
============================

**Attention :** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la prendre en charge, 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 **`<font>`** définit la taille, la couleur et la police de son contenu.

**Attention :** Ne pas utiliser cet élément ! Bien qu'il ait été normalisé en HTML 3.2, il a été déprécié en HTML 4.01, en même temps que tous les éléments liés uniquement au style, puis rendu obsolète en HTML5.

À partir de HTML 4, HTML ne véhicule plus d'informations de style (en dehors de l'élément `<style>` ou de l'attribut **style** de chaque élément). Pour tout nouveau développement web, le style doit être écrit en utilisant le CSS uniquement.

L'ancien comportement de l'élément `<font>` peut être obtenu, et encore mieux contrôlé, en utilisant les propriétés CSS relatives aux polices de caractères.

Attributs
---------

Comme tous les autres éléments HTML, cet élément prend en charge les attributs universels.

`color`

Cet attribut définit la couleur du texte en utilisant soit une couleur nommée, soit une couleur indiquée par le format hexadécimal #RRGGBB.

`face`

Cet attribut contient une liste d'une ou plusieurs polices, séparées par des virgules. Le texte est affiché avec la première police que le navigateur supporte. Si aucune des polices listées n'est installée sur le système, le navigateur prend habituellement la police proportionnelle, ou à taille fixe par défaut, du système.

`size`

Cet attribut indique la taille du texte par une valeur numérique ou relative. Les valeurs numériques vont de `1` à `7`, `1` étant la plus petite taille et `3` la taille par défaut. Il peut être défini en utilisant une valeur relative, comme `+2` ou `-3`, qui est relative par rapport à la valeur de l'attribut `size` de l'élément `<basefont>`, ou relatif à `3`, la valeur par défaut, si aucune existe.

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

Cet élément implément l'interface `HTMLFontElement` (en-US).

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

| Specification |
| --- |
| HTML Standard # font |

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

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

**Attention :** 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.

L'élément **`<center>`** est un élément de bloc qui contient des paragraphes et d'autres éléments de type bloc ou en ligne. Le contenu entier de cet élément est centré horizontalement au sein de son conteneur parent (généralement l'élément `<body>`).

Cet élément a été déprécié en HTML4 (et XHTML 1) au profit de la propriété CSS `text-align` qui peut être appliqué à l'élément `<div>` ou à un élément `<p>`. Pour centrer des blocs, on utilisera d'autres propriétés (`margin-left` et `margin-right` (ou définissez `margin` à `0 auto`).

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.

Exemple 1
---------


```html
<center>
  Ce texte sera centré.
  <p>Ainsi que ce paragraphe.</p>
</center>
```

Exemple 2 (alternative CSS)
---------------------------


```html
<div style="text-align:center">
  Ce texte sera centré.
  <p>Ainsi que ce paragraphe.</p>
</div>
```

Exemple 3 (alternative CSS)
---------------------------


```html
<p style="text-align:center">
  Cette ligne sera centrée.<br />
  Ainsi que cette ligne.
</p>
```

Notes
-----

Appliquer `text-align``: center` sur un élément `<p>` ou `<div>` centre *le contenu* de ces éléments, tout en laissant leurs dimensions générales inchangées.

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

| Specification |
| --- |
| HTML Standard # center |

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

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

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

* La propriété `text-align`
* La propriété `display`
<legend>
========

L'élément HTML **<legend>** représente une légende pour le contenu de son élément parent `<fieldset>`.

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

Attributs
---------

Cet élément contient uniquement les attributs universels.

Exemples
--------

### HTML


```html
<form action="" method="post">
  <fieldset>
    <legend>Un champ pour le choix de la radio</legend>
    <input type="radio" name="radio" id="radio" />
    <label for="radio">Cliquez ici</label>
  </fieldset>
</form>
```

### Résultat

**Note :** Voir la page sur `<form>` pour d'autres exemples qui utilisent `<legend>`.

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

|  |  |
| --- | --- |
| Catégories de contenu | Aucune. |
| Contenu autorisé | Contenu phrasé. |
| Omission de balises | Aucune, la balise ouvrante et la balise fermante doivent être présentes. |
| Parents autorisés | 
 Un élément `<fieldset>` dont le premier élément
 fils est cet élément `<legend>`.
  |
| Rôles ARIA autorisés | Aucun. |
| Interface DOM | `HTMLLegendElement` (en-US) |

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

| Specification |
| --- |
| HTML Standard # the-legend-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 relatifs aux formulaires : `<form>`, `<option>`, `<label>`, `<button>`, `<select>`, `<datalist>`, `<optgroup>`, `<fieldset>`, `<textarea>`, `<input>`, `<output>`, `<progress>` et `<meter>`.
* ARIA : le rôle `form` (en-US)
<cite> : l'élément de citation
==============================

L'élément **`<cite>`** contient le titre d'une œuvre telle qu'un livre, une chanson, un film, une sculpture… Cet élément doit inclure le titre de l'œuvre. Cette référence peut-être abrégée en accord avec les conventions d'usages pour l'ajout des métadonnées de citations.

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

|  |  |
| --- | --- |
| 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ôle ARIA implicite | Pas de rôle correspondant |
| Rôles ARIA autorisés | Tous les rôles sont autorisés. |
| Interface DOM | `HTMLElement`. Auparavant et jusqu'à Gecko 1.9.2 (Firefox 4) inclus, Firefox
 implémentait l'interface
 `HTMLSpanElement`
 pour cet élément
  |

Attributs
---------

Cet élément prend uniquement en charge les attributs universels.

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

Voici des exemples d'œuvres auxquelles on pourrait faire référence grâce à un élément `<cite>` :

* Un livre
* Un article de recherche
* Un essai
* Un poème
* Une pièce musicale
* Une chanson
* Le script d'une pièce ou d'un film
* Un film
* Une émission télévisée
* Un jeu
* Une sculpture
* Une peinture
* Une pièce de théâtre
* Un opéra
* Une comédie musicale
* Une exposition
* Les minutes d'un procès
* Un programme informatique
* Un site web
* Une page web
* Un billet de blog ou un commentaire
* Un billet ou un commentaire sur un forum
* Une déclaration écrite ou orale
* etc.

Il convient de noter que la spécification du W3C dit qu'une référence à une œuvre créative, telle qu'incluse dans un élément `<cite>`, peut inclure le nom de l'auteur de l'œuvre. Cependant, la spécification WHATWG pour `<cite>` dit le contraire : le nom d'une personne ne doit *jamais* être inclus, en toutes circonstances.

Pour inclure une référence à la source du matériel cité qui est contenu dans un élément `<blockquote>` ou `<q>`, utilisez l'attribut `cite` sur l'élément.

En général, les navigateurs donnent un style au contenu d'un élément `<cite>` en italique par défaut. Pour éviter cela, appliquez la propriété CSS `font-style` à l'élément `<cite>`.

Exemples
--------


```html
<p>Plus d'informations sont disponibles dans <cite>[ISO-0000].</cite></p>
```

### Résultat

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

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

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

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

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

* L'élément `<blockquote>`, utilisé pour des citations longues.
* L'élément `<q>`, utilisé pour des citations en incise.
<optgroup>
==========

L'élément HTML **`<optgroup>`**, utilisé dans un formulaire, permet de créer un groupe d'options parmi lesquelles on peut choisir dans un élément `<select>`.

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

**Note :** Il n'est pas possible d'imbriquer plusieurs éléments `<optgroup>` entre eux.

Attributs
---------

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

`disabled`

Si cet attribut booléen est défini et aucun élément du groupe d'options ne peut être sélectionné. Cet élément ne recevra pas les évènements de navigation (tels que les clics ou les changements de focus). Les navigateurs affichent ces éléments en les grisant.

`label`

Le nom du groupe d'options qui peut être affiché par le navigateur. Cet attribut est obligatoire.

Exemples
--------

### HTML


```html
<select>
  <optgroup label="Groupe 1">
    <option>Option 1.1</option>
  </optgroup>
  <optgroup label="Groupe 2">
    <option>Option 2.1</option>
    <option>Option 2.2</option>
  </optgroup>
  <optgroup label="Groupe 3" disabled>
    <option>Option 3.1</option>
    <option>Option 3.2</option>
    <option>Option 3.3</option>
  </optgroup>
</select>
```

### Résultat

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

|  |  |
| --- | --- |
| Catégories de contenu | Aucune. |
| Contenu autorisé | Zéro ou plusieurs éléments `<option>`. |
| Omission de balises | 
 La balise de début est obligatoire, la balise de fin est optionnelle si
 l'élément est immédiatement suivi par un autre élément <optgroup>
 ou si l'élément parent n'a pas d'autre contenu.
  |
| Parents autorisés | Un élément `<select>`. |
| Rôles ARIA autorisés | Aucun. |
| Interface DOM | `HTMLOptGroupElement` (en-US) |

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

| Specification |
| --- |
| HTML Standard # the-optgroup-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 relatifs aux formulaires : `<form>`, `<legend>`, `<label>`, `<button>`, `<select>`, `<datalist>`, `<option>`, `<fieldset>`, `<textarea>`, `<input>`, `<output>`, `<progress>` et `<meter>`.
<option>
========

L'élément HTML **`<option>`**, utilisé dans un formulaire, permet de représenter un contrôle au sein d'un élément `<select>`, `<optgroup>` ou `<datalist>`. Cet élément peut donc représenter des éléments d'un menu dans un document HTML.

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

Attributs
---------

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

`disabled`

Si cet attribut booléen est défini, l'option ne peut pas être sélectionnée. Généralement, les navigateurs affichent l'option grisée et celle-ci ne reçoit pas les évènements de navigation (liés aux clics ou au focus par exemple). Si cet attribut n'est pas défini, l'élément peut tout de même être désactivé si un de ses ancêtres est un élément `<optgroup>` désactivé.

`label`

La valeur de cet attribut correspond au texte affiché pour expliquer l'option. Si cet attribut n'est pas défini, sa valeur correspondra à celle du texte contenu dans l'élément.

`selected`

S'il est présent, cet attribut booléen indique que l'option est sélectionnée à l'état initial. Si l'élément `<option>` est un élément descendant d'un élément `<select>` dont l'attribut `multiple` n'est pas activé, seul une `<option>` de cet élément `<select>` peut être sélectionnée de cette façon.

`value`

Le contenu de cet attribut représente la valeur qu'on souhaite envoyer au formulaire lorsque l'option est sélectionnée. Si cet attribut n'est pas défini, la valeur sera le contenu texuel de l'élément `<option>`.

Exemples
--------

### HTML


```html
<select name="select">
  Elle est où la poulette ?
  <option value="value1">Avec les lapins</option>
  <option value="value2" selected>Avec les canards</option>
  <option value="value3">Pas là</option>
</select>
```

### Résultat

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

|  |  |
| --- | --- |
| Catégories de contenu | Aucune. |
| Contenu autorisé | 
 Du texte qui contient éventuellement des caractères échappés (par
 exemple `&eacute;`).
  |
| Omission de balises | 
 La balise de début est obligatoire. La balise de fin est optionnelle si
 l'élément est immédiatement suivi par un autre élément
 `<option>` ou `<optgroup>` ou si
 l'élément parent n'a plus d'autre contenu.
  |
| Parents autorisés | 
 Un élément `<select>`,
 `<optgroup>` ou
 `<datalist>`.
  |
| Rôles autorisés | Aucune |
| Interface DOM | `HTMLOptionElement` |

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

| Specification |
| --- |
| HTML Standard # the-option-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 relatifs aux formulaires : `<form>`, `<legend>`, `<label>`, `<button>`, `<select>`, `<datalist>`, `<optgroup>`, `<fieldset>`, `<textarea>`, `<input>`, `<output>`, `<progress>` et `<meter>`.
<noembed> : l'élément alternatif au contenu embarqué (obsolète)
===============================================================

**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.

**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 **`<noembed>`** est une façon obsolète et non standardisée de fournir une alternative de contenu pour les navigateurs ne supportant pas l'élément `<embed>` ou des catégories de contenu qu'un auteur aimerait utiliser.
 Cet élément a été rendu obsolète à partir de la version HTML 4.01 et a été remplacé par `<object>`. Le contenu alternatif doit être inséré entre la balise d'ouverture et celle de fermeture de `<object>`

**Note :** Bien que cet élément soit toujours supporté dans plusieurs navigateurs, il a été rendu obsolète et ne devrait pas être utilisé. Utilisez plutôt `<object>`

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

| Specification |
| --- |
| HTML Standard # noembed |

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

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