ngx-name-capitalize

Angular pipe for smart capitalization of person names. Handles compound surnames, particles (de, del, la, van, von...), hyphenated names, apostrophes, and Unicode characters.

Built on top of name-capitalize.

Compatibility

ngx-name-capitalize	Angular	Node
1.x	12 – 13	>= 16
2.x	14 – 15	>= 18
3.x	16+	>= 18

Installation

npm install ngx-name-capitalize

Usage

Standalone (Angular 14+)

import { NameCapitalizePipe } from 'ngx-name-capitalize';

@Component({
  standalone: true,
  imports: [NameCapitalizePipe],
  template: `{{ name | namecase }}`
})
export class MyComponent { }

NgModule (Angular 12 – 15)

import { NgxNameCapitalizeModule } from 'ngx-name-capitalize';

@NgModule({
  imports: [NgxNameCapitalizeModule]
})
export class AppModule { }

In your template

{{ 'JUAN DE LA MAZA' | namecase }}
<!-- Output: Juan de la Maza -->

{{ "bernardo o'higgins riquelme" | namecase }}
<!-- Output: Bernardo O'Higgins Riquelme -->

{{ 'jean-pierre dupont' | namecase }}
<!-- Output: Jean-Pierre Dupont -->

In your component

import { NameCapitalizePipe } from 'ngx-name-capitalize';

@Component({
  providers: [NameCapitalizePipe]
})
export class MyComponent {
  constructor(private namecase: NameCapitalizePipe) {}

  format(name: string): string {
    return this.namecase.transform(name);
  }
}

Examples

Input	Output
JUAN DE LA MAZA	Juan de la Maza
ludwig van beethoven	Ludwig van Beethoven
BERNARDO O'HIGGINS	Bernardo O'Higgins
jean-pierre dupont	Jean-Pierre Dupont
gabriel garcía márquez	Gabriel García Márquez
MIGUEL DE CERVANTES Y SAAVEDRA	Miguel de Cervantes y Saavedra
van gogh	Van Gogh

License

MIT © Gabriel Galilea