<meter>: Phần tử Đồng hồ đo HTML
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Phần tử <meter> trong HTML biểu diễn một giá trị vô hướng trong một phạm vi đã biết hoặc một giá trị phân số.
Try it
<label for="fuel">Fuel level:</label>
<meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="50">
at 50/100
</meter>
label {
padding-right: 10px;
font-size: 1rem;
}
Thuộc tính
Phần tử này bao gồm các thuộc tính toàn cục.
value-
Giá trị số hiện tại. Giá trị này phải nằm trong khoảng giá trị nhỏ nhất và lớn nhất (thuộc tính
minvà thuộc tínhmax) nếu chúng được chỉ định. Nếu không được chỉ định hoặc không hợp lệ, giá trị mặc định là0. Nếu được chỉ định nhưng không nằm trong khoảng do thuộc tínhminvà thuộc tínhmaxxác định, giá trị sẽ bằng đầu gần nhất của khoảng đó.Note: Trừ khi thuộc tính
valuenằm trong khoảng từ0đến1(bao gồm cả hai đầu), thuộc tínhminvàmaxnên xác định phạm vi sao cho giá trị của thuộc tínhvaluenằm trong đó. min-
Giới hạn số thấp hơn của phạm vi được đo. Giá trị này phải nhỏ hơn giá trị lớn nhất (thuộc tính
max), nếu được chỉ định. Nếu không được chỉ định, giá trị nhỏ nhất là0. max-
Giới hạn số cao hơn của phạm vi được đo. Giá trị này phải lớn hơn giá trị nhỏ nhất (thuộc tính
min), nếu được chỉ định. Nếu không được chỉ định, giá trị lớn nhất là1. low-
Giới hạn số cao hơn của đầu thấp của phạm vi được đo. Giá trị này phải lớn hơn giá trị nhỏ nhất (thuộc tính
min), và cũng phải nhỏ hơn giá trị high và giá trị lớn nhất (thuộc tínhhighvà thuộc tínhmaxtương ứng), nếu có. Nếu không được chỉ định, hoặc nhỏ hơn giá trị nhỏ nhất, giá trịlowsẽ bằng giá trị nhỏ nhất. high-
Giới hạn số thấp hơn của đầu cao của phạm vi được đo. Giá trị này phải nhỏ hơn giá trị lớn nhất (thuộc tính
max), và cũng phải lớn hơn giá trị low và giá trị nhỏ nhất (thuộc tínhlowvà thuộc tínhmintương ứng), nếu có. Nếu không được chỉ định, hoặc lớn hơn giá trị lớn nhất, giá trịhighsẽ bằng giá trị lớn nhất. optimum-
Thuộc tính này chỉ ra giá trị số tối ưu. Nó phải nằm trong phạm vi (được xác định bởi thuộc tính
minvà thuộc tínhmax). Khi dùng với thuộc tínhlowvà thuộc tínhhigh, nó cho biết vị trí nào trong phạm vi được coi là ưa thích. Ví dụ, nếu nó nằm giữa thuộc tínhminvà thuộc tínhlow, thì phạm vi thấp hơn được coi là ưa thích. Trình duyệt có thể tô màu thanh đồng hồ đo khác nhau tùy thuộc vào giá trị có nhỏ hơn hoặc bằng giá trị tối ưu hay không.
Ví dụ
>Ví dụ cơ bản
HTML
<p>Battery level: <meter min="0" max="100" value="75">75%</meter></p>
Kết quả
Ví dụ phạm vi cao và thấp
Lưu ý rằng trong ví dụ này thuộc tính min bị bỏ qua. Điều này được phép, vì nó sẽ mặc định là 0.
HTML
<p>
Student's exam score:
<meter low="50" high="80" max="100" value="84">84%</meter>
</p>
Kết quả
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 có thể gán nhãn, nội dung rõ ràng. |
|---|---|
| Nội dung được phép |
Nội dung cụm từ, nhưng không được có phần tử <meter> nào trong số các phần tử con.
|
| Bỏ qua thẻ | Không được bỏ qua, 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 |
meter
|
| Vai trò ARIA được phép | Không có role nào được phép |
| Giao diện DOM | HTMLMeterElement |
Đặc tả
| Specification |
|---|
| HTML> # the-meter-element> |