HTMLOutputElement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2018.
HTMLOutputElement
接口提供用于操作 <output>
元素的布局和呈现的特定属性和方法(除了从 HTMLElement
接口继承的之外)。
实例属性
还从其父接口 HTMLElement
继承属性。
HTMLOutputElement.defaultValue
-
一个表示元素默认值的字符串,初始为空字符串。
HTMLOutputElement.form
只读-
一个表示与控件关联的表单的
HTMLFormElement
,如果定义了form
HTML 属性,则反映该属性。 HTMLOutputElement.htmlFor
只读-
一个反映
for
HTML 属性的DOMTokenList
,包含同一文档中有助于(或以其它方式影响)计算出value
的其它元素的 ID 列表。 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
属性访问默认值。
规范
Specification |
---|
HTML Standard # htmloutputelement |
浏览器兼容性
BCD tables only load in the browser
参见
- 实现此接口的 HTML 元素 :
<output>