全域性屬性

全域性屬性是所有 HTML 元素共有的屬性;它們可以用於所有元素,儘管對某些元素可能沒有影響。

全域性屬性可以在所有HTML 元素上指定,即使標準中未指定。這意味著任何非標準元素都必須仍然允許這些屬性,即使使用這些元素意味著文件不再符合 HTML5 標準。例如,即使<foo>不是有效的 HTML 元素,符合 HTML5 標準的瀏覽器也會隱藏標記為<foo hidden>…</foo>的內容。

除了基本的 HTML 全域性屬性之外,還存在以下全域性屬性

  • xml:langxml:base - 這些是從 XHTML 規範繼承而來並已棄用,但出於相容性目的而保留。
  • ARIA role 屬性和用於確保可訪問性的多個 aria-* 狀態和屬性。
  • 事件處理程式屬性:onabortonautocompleteonautocompleteerroronbluroncanceloncanplayoncanplaythroughonchangeonclickoncloseoncontextmenuoncuechangeondblclickondragondragendondragenterondragleaveondragoverondragstartondropondurationchangeonemptiedonendedonerroronfocusoninputoninvalidonkeydownonkeypressonkeyuponloadonloadeddataonloadedmetadataonloadstartonmousedownonmouseenteronmouseleaveonmousemoveonmouseoutonmouseoveronmouseuponmousewheelonpauseonplayonplayingonprogressonratechangeonresetonresizeonscrollonseekedonseekingonselectonshowonsortonstalledonsubmitonsuspendontimeupdateontoggleonvolumechangeonwaiting

全域性屬性列表

accesskey

提供一個提示,用於為當前元素生成鍵盤快捷鍵。此屬性由一個空格分隔的字元列表組成。瀏覽器應使用計算機鍵盤佈局中存在的第一個字元。

anchor 非標準

將定位元素與錨元素關聯。屬性的值是您要將定位元素錨定的元素的id值。然後可以使用CSS錨點定位對元素進行定位。

autocapitalize

控制輸入文字是否自動大寫,以及如果自動大寫,則以何種方式大寫。

autofocus

指示在頁面載入時或其所屬的<dialog>顯示後應立即將焦點放在元素上。此屬性為布林值,初始值為false。

class

元素類的空格分隔列表。類允許 CSS 和 JavaScript 透過類選擇器或諸如Document.getElementsByClassName()方法之類的函式來選擇和訪問特定元素。

contenteditable

一個列舉屬性,指示使用者是否可以編輯元素。如果是,則瀏覽器會修改其視窗小部件以允許編輯。該屬性必須採用以下值之一

  • true空字串,表示必須可編輯元素;
  • false,表示該元素不能編輯。
  • plaintext-only,表示元素的原始文字可編輯,但停用富文字格式。
data-*

形成一類屬性,稱為自定義資料屬性,允許在HTML及其DOM表示之間交換專有資訊,指令碼可以使用這些資訊。所有此類自定義資料都可透過設定屬性的元素的HTMLElement介面獲得。HTMLElement.dataset屬性提供對其的訪問。

dir

一個列舉屬性,指示元素文字的方向性。它可以具有以下值

  • ltr,表示從左到右,用於從左到右書寫的語言(如英語);
  • rtl,表示從右到左,用於從右到左書寫的語言(如阿拉伯語);
  • auto,讓使用者代理決定。它在解析元素內的字元時使用一個基本演算法,直到找到具有強方向性的字元,然後將該方向性應用於整個元素。
draggable

一個列舉屬性,指示是否可以使用拖放 API拖動元素。它可以具有以下值

  • true,表示可以拖動元素
  • false,表示該元素不能被拖動。
enterkeyhint

提示在虛擬鍵盤上為 Enter 鍵顯示的操作標籤(或圖示)。

exportparts

用於從巢狀的陰影樹中傳遞地匯出陰影部分到包含的光樹中。

hidden

一個列舉屬性,指示元素尚未或不再相關。例如,它可以用來隱藏在登入過程完成之前無法使用的頁面元素。瀏覽器不會呈現此類元素。此屬性不能用於隱藏可能合法顯示的內容。

id

定義一個唯一的識別符號 (ID),該識別符號在整個文件中必須唯一。其目的是在連結(使用片段識別符號)、指令碼編寫或樣式設定(使用 CSS)時識別元素。

inert

一個布林值,使瀏覽器忽略元素的使用者輸入事件。當存在點選事件時很有用。

inputmode

向瀏覽器提供有關在編輯此元素或其內容時要使用的虛擬鍵盤配置型別的提示。主要用於<input>元素,但在contenteditable模式下可用於任何元素。

is

允許您指定標準 HTML 元素應表現得像已註冊的自定義內建元素(有關更多詳細資訊,請參閱使用自定義元素)。

注意:item*屬性是WHATWG HTML 微資料功能的一部分。

itemid

專案的唯一全域性識別符號。

itemprop

用於向專案新增屬性。每個 HTML 元素都可以指定一個itemprop屬性,其中itemprop由名稱和值對組成。

itemref

不屬於具有itemscope屬性的元素的後代的屬性可以使用itemref與該專案關聯。它提供了一個文件中其他位置具有其他屬性的元素 ID(而不是itemid)列表。

itemscope

itemscope(通常)與itemtype一起使用,以指定塊中包含的 HTML 與特定專案相關。itemscope建立專案並定義與其關聯的itemtype的範圍。itemtype是詞彙表(例如schema.org)的有效 URL,該詞彙表描述了專案及其屬性上下文。

itemtype

指定將用於在資料結構中定義itemprop(專案屬性)的詞彙表的 URL。itemscope用於設定在資料結構中的哪個位置設定由itemtype設定的詞彙表將處於活動狀態。

lang

幫助定義元素的語言:不可編輯元素的語言,或使用者應使用該語言編寫可編輯元素的語言。該屬性包含一個“語言標籤”(由連字元分隔的“語言子標籤”組成),其格式在RFC 5646:語言標識標籤(也稱為 BCP 47)中定義。xml:lang優先於它。

nonce

一個加密的 nonce(“一次性使用數字”),內容安全策略可以使用它來確定是否允許給定的提取繼續進行。

part

元素的部件名稱的空格分隔列表。部件名稱允許 CSS 透過::part偽元素選擇和設定陰影樹中特定元素的樣式。

popover

用於將元素指定為彈出視窗元素(請參閱Popover API)。彈出視窗元素透過display: none隱藏,直到透過呼叫/控制元素(即具有popovertarget屬性的<button><input type="button">)或HTMLElement.showPopover()呼叫開啟。

role

角色定義內容的語義含義,允許螢幕閱讀器和其他工具以與使用者對該型別物件期望一致的方式呈現和支援與物件的互動。角色使用role="role_type"新增到 HTML 元素中,其中role_type是 ARIA 規範中角色的名稱。

slot

陰影 DOM陰影樹中的插槽分配給元素:具有slot屬性的元素分配給由<slot>元素建立的插槽,其name屬性的值與該slot屬性的值匹配。

spellcheck

一個列舉屬性定義元素是否可以檢查拼寫錯誤。它可以具有以下值

  • 空字串或true,表示應在可能的情況下檢查元素的拼寫錯誤;
  • false,表示不應檢查元素的拼寫錯誤。
style

包含要應用於元素的CSS樣式宣告。請注意,建議在單獨的檔案或檔案中定義樣式。此屬性和<style>元素的主要目的是允許快速樣式設定,例如用於測試目的。

tabindex

一個整數屬性,指示元素是否可以獲取輸入焦點(是否可聚焦),是否應參與順序鍵盤導航,以及如果參與,則在什麼位置。它可以取幾個值

  • 負值表示該元素應可聚焦,但不能透過順序鍵盤導航訪問;
  • 0表示該元素應可聚焦並可透過順序鍵盤導航訪問,但其相對順序由平臺約定定義;
  • 正值表示該元素應可聚焦並可透過順序鍵盤導航訪問;元素獲得焦點的順序是tabindex值的遞增順序。如果多個元素共享相同的 tabindex,則它們的相對順序遵循它們在文件中的相對位置。
title

包含表示與其所屬元素相關的建議資訊的文字。此類資訊通常(但不一定)可以作為工具提示呈現給使用者。

translate

一個列舉屬性,用於指定在本地化頁面時是否要翻譯元素的屬性值及其Text節點子節點的值,或者是否保持不變。它可以具有以下值

  • 空字串或yes,表示將翻譯元素。
  • no,表示該元素不會被翻譯。
virtualkeyboardpolicy 實驗性

一個列舉屬性,用於控制平板電腦、手機或其他可能沒有硬體鍵盤的裝置上的螢幕虛擬鍵盤行為,對於其內容可編輯的元素(例如,它是<input><textarea>元素,或設定了contenteditable屬性的元素)。

  • auto空字串,當元素獲得焦點或被點選時自動顯示虛擬鍵盤。
  • manual,將元素的焦點和點選與虛擬鍵盤的狀態分離。

writingsuggestions

用於控制瀏覽器在輸入欄位、頁面的一部分或整個頁面中寫入建議的行為。

  • false,停用瀏覽器的寫入建議。
  • true空字串,啟用寫入建議。

規範

規範
HTML 標準
# the-accesskey-attribute
HTML 標準
# attr-autocapitalize
HTML 標準
# dom-fe-autofocus
HTML 標準
# global-attributes:classes-2
HTML 標準
# attr-contenteditable
HTML 標準
# attr-data-*
HTML 標準
# the-dir-attribute
HTML 標準
# the-draggable-attribute
HTML 標準
# attr-enterkeyhint
CSS 陰影部件
# element-attrdef-html-global-exportparts
HTML 標準
# the-hidden-attribute
HTML 標準
# global-attributes:the-id-attribute-2
HTML 標準
# the-inert-attribute
HTML 標準
# attr-inputmode
HTML 標準
# attr-is
HTML 標準
# attr-lang
HTML 標準
# attr-nonce
CSS 陰影部件
# part-attr
HTML 標準
# the-popover-attribute
HTML 標準
# attr-slot
DOM 標準
# ref-for-dom-element-slot①
HTML 標準
# attr-spellcheck
HTML 標準
# the-style-attribute
HTML 標準
# attr-tabindex
HTML 標準
# the-title-attribute
HTML 標準
# attr-translate
虛擬鍵盤 API
# dom-elementcontenteditable-virtualkeyboardpolicy
HTML 標準
# 寫入建議

瀏覽器相容性

BCD 表格僅在瀏覽器中載入

另請參閱

  • Element 介面,允許查詢大多數全域性屬性。