HTMLOutputElement

实例属性

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

HTMLOutputElement.defaultValue

一个字符串，表示元素的默认值，初始为空字符串。

HTMLOutputElement.form 只读

一个 HTMLFormElement，表示与控件关联的表单，反映了 form HTML 属性（如果已定义）。

HTMLOutputElement.htmlFor 只读

一个 DOMTokenList，反映了 for HTML 属性，包含文档中其他影响（或以其他方式影响）计算出的 value 的元素的 ID 列表。

HTMLOutputElement.labels 只读

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

HTMLOutputElement.name

一个字符串，反映 name HTML 属性，包含提交表单数据时使用的控件名称。

HTMLOutputElement.type 只读

字符串 "output"。

HTMLOutputElement.validationMessage 只读

一个字符串，表示本地化的消息，描述了控件未满足的验证约束（如果有）。如果控件不是约束验证的候选者（willValidate 为 false），或者它满足了其约束，则此字符串为空。

HTMLOutputElement.validity 只读

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

HTMLOutputElement.value

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

HTMLOutputElement.willValidate 只读

返回一个布尔值，指示该元素是否是约束验证的候选者。对于 HTMLOutputElement 对象，此值始终为 false。

实例方法

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

HTMLOutputElement.checkValidity()

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

HTMLOutputElement.reportValidity()

此方法向用户报告元素约束的问题（如果有）。如果存在问题，则在元素上触发 invalid 事件，并返回 false；如果没有问题，则返回 true。

当报告问题时，用户代理可能会将焦点放在元素上，并更改文档的滚动位置，或执行其他将元素引起用户注意的操作。用户代理可能会报告多个约束违反，如果该元素同时存在多个问题。如果元素未渲染，用户代理可能会报告正在运行的脚本的错误，而不是通知用户。

HTMLOutputElement.setCustomValidity()

为元素设置自定义有效性消息。如果此消息不是空字符串，则元素存在自定义有效性错误，并且不进行验证。

模式

此元素有两种模式：“默认”模式和“值”模式。

默认模式

最初，该元素处于默认模式，此时元素的内容既表示元素的值，也表示其默认值。

如果在默认模式下，元素的子孙后代以任何方式发生更改，则 defaultValue 属性将被设置为 textContent 属性的值。

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

值模式

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

规范

浏览器兼容性

另见

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