angular-telephone-filter

☎️ 🇺🇸 A simple AngularJS filter to clean or format a US telephone number.

📺 Demo

Comments and Pull Requests welcome!

---

Contents

• Installation
• Dependencies
• Usage
• Development

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 [phone]);

Use in HTML:

<p>{{'4045551234' | bcTelephone:'format'}}</p>
<!-- Outputs: <p>[phone]</p> -->
 
<p>{{'[phone]' | bcTelephone:'clean'}}</p>
<!-- Outputs: <p>4045551234</p> -->

Use in a controller

function myController($filter) {
 
  const prettyNumber = '[phone]';
  $filter('bcTelephone')(prettyNumber, 'clean'); // Output: 4045551234
 
  const cleanNumber = '4045551234';
  $filter('bcTelephone')(cleanNumber, 'format'); // Output: [phone]
 
}

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