HTMLOutputElement

基线 广泛可用

此功能已得到很好的确立,并且可在许多设备和浏览器版本中使用。它已在浏览器中可用,自 2018 年 10 月.

HTMLOutputElement 接口提供了属性和方法(除了从 HTMLElement 继承的属性和方法之外),用于操作 <output> 元素的布局和显示。

EventTarget Node Element HTMLElement HTMLOutputElement

实例属性

此接口还继承了其父级 HTMLElement 的属性。

HTMLOutputElement.defaultValue

表示元素默认值的字符串,最初为空字符串。

HTMLOutputElement.form 只读

一个 HTMLFormElement,指示与控件关联的表单,如果定义了 form HTML 属性,则反映该属性。

HTMLOutputElement.htmlFor 只读

一个 DOMTokenList,反映 for HTML 属性,包含同一文档中其他元素的 ID 列表,这些元素有助于(或以其他方式影响)计算出的 value

HTMLOutputElement.labels 只读

一个 NodeList,包含与元素关联的 <label> 元素。

HTMLOutputElement.name

一个字符串,反映 name HTML 属性,包含与表单数据一起提交的控件的名称。

HTMLOutputElement.type 只读

字符串“output”。

HTMLOutputElement.validationMessage 只读

一个字符串,表示本地化的消息,该消息描述控件不满足的验证约束(如果有)。如果控件不是约束验证的候选对象(willValidatefalse),或者它满足其约束,则此字符串为空字符串。

HTMLOutputElement.validity 只读

一个 ValidityState,表示此元素所处的有效性状态。

HTMLOutputElement.value

一个字符串,表示元素内容的值。其行为类似于 Node.textContent 属性。

HTMLOutputElement.willValidate 只读

一个布尔值,指示元素是否为约束验证的候选对象。

实例方法

此接口还继承了其父级 HTMLElement 的方法。

HTMLOutputElement.checkValidity()

检查元素的有效性,并返回一个包含检查结果的布尔值。

HTMLOutputElement.reportValidity()

此方法将元素上的约束问题(如果有)报告给用户。如果存在问题,则在元素上触发 invalid 事件,并返回 false;如果不存在问题,则返回 true

报告问题时,用户代理可能会将焦点设置到元素上并更改文档的滚动位置,或者执行其他一些操作以将元素吸引到用户的注意。如果此元素同时存在多个问题,则用户代理可能会报告多个约束违规。如果未呈现元素,则用户代理可能会为正在运行的脚本报告错误,而不是通知用户。

HTMLOutputElement.setCustomValidity()

为元素设置自定义有效性消息。如果此消息不是空字符串,则表示元素存在自定义有效性错误,并且无效。

模式

此元素以两种模式之一运行:默认模式和模式。

默认模式

最初,元素处于默认模式,因此元素的内容表示元素的值及其默认值。

如果元素在默认模式下,并且元素的后代以任何方式更改,则 defaultValue 属性将设置为 textContent 属性的值。

重置表单会将元素置于默认模式,并将 textContent 属性设置为 defaultValue 属性的值。

值模式

当设置 value 属性的内容时,元素进入值模式。否则,value 属性的行为类似于 textContent 属性。当元素处于值模式时,默认值只能通过 defaultValue 属性访问。

规范

规范
HTML 标准
# htmloutputelement

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

  • 实现此接口的 HTML 元素:<output>