keygen – key-pair generator/input control (NEW)

ⓘ keygen – key-pair generator/input control NEW # T

The keygen element represents a control for generating a public-private key pair and for submitting the public key from that key pair.

Permitted contents #

empty (void element)

Permitted attributes #

global attributes & challenge & keytype & autofocus & name & disabled & form

ⓘ global attributes: Any attributes permitted globally.
ⓘ challenge = string #: A challenge string that is submitted along with the public key.
ⓘ keytype = "rsa" #: The type of key generated.
ⓘ autofocus = "autofocus" or "" (empty string) or empty NEW #: Specifies that the element represents a control to which a UA is meant to give focus as soon as the document is loaded.
ⓘ name = string #: The name part of the name/value pair associated with this element for the purposes of form submission.
ⓘ disabled = "disabled" or "" (empty string) or empty #: Specifies that the element represents a disabled control.
ⓘ form = ID reference NEW #: The value of the id attribute on the form with which to associate the element.

Additional constraints and admonitions #

The interactive element keygen must not appear as a descendant of the a element.
The interactive element keygen must not appear as a descendant of the button element.
Any keygen element descendant of a label element with a for attribute must have an ID value that matches that for attribute.

Tag omission #

The keygen element is a void element. A keygen element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLKeygenElement : HTMLElement {
           attribute boolean autofocus;
           attribute DOMString challenge;
           attribute boolean disabled;
  readonly attribute HTMLFormElement? form;
           attribute DOMString keytype;
           attribute DOMString name;

  readonly attribute DOMString type;

  readonly attribute boolean willValidate;
  readonly attribute ValidityState validity;
  readonly attribute DOMString validationMessage;
  boolean checkValidity();
  void setCustomValidity(DOMString error);

  readonly attribute NodeList labels;
};

HTML: The Markup Language (an HTML language reference)