我们的志愿者还没有将这篇文章翻译为 中文 (简体)加入我们帮助完成翻译
您也可以阅读此文章的English (US)版。

Deprecated
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

Note: This page describes the Keygen Element interface as specified, not as currently implemented by Gecko. See bug 101019 for details and status.

The <keygen> elements expose the HTMLKeygenElement interface, which provides special properties and methods (beyond the regular element object interface they also have available to them by inheritance) for manipulating the layout and presentation of keygen elements.

Properties

Name Type Description
autofocus Boolean Reflects the autofocus HTML attribute, indicating that the form control should have input focus when the page loads.
challenge DOMString Reflects the challenge HTML attribute, containing a challenge string that is packaged with the submitted key.
disabled Boolean Reflects the disabled HTML attribute, indicating that the control is not available for interaction.
form readonly HTMLFormElement Indicates the control's form owner, reflecting the form HTML attribute if it is defined.
keytype DOMString Reflects the keytype HTML attribute, containing the type of key used.
labels Unimplemented (see bug 556743) readonly NodeList A list of label elements associated with this keygen element.
name DOMString Reflects the name HTML attribute, containing the name for the control that is submitted with form data.
type readonly DOMString Must be the value keygen.
validationMessage readonly DOMString A localized message that describes the validation constraints that the control does not satisfy (if any). This is the empty string if the control is not a candidate for constraint validation (willValidate is false), or it satisfies its constraints.
validity readonly ValidityState The validity states that this element is in.
willValidate Boolean Always false because keygen objects are never candidates for constraint validation.

Methods

Name & Arguments Return Description
checkValidity() Boolean Always returns true because keygen objects are never candidates for constraint validation.
setCustomValidity(in DOMString error) void Sets a custom validity message for the element. If this message is not the empty string, then the element is suffering from a custom validity error, and does not validate.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic support
DeprecatedNon-standard
Chrome No support ? — 57
Notes
No support ? — 57
Notes
Notes See Chrome Platform Status.
Edge ? Firefox Partial support Partial
Notes
Partial support Partial
Notes
Notes See bug 1315460.
IE ? Opera No support NoSafari ? WebView Android ? Chrome Android No support ? — 57
Notes
No support ? — 57
Notes
Notes See Chrome Platform Status.
Edge Mobile ? Firefox Android Partial support Partial
Notes
Partial support Partial
Notes
Notes See bug 1315460.
Opera Android No support NoSafari iOS ? Samsung Internet Android ?

Legend

Partial support  
Partial support
No support  
No support
Compatibility unknown  
Compatibility unknown
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.
See implementation notes.
See implementation notes.

文档标签和贡献者

此页面的贡献者: sideshowbarker, fscholz, teoli, Nexii, kscarfone, Sheppy, jswisher
最后编辑者: sideshowbarker,