HTMLOutputElement 接口提供用于操作<output> 元素的布局和呈现的特定属性和方法（除了从HTMLElement 接口继承的之外）。

实例属性

还从其父接口HTMLElement 继承属性。

HTMLOutputElement.defaultValue

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

HTMLOutputElement.form只读

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

HTMLOutputElement.htmlFor只读

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

HTMLOutputElement.labels只读

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

HTMLOutputElement.name

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

HTMLOutputElement.type只读

字符串“output”。

HTMLOutputElement.validationMessage只读

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

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 元素 :<output>