Restricted Input

Allow restricted character sets in input elements.

Demo

Try the latest version of Restricted Input here.

Features

• Disallow arbitrary chars based on patterns
• Maintains caret position
• Format/Update on paste
• Works in IE9+

Development

Install dependencies

nvm use # if you have node version manager installed
npm i

Watch files and run demo server

npm run development

This will start a server on port 3099 which can be overridden with the PORT env var.

Unit tests

The following command will run the linting task and the unit tests.

npm test

Integration tests

First, sign up for a free open source Sauce Labs account.

Copy the .env.example file to .env

cp .env.example .env

Fill in the SAUCE_USERNAME and SAUCE_ACCESS_KEY environmental variables with your credentials:

SAUCE_USERNAME=your-user-name
SAUCE_ACCESS_KEY=your-access-key

Run the integration tests:

npm run test:integration

This will spin up the demo app, as well as open a sauce connect tunnel to forward the app to sauce labs so that the Capybara integration tests can run.

Usage

import RestrictedInput from 'restricted-input';

const formattedCreditCardInput = new RestrictedInput({
  element: document.querySelector('#credit-card'),
  pattern: '{{9999}} {{9999}} {{9999}} {{9999}}'
});

Patterns

Patterns are a mixture of Placeholders and PermaChars.

Placeholder

A Placeholder is the part of the pattern that accepts user input based on some restrictions. A placeholder is defined in the pattern using two open curly brackets, the placeholder, followed by two closing curly brackets e.g. {{Abc123}}.

The patterns a Placeholder can be are:

• a single alpha character that matches the alpha regex /[A-Za-z]/. e.g. {{C}} will match one alpha character.
• a single digit that matches the digit regex /[0-9]/. e.g. {{3}} will match one digit.
• a * character that matches /./. e.g. {{*}} will match the next character.

PermaChar

A PermaChar is the part of the pattern that is automatically inserted. PermaChars are defined in the pattern as any characters other than Placeholders.

Example patterns

Some example patterns with behavior are listed:

• 12{{3}}
  • Inserts 12.
  • Waits for a single digit from the user.
• {{A}}BC
  • Waits for a single alpha from the user.
  • Inserts BC.
• ${{*2L}}E
  • Inserts $.
  • Waits for any single character input from the user.
  • Waits for a single digit from the user.
  • Waits for a single alpha from the user.
  • Inserts E.

API

options

Browser Support

Desktop

• Chrome (latest)
• Firefox (17+)
• Safari (8+)
• IE11 (desktop/metro)
• IE10 (desktop/metro)
• IE9

Browsers Where Formatting is Turned Off Automatically

Old versions of Samsung Android browsers are incompatible with formatting. These will not attempt to intercept the values and format the input.

TODO

• Improve jsdoc
• Add example guides/pages