HTMLKeygenElement - 操作 <keygen> 元素

注意： 此页面描述了关于 Keygen 元素的接口，而不是 Gecko 当前实现的接口。有关详细信息和状态，请参阅 Mozilla bug 101019。

HTMLKeygenElement 是 <keygen> 元素的接口，它提供了特殊的属性和方法（除了通过继承通用的 HTMLElement 接口获得的常规属性），来操作 keygen 元素的布局和表示。

属性

autofocus

一个 Boolean，反映了 autofocus HTML 属性，指示表单控件在页面加载时应具有输入焦点。

challenge

一个 DOMString，反映了 challenge HTML 属性，其中包含与提交的密钥一起打包的质询字符串。

disabled

一个 Boolean，反映了 disabled HTML 属性，表示该控件不可用于交互。

form

一个只读的 HTMLFormElement，表示控件的表单所有者，反映 form HTML 属性（如果已定义）。

keytype

一个 DOMString，反映了 keytype HTML 属性，包含使用的密钥类型。

labels 未实现 (查看 Mozilla bug 556743)

一个只读的 NodeList，表示与此 keygen 元素关联的标签元素列表。

name

一个 DOMString，反映了 name HTML 属性，包含随表单数据提交的控件的名称。

type

一个只读的 DOMString，值必须是 keygen。

validationMessage

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

validity

一个只读的 ValidityState，表示该元素的有效状态。

willValidate

一个只读的 Boolean，始终为 false，因为 keygen 对象永远不是约束验证的候选对象。

方法

checkValidity()

返回 Boolean，始终返回 true，因为 keygen 对象永远不会成为约束验证的候选对象。

setCustomValidity(in DOMString error)

返回 void，为元素设置自定义有效性消息。如果此消息不是空字符串，则表示该元素是自定义有效性错误状态，并且不通过验证。

桌面浏览器兼容性

移动浏览器兼容性

1. 参阅 Chrome 平台状态。

2. 参阅 bug 1315460.