nativescript-maskedinput
by bthurlow | v0.0.3
A {N} masked input plugin for iOS and Android
npm i --save nativescript-maskedinput

A {N} Masked Input Plugin

License npm npm GitHub release

This plugin extends the {N} TextView to allow for input masking.

Notes

iOS 7+

Android API 17+

Plugin does not support the use of the keyboardType property from TextView.

Plugin will attempt to determine the mask type and display the appropriate keyboardType automatically.

Installation

Run tns plugin add nativescript-maskedinput

Usage

To use MaskedInput you need to include it in your XML.

Add the following to your page directive.

xmlns:mi="nativescript-maskedinput"

Use MaskedInput by adding the following XML.

<mi:MaskedInput mask="1-999-999-9999? x999" hint="1-555-555-5555" placeholder="#" />

Properties

mask [string]

Get or Set the mask used for input

mask options

  • 9 is the same as RegEx [0-9]
  • a is the same as RegEx [A-Za-z]
  • * is the same as RegEx [A-Za-z0-9]
  • ? specifies that anything after the ? is optional.
Supported Seperators
  • |
  • /
  • \
  • .
  • $
  • ( )
  • [ ]
  • { }

valid [boolean]

Returns true or false if the input text matches the mask.

Use the FormattedText property or the text property to validate the input.

placeholder [string]

Gets or Sets the placeholder.

Default: _

RawText [string]

Gets only the text that matches the RegEx pattern from the mask.

You cannot validate the RawText property. It will fail.

FormattedText [string]

Gets the Full text including any seperators as specified in the mask.

regEx [string]

Gets the regex that was created from the mask so that you can perform your own validation.