Skip to content

A specification describing enterkeyhint to label the action key on virtual keyboards

License

Notifications You must be signed in to change notification settings

dtapuska/enterkeyhint

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Explainer

Mobile platforms (Android and iOS) have the ability for native applications to customize the virtual keyboard displayed to the user. The web does not have this ability. The web has a defined set of input modes that the type of keyboard will be presented. While customizing the type of keyboard is important for optimizing the user's experience, even more customization with respect to the enter key is needed.

The enter key on a virtual keyboard represents what the user should do next, whether it is search, sending the content, inserting a new line, etc. These types of actions are customizable from the iOS and Android native APIs. The goal is to surface these actions to the web and allow the web application to fully control the user's experience with the virtual keyboard.

HTML Spec

Mozilla pioneered this by first shipping the mozactionhint in Firefox. To ship this in an interoperable approach Chrome standardized this in HTML spec as enterkeyhint.

Examples

With no ability to customize the action key the user will generally see this:

<input>

Enter

But with the additional keyword the developer can have a richer experience with the keyboard:

<input enterkeyhint="enter">

Enter

<input enterkeyhint="go">

Enter

<input enterkeyhint="done">

Enter

<input enterkeyhint="next">

Enter

<input enterkeyhint="previous">

Enter

<input enterkeyhint="search">

Enter

<input enterkeyhint="send">

Enter

Considered alternatives

It was always clear that an additional attribute would be needed for this behaviour. See the HTML Pull Request for discussion on additional names such as "inputmode-action", "inputaction", "enterkeylabel", "returnaction", "returnkeylabel", "actionlabel", enterlabel" and "keylabel". Through concensus of browser vendors we agreed on the "enterkeyhint" naming.

About

A specification describing enterkeyhint to label the action key on virtual keyboards

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages