HTMLElement
HTMLElement
接口表示任何 HTML 元素。某些元素直接实现此接口,而其他元素则通过继承它的接口实现它。
实例属性
还继承其父级 Element
的属性。
HTMLElement.accessKey
-
表示分配给元素的访问键的字符串。
HTMLElement.accessKeyLabel
只读-
返回包含元素分配的访问键的字符串。
HTMLElement.anchorElement
只读 非标准 实验性-
返回对元素的锚元素的引用,如果它没有锚元素则返回
null
。 HTMLElement.attributeStyleMap
只读-
一个
StylePropertyMap
,表示元素的style
属性的声明。 autocapitalize
-
表示元素对用户输入的大写行为的字符串。有效值为:
none
、off
、on
、characters
、words
、sentences
。 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 键显示什么操作标签(或图标)。
-
一个字符串或布尔值,反映元素的
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
的事件。
剪贴板事件
拖放事件
drag
-
当正在拖动元素或文本选择时触发此事件。
dragend
-
当拖动操作结束时(通过释放鼠标按钮或按下 Esc 键)触发此事件。
dragenter
-
当被拖动的元素或文本选择进入有效的放置目标时触发此事件。
dragleave
-
当被拖动的元素或文本选择离开有效的放置目标时触发此事件。
dragover
-
当正在拖动元素或文本选择并且鼠标指针位于有效的放置目标上时,会连续触发此事件(鼠标未移动时每 50 毫秒触发一次,否则在 5 毫秒(缓慢移动)和 1 毫秒(快速移动)之间更快地触发。此触发模式与
mouseover
不同)。 dragstart
-
当用户开始拖动元素或文本选择时触发此事件。
drop
-
当元素或文本选择被放置到有效的放置目标上时触发此事件。
弹出窗口事件
beforetoggle
-
当元素是弹出窗口时,在隐藏或显示之前触发。
toggle
-
当元素是弹出窗口时,在隐藏或显示之后立即触发。
规范
规范 |
---|
HTML 标准 # htmlelement |
浏览器兼容性
BCD 表格仅在浏览器中加载