angular-telephone-filter

A simple filter to format of clean a US phone number.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
angular-telephone-filter
701.0.28 years ago8 years agoMinified + gzip package size for angular-telephone-filter in KB

Readme

angular-telephone-filter
:phone: 🇺🇸 A simple AngularJS filter to clean or format a US telephone number.
!MIT Licenselicenseimagelicenseurl !NPM versionnpmversionimagenpmurl
:tv: Demodemos

Comments and Pull Requests welcome!issues

Contents

Installation

NPM

$ npm install angular-telephone-filter --save

Bower

$ bower install angular-telephone-filter --save

Or, include the JavaScript file in the head of your document:
<script src="/path/to/file/angular-telephone-filter.js"></script>

Include the module as a dependency of your application:
angular.module('myModule', ['bc.TelephoneFilter']);

Dependencies

  • Angular.js (^1.4.0)

Usage

The filter expects a single parameter to be passed in to control the filter direction. A parameter of clean will return only the numbers (ie 1235551234) while the format parameter will direct the filter to output the formatted number (ie (123) 555-1234);

Use in HTML:

<p>{{'4045551234' | bcTelephone:'format'}}</p>
<!-- Outputs: <p>(404) 555-1234</p> -->

<p>{{'(404) 555-1234' | bcTelephone:'clean'}}</p>
<!-- Outputs: <p>4045551234</p> -->

Use in a controller

function myController($filter) {

  const prettyNumber = '(404) 555-1234';
  $filter('bcTelephone')(prettyNumber, 'clean'); // Output: 4045551234

  const cleanNumber = '4045551234';
  $filter('bcTelephone')(cleanNumber, 'format'); // Output: (404) 555-1234

}

Development

  • npm run build - produces production version of your library under the dist folder
  • npm run dev - produces development version of your library under the dist folder and runs a
watcher