Provides a hint for generating a keyboard shortcut for the current element.
Provides a hint for generating a keyboard shortcut for the current element. This attribute consists of a space-separated list of characters. The browser should use the first one that exists on the computer keyboard layout.
This Boolean attribute lets you specify that the control should have input focus when the page loads, unless the user overrides it, for example by typing in a different control.
This Boolean attribute lets you specify that the control should have input focus when the page loads, unless the user overrides it, for example by typing in a different control. Only one form element in a document can have the
autofocus
attribute, which is a Boolean.
A challenge string that is submitted along with the public key.
A challenge string that is submitted along with the public key. Defaults to an empty string if not specified.
Is a space-separated list of the classes of the element.
Is a space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the
class selectors or functions like the method
Document.getElementsByClassName()
.
Is an enumerated attribute indicating if the element should be editable by the user.
Is an enumerated attribute indicating if the element should be editable by the user. If so, the browser modifies its widget to allow editing. The attribute must take one of the following values:
true
or the empty string, which indicates that the element must be editable;false
, which indicates that the element must not be editable.Is the
id
of an
<menu>
to use as the contextual menu for this element.
Is an enumerated attribute indicating the directionality of the element's text.
Is an enumerated attribute indicating the directionality of the element's text. It can have the following values:
ltr
, which means left to right and is to be used for languages that are written from the left to the right (like English);rtl
, which means right to left and is to be used for languages that are written from the right to the left (like Arabic);auto
, which let the user agent decides. It uses a basic algorithm as it parses the characters inside the element until it finds a character with a strong directionality, then apply that directionality to the whole element.This Boolean attribute indicates that the form control is not available for interaction.
Is an enumerated attribute indicating whether the element can be dragged, using the Drag and Drop API.
Is an enumerated attribute indicating whether the element can be dragged, using the Drag and Drop API. It can have the following values:
true
, which indicates that the element may be draggedfalse
, which indicates that the element may not be dragged.Is an enumerated attribute indicating what types of content can be dropped on an element, using the Drag and Drop API.
Is an enumerated attribute indicating what types of content can be dropped on an element, using the Drag and Drop API. It can have the following values:
copy
, which indicates that dropping will create a copy of the element that was draggedmove
, which indicates that the element that was dragged will be moved to this new location.link
, will create a link to the dragged data.The form element that this element is associated with (its form owner).
The form element that this element is associated with (its
form owner). The value of the attribute must be an
id
of a
<form>
element in the same document. If this attribute is not specified, this element must be a descendant of a
<form>
element. This attribute enables you to place
<keygen>
elements anywhere within a document, not just as descendants of their form elements.
Is a Boolean attribute indicates that the element is not yet, or is no longer, relevant.
Is a Boolean attribute indicates that the element is not yet, or is no longer, relevant. For example, it can be used to hide elements of the page that can't be used until the login process has been completed. The browser won't render such elements. This attribute must not be used to hide content that could legitimately be shown.
Defines a unique identifier (ID) which must be unique in the whole document.
These attributes are related to the WHATWG HTML Microdata feature.
These attributes are related to the WHATWG HTML Microdata feature.
The type of key generated.
The type of key generated. The default value is
RSA
.
Participates in defining the language of the element, the language that non-editable elements are written in or the language that editable elements should be written in.
Participates in defining the language of the element, the language that non-editable elements are written in or the language that editable elements should be written in. The tag contains one single entry value in the format defines in the Tags for Identifying Languages (BCP47) IETF document. xml:lang has priority over it.
The name of the control, which is submitted with the form data.
Is an enumerated attribute defines whether the element may be checked for spelling errors.
Is an enumerated attribute defines whether the element may be checked for spelling errors. It may have the following values:
true
, which indicates that the element should be, if possible, checked for spelling errors;false
, which indicates that the element should not be checked for spelling errors.Contains CSS styling declarations to be applied to the element.
Is an integer attribute indicates if the element can take input focus (is focusable), if it should participate to sequential keyboard navigation, and if so, at what position.
Is an integer attribute indicates if the element can take input focus (is focusable), if it should participate to sequential keyboard navigation, and if so, at what position. It can takes several values:
0
means that the element should be focusable and reachable via sequential keyboard navigation, but its relative order is defined by the platform convention;Contains a text representing advisory information related to the element it belongs to.
Contains a text representing advisory information related to the element it belongs to. Such information can typically, but not necessarily, be presented to the user as a tooltip.
Is an enumerated attribute that is used to specify whether an element's attribute values and the values of it
s
Text
node children are to be translated when the page is localized, or whether to leave them unchanged.
Is an enumerated attribute that is used to specify whether an element's attribute values and the values of it
s
Text
node children are to be translated when the page is localized, or whether to leave them unchanged. It can have the following values:
"yes"
, which indicates that the element will be translated."no
", which indicates that the element will not be translated.
This element includes the global attributes. <dt>
autofocus
</dt>autofocus
attribute, which is a Boolean.challenge
</dt>disabled
</dt>form
</dt>id
of a<form>
element in the same document. If this attribute is not specified, this element must be a descendant of a<form>
element. This attribute enables you to place<keygen>
elements anywhere within a document, not just as descendants of their form elements.keytype
</dt>RSA
.name
</dt>keytype
parameter is used to specify what type of key is to be generated. Valid values are "RSA
", which is the default, "DSA
" and "EC
". Thename
andchallenge
attributes are required in all cases. Thekeytype
attribute is optional for RSA key generation and required for DSA and EC key generation. Thekeyparams
attribute is required for DSA and EC key generation and ignored for RSA key generation.PQG
is a synonym forkeyparams
. That is, you may specifykeyparams="pqg-params"
orpqg="pqg-params"
. For RSA keys, thekeyparams
parameter is not used (ignored if present). The user may be given a choice of RSA key strengths. Currently, the user is given a choice between "high" strength (2048 bits) and "medium" strength (1024 bits). For DSA keys, thekeyparams
parameter specifies the DSA PQG parameters which are to be used in the keygen process. The value of thepqg
parameter is the the BASE64 encoded, DER encoded Dss-Parms as specified in IETF RFC 3279. The user may be given a choice of DSA key sizes, allowing the user to choose one of the sizes defined in the DSA standard. For EC keys, thekeyparams
parameter specifies the name of the elliptic curve on which the key will be generated. It is normally a string from the table in nsKeygenHandler.cpp. (Note that only a subset of the curves named there may actually be supported in any particular browser.) If thekeyparams
parameter string is not a recognized curve name string, then a curve is chosen according to the user's chosen key strength (low, medium, high), using the curve named "secp384r1
" for high, and the curve named "secp256r1
" for medium keys. (Note: choice of the number of key strengths, default values for each strength, and the UI by which the user is offered a choice, are outside of the scope of this specification.) The<keygen>
element is only valid within an HTML form. It will cause some sort of selection to be presented to the user for selecting key size. The UI for the selection may be a menu, radio buttons, or possibly something else. The browser presents several possible key strengths. Currently, two strengths are offered, high and medium. If the user's browser is configured to support cryptographic hardware (e.g. "smart cards") the user may also be given a choice of where to generate the key, i.e., in a smart card or in software and stored on disk. When the submit button is pressed, a key pair of the selected size is generated. The private key is encrypted and stored in the local key database. PublicKeyAndChallenge ::= SEQUENCE { spki SubjectPublicKeyInfo, challenge IA5STRING } SignedPublicKeyAndChallenge ::= SEQUENCE { publicKeyAndChallenge PublicKeyAndChallenge, signatureAlgorithm AlgorithmIdentifier, signature BIT STRING } The public key and challenge string are DER encoded asPublicKeyAndChallenge
, and then digitally signed with the private key to produce aSignedPublicKeyAndChallenge
. TheSignedPublicKeyAndChallenge
is Base64 encoded, and the ASCII data is finally submitted to the server as the value of a form name/value pair, where the name is name as specified by thename
attribute of thekeygen
element. If no challenge string is provided, then it will be encoded as anIA5STRING
of length zero. Here is an example form submission as it would be delivered to a CGI program by the HTTP server: commonname=John+Doe&[email protected]&org=Foobar+Computing+Corp.& orgunit=Bureau+of+Bureaucracy&locality=Anytown&state=California&country=US& key=MIHFMHEwXDANBgkqhkiG9w0BAQEFAANLADBIAkEAnX0TILJrOMUue%2BPtwBRE6XfV%0AWtKQbsshxk5ZhcUwcwyvcnIq9b82QhJdoACdD34rqfCAIND46fXKQUnb0mvKzQID%0AAQABFhFNb3ppbGxhSXNNeUZyaWVuZDANBgkqhkiG9w0BAQQFAANBAAKv2Eex2n%2FS%0Ar%2F7iJNroWlSzSMtTiQTEB%2BADWHGj9u1xrUrOilq%2Fo2cuQxIfZcNZkYAkWP4DubqW%0Ai0%2F%2FrgBvmco%3D