<meter>:HTML Meter 元素

<meter> HTML 元素表示已知範圍內的標量值或分數。

試一試

屬性

此元素包含 全域性屬性

value

當前數值。如果指定了最小值和最大值(min 屬性和 max 屬性),則此值必須介於最小值和最大值之間。如果未指定或格式錯誤,則值為 0。如果指定了,但不在 min 屬性和 max 屬性給定的範圍內,則該值等於該範圍的最近端點。

注意:除非 value 屬性在 01(含)之間,否則 minmax 屬性應定義範圍,以便 value 屬性的值在該範圍內。

min

測量範圍的下限數值。如果指定了,則此值必須小於最大值(max 屬性)。如果未指定,則最小值為 0

max

測量範圍的上限數值。如果指定了,則此值必須大於最小值(min 屬性)。如果未指定,則最大值為 1

low

測量範圍低端的上限數值。此值必須大於最小值(min 屬性),並且還必須小於高值和最大值(分別為 high 屬性和 max 屬性),如果指定了任何值。如果未指定,或小於最小值,則 low 值等於最小值。

high

測量範圍高階的較低數值邊界。此值必須小於最大值(max 屬性),並且如果指定了低值和最小值(分別為low 屬性和min 屬性),則還必須大於低值和最小值。如果未指定,或如果大於最大值,則high 值等於最大值。

最佳

此屬性指示最佳數值。它必須在範圍內(由min 屬性和max 屬性定義)。當與low 屬性和high 屬性一起使用時,它指示在範圍內哪個位置被認為是首選。例如,如果它在min 屬性和low 屬性之間,則認為較低範圍是首選。瀏覽器可能會根據值是否小於或等於最佳值來以不同的顏色顯示儀表的條形。

表單

此可選屬性用於為<meter> 元素顯式設定一個<form> 所有者。如果省略,則<meter> 與其祖先<form> 元素相關聯,或者與另一個祖先元素(例如<fieldset>)的form 屬性設定的表單關聯相關聯(如果有)。如果包含,則該值必須是同一樹中<form>id

示例

簡單示例

HTML

html
<p>Battery level: <meter min="0" max="100" value="75">75%</meter></p>

結果

高低範圍示例

請注意,在此示例中省略了min 屬性。這是允許的,因為它將預設為0

HTML

html
<p>
  Student's exam score:
  <meter min="0" low="50" high="80" max="100" value="84">84%</meter>
</p>

結果

技術摘要

內容類別 流內容短語內容、可標記內容、可感知內容。
允許的內容 短語內容,但其後代中不能有<meter> 元素。
標籤省略 無,開始和結束標籤都是必須的。
允許的父元素 任何接受短語內容的元素。
隱式 ARIA 角色 meter
允許的 ARIA 角色 不允許使用role
DOM 介面 HTMLMeterElement

規範

規範
HTML 標準
# the-meter-element

瀏覽器相容性

BCD 表格僅在瀏覽器中載入

另請參閱