大网数据广告活动
Web 标准与前端开发

HTMLOutputElement

· 52CE 我爱测

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

HTML DOM

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()

    • : 此方法报告元素约束的问题,如果有的话,报给用户。如果有问题,在当前元素上触发 HTMLInputElement/invalid_event 事件,且返回 false;如果没有问题,则返回 true。

      当报告问题时,用户代理可以聚焦元素并更改文档的滚动位置,或执行一些其它动作来引起用户的注意。如果此元素同时出现多个问题,用户代理可能报告多个约束违规。如果元素没有渲染,则用户代理可能报告正在允许的脚本错误,而不是通知用户。

  • HTMLOutputElement.setCustomValidity()

    • : 设置元素的自定义验证消息。如果消息不是空字符串,则该元素存在自定义验证错误,且无法通过验证。

模式

此元素的行为模式有两种:默认模式和值模式。

默认模式

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

当元素的后代以任何方式发生变化时,如果元素处于默认模式,defaultValue 属性将设置为 Node.textContent 属性的值。

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

值模式

当设置 value 属性内容时,元素进入值模式。value 属性在其他方面的行为类似于 Node.textContent 属性。当元素处于值模式,仅可通过 defaultValue 属性访问默认值。

规范

浏览器兼容性

参见

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

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。