angular-countries

Angular module to create selectable country list with country ISO codes and dialing codes.

1. Installation

npm install angular-countries

2. Description

A list of countries for Angular apps.

• fast and easy to integrate module
• country names
• country ISO codes
• country dialing numbers

Country is selectable as you type.

3. JSON Format

Countries are in JSON format.

[
{
"name": "Afghanistan",
"dial_code": "+93",
"code": "AF"
},
{
"name": "Aland Islands",
"dial_code": "+358",
"code": "AX"
},
{
"name": "Albania",
"dial_code": "+355",
"code": "AL"
},
{
"name": "Algeria",
"dial_code": "+213",
"code": "DZ"
},
{
"name": "AmericanSamoa",
"dial_code": "+1684",
"code": "AS"
},
{
"name": "Andorra",
"dial_code": "+376",
"code": "AD"
}
 
 
 
]

4. Angular Directive

Directive is ngcountries and must be applied with INPUT tag:

<input type="text" list="countrylist" class="form-control" ng-model="userDoc.country">
<ngcountries></ngcountries>

Notice: This directive will produce datalist tag.

5. Usage

If you use browserify in your angular project

require('angular-countries');
 
var clientApp = angular.module('clientApp', [
    'ngCountries'
]);

If you use compiled version (/dist/ folder) include it in HTML file

<script src="... /angular-countries/dist/js/ngCountries.js"></script>

6. Complete bootstrap code

Just copy & paste .

<div class="form-group">
    <label for="country" class="col-sm-2 control-label">Country</label>
    <div class="col-sm-2">
        <input type="text" list="countrylist" class="form-control" ng-model="userDoc.country">
        <ngcountries></ngcountries>
    </div>
</div>

7. Get selected country object

In order to get complete country object add ng-controller="ngCountriesCtrl" ng-blur="getCountryObj(userDoc.country, callback) .

<input type="text" list="countrylist" class="form-control" ng-model="userDoc.country" ng-controller="ngCountriesCtrl" ng-blur="getCountryObj(userDoc.country, callback)">

and define collback function inside your controller:

$scope.callback = function (selectedCountryObj) {
  console.log(selectedCountryObj);
};

Returned country object selectedCountryObj will be for example:

{
"name": "Croatia",
"dial_code": "+385",
"code": "HR"
}

Also you can use this callback to get 'dial_code' and put it into 'phone' input tag. So when you select country this 'dial_code' will be inserted into 'phone' field automatically.

//in controller
$scope.callback = function (selectedCountryObj) {
  $scope.userDoc.phone = selectedCountryObj.dial_code;
};


//in HTML file
<input type="text" ng-model="userDoc.phone">

The result is:

8. Licence

Copyright (c) 2016 Saša Mikodanić

Licensed under MIT .