HTMLElement

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

HTMLElement 介面表示任何 HTML 元素。有些元素直接實現此介面,而另一些元素則透過繼承此介面的介面來實現。

EventTarget Node Element HTMLElement

例項屬性

它還繼承了其父介面 Element 的屬性。

HTMLElement.accessKey

一個字串,表示分配給該元素的訪問鍵。

HTMLElement.accessKeyLabel 只讀

返回一個字串,其中包含分配給元素的訪問鍵。

HTMLElement.anchorElement 只讀  非標準 實驗性

返回對元素錨點元素的引用,如果沒有則返回 null

HTMLElement.attributeStyleMap 只讀

一個 StylePropertyMap,表示元素的 style 屬性的宣告。

HTMLElement.autocapitalize

一個字串,表示元素的使用者輸入大小寫行為。有效值包括:noneoffoncharacterswordssentences

HTMLElement.autofocus

一個布林值,反映 autofocus HTML 全域性屬性,表示當頁面載入時,或者當指定在 <dialog> 元素內部或設定了 popover 屬性的元素內部時,對話方塊或彈出視窗顯示時,控制元件是否應該獲得焦點。

HTMLElement.autocorrect

一個布林值,表示使用者輸入的文字是否應自動更正。這反映了 autocorrect HTML 全域性屬性。

HTMLElement.contentEditable

一個字串,值為 true 表示元素可編輯,值為 false 表示不可編輯。

HTMLElement.dataset 只讀

返回一個 DOMStringMap,指令碼可以透過它讀取和寫入元素的 自定義資料屬性data-*)。

HTMLElement.dir

一個字串,反映 dir 全域性屬性,表示元素的文字方向。可能的值為 "ltr""rtl""auto"

HTMLElement.draggable

一個布林值,表示元素是否可拖動。

HTMLElement.editContext 實驗性

返回與元素關聯的 EditContext,如果沒有則返回 null

HTMLElement.enterKeyHint

一個字串,定義在虛擬鍵盤上回車鍵顯示的操作標籤(或圖示)。

HTMLElement.hidden

一個字串或布林值,反映元素的 hidden 屬性的值。

HTMLElement.inert

一個布林值,指示使用者代理在使用者互動事件、頁面內文字搜尋(“在頁面中查詢”)和文字選擇方面是否必須表現得如同給定節點不存在一樣。

HTMLElement.innerText

表示節點及其後代的渲染文字內容。作為 getter,它近似於使用者用游標突出顯示元素內容並複製到剪貼簿時將獲得的文字。作為 setter,它替換選定元素內部的內容,並將所有換行符轉換為 <br> 元素。

HTMLElement.inputMode

一個字串值,反映元素的 inputmode 屬性的值。

HTMLElement.isContentEditable 只讀

返回一個布林值,指示元素內容是否可編輯。

HTMLElement.lang

一個字串,表示元素的屬性、文字和元素內容的語言。

HTMLElement.nonce

返回內容安全策略(Content Security Policy)用於確定是否允許進行給定抓取的加密一次性數字。

HTMLElement.offsetHeight 只讀

返回一個 double,其中包含元素的佈局高度。

HTMLElement.offsetLeft 只讀

返回一個 double,表示此元素的左邊框到其 offsetParent 的左邊框的距離。

HTMLElement.offsetParent 只讀

一個 Element,是當前所有偏移量計算的參照元素。

HTMLElement.offsetTop 只讀

返回一個 double,表示此元素的上邊框到其 offsetParent 的上邊框的距離。

HTMLElement.offsetWidth 只讀

返回一個 double,其中包含元素的佈局寬度。

HTMLElement.outerText

表示節點及其後代的渲染文字內容。作為 getter,它與 HTMLElement.innerText 相同(它表示元素及其後代的渲染文字內容)。作為 setter,它用給定值替換選定的節點及其內容,並將所有換行符轉換為 <br> 元素。

HTMLElement.popover

透過 JavaScript 獲取和設定元素的彈出框狀態("auto""hint""manual"),可用於功能檢測。它反映了 popover 全域性 HTML 屬性的值。

HTMLElement.spellcheck

一個布林值,控制 拼寫檢查 提示。它適用於所有 HTML 元素,但並非對所有元素都有效。

HTMLElement.style

一個 CSSStyleDeclaration,表示元素的 style 屬性的宣告。

HTMLElement.tabIndex

一個 long,表示元素在 Tab 鍵順序中的位置。

HTMLElement.title

一個字串,包含滑鼠懸停在元素上時在彈出框中顯示的文字。

HTMLElement.translate

一個布林值,表示翻譯。

HTMLElement.virtualKeyboardPolicy 實驗性

一個字串,指示在平板電腦、手機或其他可能沒有硬體鍵盤的裝置上,如果元素內容可編輯(例如,它是 <input><textarea> 元素,或設定了 contenteditable 屬性的元素),則螢幕虛擬鍵盤的行為。

HTMLElement.writingSuggestions

一個字串,指示在元素範圍內是否應啟用瀏覽器提供的寫作建議。

例項方法

它還繼承了其父介面 Element 的方法。

HTMLElement.attachInternals()

返回一個 ElementInternals 物件,並使自定義元素能夠參與 HTML 表單。

HTMLElement.blur()

從當前獲得焦點的元素中移除鍵盤焦點。

HTMLElement.click()

向元素髮送滑鼠點選事件。

HTMLElement.focus()

使元素成為當前的鍵盤焦點。

HTMLElement.hidePopover()

透過將其從 頂層 移除並將其樣式設定為 display: none 來隱藏彈出元素。

HTMLElement.showPopover()

透過將其新增到 頂層 並從其樣式中移除 display: none; 來顯示彈出元素。

HTMLElement.togglePopover()

切換彈出元素在隱藏和顯示狀態之間。

事件

使用 addEventListener() 監聽這些事件,或透過將事件監聽器分配給此介面的 oneventname 屬性。

此外,它還繼承了其父介面 Element 的事件。

change

<input><select><textarea> 元素的 value 被使用者更改並提交時觸發。與 input 事件不同,change 事件不一定會針對元素 value 的每次更改都觸發。

command

當與帶有有效 commandForElementcommand 值的 button 控制的元素進行互動時(例如,點選它),會觸發此事件。

error

當資源載入失敗或無法使用時觸發。

load

當包含資源的元素成功載入資源時觸發。

拖放事件

drag

當元素或文字選擇被拖動時觸發此事件。

dragend

當拖動操作結束時(透過釋放滑鼠按鈕或按下 Esc 鍵)觸發此事件。

dragenter

當拖動的元素或文字選擇進入有效的放置目標時觸發此事件。

dragleave

當拖動的元素或文字選擇離開有效的放置目標時觸發此事件。

dragover

當元素或文字選擇被拖動且滑鼠指標位於有效的放置目標上方時,此事件會持續觸發(如果滑鼠未移動,則每 50 毫秒一次;如果滑鼠移動,則更快,大約在 5 毫秒(慢速移動)到 1 毫秒(快速移動)之間。此觸發模式與 mouseover 不同)。

dragstart

當用戶開始拖動元素或文字選擇時觸發此事件。

drop

當元素或文字選擇被放置在有效的放置目標上時觸發此事件。

切換事件

beforetoggle

當元素是 彈出框<dialog> 時,在它隱藏或顯示之前觸發。

toggle

當元素是 彈出框<dialog><details> 元素時,在它隱藏或顯示之後觸發。

規範

規範
HTML
# htmlelement

瀏覽器相容性

另見