HTMLElement

实例属性

它还继承了其父接口 Element 的属性。

HTMLElement.accessKey

一个字符串，表示分配给该元素的访问键。

HTMLElement.accessKeyLabel 只读

返回一个字符串，其中包含分配给元素的访问键。

HTMLElement.anchorElement 只读  非标准 实验性

返回对元素锚点元素的引用，如果没有则返回 null。

HTMLElement.attributeStyleMap 只读

一个 StylePropertyMap，表示元素的 style 属性的声明。

HTMLElement.autocapitalize

一个字符串，表示元素的用户输入大小写行为。有效值包括：none、off、on、characters、words、sentences。

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

当与带有有效 commandForElement 和 command 值的 button 控制的元素进行交互时（例如，点击它），会触发此事件。

error

当资源加载失败或无法使用时触发。

load

当包含资源的元素成功加载资源时触发。

拖放事件

drag

当元素或文本选择被拖动时触发此事件。

dragend

当拖动操作结束时（通过释放鼠标按钮或按下 Esc 键）触发此事件。

dragenter

当拖动的元素或文本选择进入有效的放置目标时触发此事件。

dragleave

当拖动的元素或文本选择离开有效的放置目标时触发此事件。

dragover

当元素或文本选择被拖动且鼠标指针位于有效的放置目标上方时，此事件会持续触发（如果鼠标未移动，则每 50 毫秒一次；如果鼠标移动，则更快，大约在 5 毫秒（慢速移动）到 1 毫秒（快速移动）之间。此触发模式与 mouseover 不同）。

dragstart

当用户开始拖动元素或文本选择时触发此事件。

drop

当元素或文本选择被放置在有效的放置目标上时触发此事件。

切换事件

beforetoggle

当元素是 弹出框 或 <dialog> 时，在它隐藏或显示之前触发。

toggle

当元素是 弹出框、<dialog> 或 <details> 元素时，在它隐藏或显示之后触发。

规范

浏览器兼容性

另见

• Element