HTMLOutputElement
HTMLOutputElement
接口提供了属性和方法(除了从 HTMLElement
继承的属性和方法之外),用于操作 <output>
元素的布局和显示。
实例属性
此接口还继承了其父级 HTMLElement
的属性。
HTMLOutputElement.defaultValue
-
表示元素默认值的字符串,最初为空字符串。
HTMLOutputElement.form
只读-
一个
HTMLFormElement
,指示与控件关联的表单,如果定义了form
HTML 属性,则反映该属性。 HTMLOutputElement.htmlFor
只读-
一个
DOMTokenList
,反映for
HTML 属性,包含同一文档中其他元素的 ID 列表,这些元素有助于(或以其他方式影响)计算出的value
。 HTMLOutputElement.labels
只读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 标准 # htmloutputelement |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。
另请参阅
- 实现此接口的 HTML 元素:
<output>
。