<samp>: The 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.

Phần tử <samp> trong HTML được dùng để bao quanh văn bản nội tuyến đại diện cho đầu ra mẫu (hoặc trích dẫn) từ một chương trình máy tính. Nội dung của nó thường được hiển thị bằng phông chữ monospace mặc định của trình duyệt (chẳng hạn như Courier hoặc Lucida Console).

Try it

<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;
}

Thuộc tính

Phần tử này chỉ bao gồm các thuộc tính toàn cục.

Ghi chú sử dụng

Bạn có thể dùng quy tắc CSS để ghi đè phông chữ mặc định của trình duyệt cho phần tử <samp>; tuy nhiên, tùy chọn của trình duyệt có thể được ưu tiên hơn bất kỳ CSS nào bạn chỉ định.

CSS để ghi đè phông chữ mặc định sẽ trông như thế này:

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

Note: Nếu bạn cần một phần tử sẽ đóng vai trò là vùng chứa cho đầu ra được tạo bởi mã JavaScript của trang web hoặc ứng dụng, bạn nên dùng phần tử <output> thay thế.

Ví dụ

Ví dụ cơ bản

Trong ví dụ cơ bản này, một đoạn văn bao gồm ví dụ về đầu ra của một chương trình.

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>

Kết quả

Đầu ra mẫu bao gồm đầu vào của người dùng

Bạn có thể lồng phần tử <kbd> trong một khối <samp> để trình bày ví dụ bao gồm văn bản được nhập bởi người dùng. Ví dụ, hãy xem đoạn văn bản trình bày bản ghi phiên làm việc trên console Linux (hoặc macOS):

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>

Lưu ý việc sử dụng <span> để cho phép tùy chỉnh giao diện của các phần cụ thể trong văn bản mẫu như các dấu nhắc shell và con trỏ. Cũng lưu ý việc sử dụng <kbd> để đại diện cho lệnh người dùng nhập tại dấu nhắc trong văn bản mẫu.

CSS

CSS để đạt được giao diện mong muốn là:

css
.prompt {
  color: #bb0000;
}

samp > kbd {
  font-weight: bold;
}

.cursor {
  color: #0000bb;
}

Đây là cách tô màu khá tinh tế cho dấu nhắc và con trỏ, và in đậm đầu vào bàn phím trong văn bản mẫu.

Kết quả

Đầu ra kết quả là:

Tóm tắt kỹ thuật

Danh mục nội dung Nội dung luồng, nội dung cụm từ, nội dung rõ ràng.
Nội dung được phép Nội dung cụm từ.
Bỏ thẻ Không được phép, cả thẻ mở và thẻ đóng đều bắt buộc.
Phần tử cha được phép Bất kỳ phần tử nào chấp nhận nội dung cụm từ.
Vai trò ARIA ngầm định generic
Vai trò ARIA được phép Bất kỳ
Giao diện DOM HTMLElement

Đặc tả

Specification
HTML
# the-samp-element

Tương thích trình duyệt

Xem thêm

  • Các phần tử liên quan: <kbd>, <code>, <pre>
  • Phần tử <output>: vùng chứa cho đầu ra được tạo bởi script