<samp>
Un résultat type d’un programme : un message, une réponse de la console ou le texte d’une erreur.
- Affichage
- inline
- Balise fermante
- Obligatoire
- Contenu autorisé
- Contenu phrasant
Exemple
#<p>
Si vous oubliez de fermer une parenthèse, la console affichera l’erreur
<samp>SyntaxError: missing ) after argument list</samp>.
</p>Définition et utilisation
#L’élément <samp> marque un texte généré par un programme ou un système : un message d’erreur, le résultat d’une commande dans un terminal, la réponse d’un serveur ou un texte affiché par une application. Les navigateurs l’affichent dans une police à largeur fixe.
La répartition des rôles est facile à retenir : <code> marque le code que quelqu’un a écrit, <kbd> les données saisies par l’utilisateur, et <samp> la réponse de l’ordinateur. Grâce à cela, même dans un long tutoriel, on voit qui « parle » à chaque instant.
Placez un résultat de plusieurs lignes dans <pre><samp>…</samp></pre>. Si, dans la transcription d’une session de terminal, vous voulez montrer une commande saisie par l’utilisateur, imbriquez un élément <kbd> dans <samp>.
Syntaxe
#<samp>message du programme</samp>Attributs
#Cet élément n’a pas d’attributs propres. Il accepte les attributs globaux, comme class, id ou hidden.
Plus d’exemples
#<pre><samp>$ <kbd>node --version</kbd>
v22.11.0</samp></pre>CSS par défaut
#La plupart des navigateurs affichent cet élément avec ces styles par défaut :
samp {
font-family: monospace;
}Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Recopiez les messages d’erreur exactement, caractère par caractère. Le lecteur pourrait vouloir les copier dans un moteur de recherche.
- Dans la transcription d’une session de terminal, marquez les commandes avec
<kbd>, et les réponses avec<samp>. - Placez les résultats longs dans
<pre>, pour conserver la mise en page des colonnes et des indentations.
Entrées associées
#- <kbd>Une saisie effectuée par l’utilisateur : des touches, des raccourcis clavier et des commandes à saisir.
- <code>Un fragment de code informatique : le nom d’une variable, d’une fonction, d’une balise ou d’un fichier, ainsi qu’un court extrait.
- <pre>Un texte préformaté : il conserve les espaces, les tabulations et les retours à la ligne exactement comme dans le code.
- <var>Une variable dans une formule mathématique ou dans un programme, ainsi qu’un symbole substituable dans une commande.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.