HTMLElement

HTMLElement 接口表示任何 HTML 元素。某些元素直接实现此接口,而其他元素则通过继承它的接口实现它。

EventTarget Node Element HTMLElement

实例属性

还继承其父级 Element 的属性。

HTMLElement.accessKey

表示分配给元素的访问键的字符串。

HTMLElement.accessKeyLabel 只读

返回包含元素分配的访问键的字符串。

HTMLElement.anchorElement 只读   非标准 实验性

返回对元素的锚元素的引用,如果它没有锚元素则返回 null

HTMLElement.attributeStyleMap 只读

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

autocapitalize

表示元素对用户输入的大写行为的字符串。有效值为:noneoffoncharacterswordssentences

HTMLElement.autofocus

一个布尔值,反映 autofocus HTML 全局属性的值,该属性指示页面加载时或在指定在 <dialog> 元素或设置了 popover 属性的元素内的元素中时对话框或弹出窗口显示时是否应聚焦控件。

HTMLElement.contentEditable

一个字符串,其中值为 true 表示元素可编辑,值为 false 表示不可编辑。

HTMLElement.dataset 只读

返回一个 DOMStringMap,脚本可以使用它读取和写入元素的 自定义数据属性 (data-*)。

HTMLElement.dir

一个字符串,反映 dir 全局属性的值,表示元素的方向性。可能的值为 "ltr""rtl""auto"

HTMLElement.draggable

一个布尔值,指示元素是否可以拖动。

HTMLElement.editContext 实验性

返回与元素关联的 EditContext,如果没有则返回 null

HTMLElement.enterKeyHint

一个字符串,定义在虚拟键盘上为 Enter 键显示什么操作标签(或图标)。

HTMLElement.hidden

一个字符串或布尔值,反映元素的 hidden 属性的值。

HTMLElement.inert

一个布尔值,指示用户代理是否必须表现得好像给定节点对于用户交互事件、页面内文本搜索(“在页面中查找”)和文本选择不存在。

HTMLElement.innerText

表示节点及其后代的渲染文本内容。作为 getter,它近似于用户如果使用光标突出显示元素的内容然后将其复制到剪贴板将获得的文本。作为 setter,它替换选定元素内部的内容,并将任何换行符转换为 <br> 元素。

HTMLElement.inputMode

一个字符串值,反映元素的 inputmode 属性的值。

HTMLElement.isContentEditable 只读

返回一个布尔值,指示元素的内容是否可以编辑。

HTMLElement.lang

一个字符串,表示元素的属性、文本和元素内容的语言。

HTMLElement.nonce

返回内容安全策略用来确定是否允许给定提取继续进行的一次性加密数字。

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""manual"),并且可用于功能检测。反映全局 HTML 属性 popover 的值。

HTMLElement.spellcheck

一个布尔值,用于控制 拼写检查 提示。它适用于所有 HTML 元素,但并非所有元素都受其影响。

HTMLElement.style

一个 CSSStyleDeclaration 对象,表示元素 style 属性的声明。

HTMLElement.tabIndex

一个表示元素在 Tab 键顺序中位置的long类型值。

HTMLElement.title

一个包含文本的字符串,当鼠标悬停在元素上时,该文本会显示在弹出框中。

HTMLElement.translate

一个表示翻译的布尔值。

HTMLElement.virtualKeyboardPolicy 实验性

一个字符串,指示在平板电脑、手机或其他可能没有硬件键盘的设备上,屏幕虚拟键盘的行为,前提是元素的内容可编辑(例如,它是 <input><textarea> 元素,或者设置了 contenteditable 属性的元素)。

实例方法

还继承了其父级 Element 的方法。

HTMLElement.attachInternals()

返回一个 ElementInternals 对象,并使自定义元素能够参与 HTML 表单。

HTMLElement.blur()

从当前获得焦点的元素中移除键盘焦点。

HTMLElement.click()

向元素发送鼠标单击事件。

HTMLElement.focus()

使元素成为当前键盘焦点。

HTMLElement.hidePopover()

通过将其从 顶层 移除并使用 display: none 样式化来隐藏弹出窗口元素。

HTMLElement.showPopover()

通过将其添加到 顶层 并从其样式中移除 display: none; 来显示弹出窗口元素。

HTMLElement.togglePopover()

在隐藏和显示状态之间切换弹出窗口元素。

事件

使用 addEventListener() 或通过将事件侦听器分配给此接口的 oneventname 属性来侦听这些事件。

此外,还继承了其父级 Element 的事件。

cancel

当用户通过按下 Esc 键关闭当前打开的对话框来取消对话框时,会为 <input><dialog> 元素触发此事件。

change

<input><select><textarea> 元素的 value 值已被用户更改并提交时触发。与 input 事件不同,change 事件并非一定会在每次更改元素的 value 值时都触发。

error

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

load

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

剪贴板事件

copy

当用户通过浏览器的用户界面启动复制操作时触发。

cut

当用户通过浏览器的用户界面启动剪切操作时触发。

paste

当用户通过浏览器的用户界面启动粘贴操作时触发。

拖放事件

drag

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

dragend

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

dragenter

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

dragleave

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

dragover

当正在拖动元素或文本选择并且鼠标指针位于有效的放置目标上时,会连续触发此事件(鼠标未移动时每 50 毫秒触发一次,否则在 5 毫秒(缓慢移动)和 1 毫秒(快速移动)之间更快地触发。此触发模式与 mouseover 不同)。

dragstart

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

drop

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

弹出窗口事件

beforetoggle

当元素是弹出窗口时,在隐藏或显示之前触发。

toggle

当元素是弹出窗口时,在隐藏或显示之后立即触发。

规范

规范
HTML 标准
# htmlelement

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅