<samp>: Das Sample-Output-Element

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das <samp> HTML-Element wird verwendet, um Inline-Text einzuschließen, der eine Ausgabe (oder ein Zitat) eines Computerprogramms darstellt. Der Inhalt wird typischerweise mit der Standardschriftart des Browsers für Monospace-Schriftarten gerendert (wie Courier oder Lucida Console).

Probieren Sie es aus

<p>I was trying to boot my computer, but I got this hilarious message:</p>

<p>
  <samp>Keyboard not found <br />Press F1 to continue</samp>
</p>

samp {
  font-weight: bold;
}

Attribute

Dieses Element umfasst nur die globalen Attribute.

Verwendungshinweise

Sie können eine CSS-Regel verwenden, um die Standardschriftart des Browsers für das <samp>-Element zu überschreiben; es ist jedoch möglich, dass die Browsereinstellungen gegenüber den von Ihnen angegebenen CSS-Regeln Vorrang haben.

Das CSS, um die Standardschriftart zu überschreiben, sieht folgendermaßen aus:

css
samp {
  font-family: "Courier";
}

Hinweis: Wenn Sie ein Element benötigen, das als Container für die Ausgabe von JavaScript-Code Ihrer Website oder App dient, sollten Sie stattdessen das <output>-Element verwenden.

Beispiele

Grundlegendes Beispiel

In diesem grundlegenden Beispiel enthält ein Absatz ein Beispiel der Ausgabe eines Programms.

html
<p>
  When the process is complete, the utility will output the text
  <samp>Scan complete. Found <em>N</em> results.</samp> You can then proceed to
  the next step.
</p>

Ergebnis

Beispielausgabe einschließlich Benutzereingabe

Sie können das <kbd>-Element innerhalb eines <samp>-Blocks verschachteln, um ein Beispiel zu präsentieren, das vom Benutzer eingegebenen Text enthält. Zum Beispiel, betrachten Sie diesen Text, der ein Transkript einer Linux- (oder macOS-) Konsolensitzung präsentiert:

HTML

html
<pre>
<samp><span class="prompt">mike@interwebz:~$</span> <kbd>md5 -s "Hello world"</kbd>
MD5 ("Hello world") = 3e25960a79dbc69b674cd4ec67a72c62

<span class="prompt">mike@interwebz:~$</span> <span class="cursor">█</span></samp></pre>

Beachten Sie die Verwendung von <span>, um das Aussehen spezifischer Teile des Beispieltexts wie die Shell-Prompts und den Cursor anzupassen. Beachten Sie auch die Verwendung von <kbd>, um den Befehl darzustellen, den der Benutzer bei der Aufforderung im Beispieltext eingegeben hat.

CSS

Das CSS, das das gewünschte Erscheinungsbild erzeugt, ist:

css
.prompt {
  color: #b00;
}

samp > kbd {
  font-weight: bold;
}

.cursor {
  color: #00b;
}

Dies verleiht den Eingabeaufforderungen und dem Cursor eine eher dezente Farbgebung und hebt die Tastatureingabe innerhalb des Beispieltextes hervor.

Ergebnis

Die resultierende Ausgabe ist diese:

Technische Zusammenfassung

Inhaltskategorien Flussinhalt, Phraseninhalt, fühlbarer Inhalt.
Erlaubter Inhalt Phraseninhalt.
Tag-Auslassung Keine, sowohl das Start- als auch das End-Tag sind obligatorisch.
Erlaubte Eltern Jedes Element, das Phraseninhalt akzeptiert.
Implizierte ARIA-Rolle generic
Erlaubte ARIA-Rollen Beliebig
DOM-Schnittstelle [`HTMLElement`](/de/docs/Web/API/HTMLElement)

Spezifikationen

Specification
HTML
# the-samp-element

Browser-Kompatibilität

Siehe auch