PlusAsTab javascript library
A jQuery plugin to use the numpad plus key as a tab key equivalent.
With PlusAsTab, elements can be marked as plussable, allowing the user to use the + on the numeric keypad (numpad or tenkey for short) to navigate page. For numeric input it is closer than the tab key and therefor increases input speed and allows for one-handed entry in multiple fields.
- The normal tab key is unaffected and works as usual.
- Plussable fields that may need to have the plus character entered into them can still use the + key on the typewriter keys.
- Laptops may not have physical numpads, but instead it is emulated with the Fn key (or similar). PlusAsTab is not targeted at laptop users. It is possible to use an external/separate USB numpads though.
To include dependencies, make sure to get the submodules too.
git clone --recursive git://github.com/joelpurra/plusastab.git
example/demo.html: Simple demo for playing around.example/enter-as-tab.html: Setting the options to listen to the enter/↵ key instead.
<!-- Can be applied to plussable elements one by one -->
<input type="text" data-plus-as-tab="true" />
<textarea data-plus-as-tab="true"></textarea>
<a href="http://joelpurra.se/" data-plus-as-tab="true">Joel Purra</a>
<input type="button" value="This button has not been enabled for plussing" />
<!-- Can be applied using a class name -->
<input type="text" value="" class="plus-as-tab" />
<!-- Can be applied to all plussable elements within a container -->
<ol data-plus-as-tab="true">
<li><input type="checkbox" /> Checkbox, plussable</li>
<li><input type="checkbox" /> Another checkbox, plussable</li>
<!-- Can be explicitly exluded from plussing -->
<li><input type="checkbox" data-plus-as-tab="false" /> Checkbox, plussing disabled</li>
<li><input type="checkbox" class="disable-plus-as-tab" /> Another checkbox, plussing disabled</li>
</ol>// Apply plus as tab to the selected elements/containers
$(selector).plusAsTab();
// Exclude plus as tab to the selected elements/containers
$(selector).plusAsTab(false);
// Equivalent static function
JoelPurra.PlusOnTab.plusAsTab($(selector));
JoelPurra.PlusOnTab.plusAsTab($(selector), false);
// Change the "tab" key from "numpad +" to something else
JoelPurra.PlusAsTab.setOptions({
// Use enter instead of plus
// Number 13 found through demo at
// http://api.jquery.com/event.which/
key: 13
});PlusAsTab should be able to intercept most keys, since it listens to the keydown event. To change the key, use JoelPurra.PlusAsTab.setOptions({key: YOUR_KEY});, where YOUR_KEY is a number that you can find by using the jQuery event.which demo.
Elements that can be focused/tabbed include <input>, <select>, <textarea>, <button> and <a href="..."> (the href attribute must exist and the tag must have some contents). These are also the elements that can be plussable.
Note that <input type="hidden" />, <a> (without href or empty contents), disabled="disabled" or display: none; elements cannot be focused.
Static plussable html elements can have, or be contained within elements that have, the attribute data-plus-as-tab="true" or the class .plus-as-tab. They are enabled automatically when the library has been loaded/executed.
Dynamic elements are initialized to PlusAsTab in code after adding them to the DOM; $("#my-optional-input").plusAsTab(). This is not necessary if the added element already is contained within an element that is marked for plussing. You can also call .plusAsTab() on containers.
When PlusAsTab is applied to html containers, like <div>, <ul> or <fieldset>, all plussable child elements are implicitly plussable. This applies to static html and subsequently added child elements.
Plussable elements, or containers with plussable children, marked with class .disable-plus-as-tab or attribute data-plus-as-tab="false" never have plussing enabled. Disabling can also be done dynamically on elements/containers with $(selector).plusAsTab(false). If plussing is disabled for the element when it receives focus, or any of its elements parents, it will not be tabbed. Disabling plussing takes precedence over enabling plussing.
Developed to increase the speed and usability when entering numbers in consecutive fields in a web application for registering and administering letters. Examples of plussed fields are consecutive date, zip code and quantity fields. Any other text fields, dropdowns with sensible defaults and secondary buttons were also set as plussable to maximize the flow.
PlusAsTab's runtime dependencies are
- jQuery
- EmulateTab, one of PlusAsTab's sister projects.
Should be about as compatible as jQuery is, since most functions depend on jQuery's normalization. You are engouraged to run the PlusAsTab test suite and then report any issues.
- Write tests for
.setOptions(...). - Break out reusable key press functions from tests.
- Implement a "real world" demo.
PlusAsTab's sister projects.
- SkipOnTab - speed up form filling by skipping some fields in the forward tab order.
- EmulateTab - the tab emulator used by both SkipOnTab and PlusAsTab.
Developed for PTS by Joel Purra http://joelpurra.se/
Copyright (c) 2011, 2012, The Swedish Post and Telecom Authority (PTS) All rights reserved.
Released under the BSD license.