README.md

ngx-i18n-country-select

Angular wrapper for i18n-iso-countries.

Major Todos: Fix testcases & documentation

Installation

npm install i18n-iso-countries --save
npm install ngx-i18n-country-select --save

Integration

// app.module.ts
import { NgModule, LOCALE_ID, APP_INITIALIZER } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { I18nCountrySelectModule, I18nCountrySelectService } from 'ngx-i18n-country-select';

export function setUpI18nCountrySelect(service: I18nCountrySelectService) {
  return () => service.use(['de', 'en']);
}

@NgModule({
  declarations: [AppComponent],
  imports: [BrowserModule, I18nCountrySelectModule.forRoot()],
  providers: [
    { provide: LOCALE_ID, useValue: 'de-DE' },
    I18nCountrySelectService,
    {
      provide: APP_INITIALIZER,
      useFactory: setUpI18nCountrySelect,
      deps: [I18nCountrySelectService],
      multi: true
    }
  ],
  bootstrap: [AppComponent]
})
export class AppModule {}

// app.component.ts
import { Component } from '@angular/core';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html'
})
export class AppComponent {
  item = {
    isocode: 'de'
  };
}

<i18n-country-select [(iso3166Alpha2)]="item.isocode" size="sm"></i18n-country-select>

Documentation

Demo on stackblitz

attribute	type	description
iso3166Alpha2	Object	model as ISO 3166-1 Alpha2
size	string	'sm', 'lg'. default: nothing.
pleaseChoose	string	default option label. default: 'Please choose...'.
mandatory	boolean	make select required. default: false
editable	boolean	enable or disable select. default: true

Release History

• v2.2.6
  • angular v15, still missing documentation & tests
• v2.2.2
  • renamed default branch to main
• v2.2.1
  • update @angular/cli, @angular/core to v13. i18n-iso-countries to v7
• v2.1.0
  • update @angular/cli, @angular/core to v8. i18n-iso-countries to v4
• v2.0.2
  • add new option mandatory to set required attribute
• v2.0.0
  • switchted to @angular/cli and ng-packagr, requires @angular/core v7 and i18n-iso-countries v3.7

Rename local master branch to main

git branch -m master main
git fetch origin
git branch -u origin/main main

LICENCE

MIT © Oliver Sahner