mirror of
https://github.com/angular/angular
synced 2026-05-24 09:28:37 +00:00
dd03bf12e1
docs(common_module): Fix macro format docs(number_pipe): Add missing period sign docs(date_pipe): Fix suffix consistency docs(date_pipe): Fix missing quote docs(number_pipe): Fix incorrect article Looks like the word "Polyfill" does not start with a vowel pronunciation. docs(location_strategy): Fix code format Add missing \`\`\` at start. docs(i18n_plural_pipe): Fix code format docs(location): Add missing period sign refactor(ngSwitch): fix typo on parameter docs(di): Add missing quote docs(compiler): Fix typo docs(compiler): Add missing period sign docs(directives): Fix description for styles parameter docs(location_strategy): Add code language Revert for misunderstanding.
68 lines
1.9 KiB
TypeScript
68 lines
1.9 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google Inc. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import {Pipe, PipeTransform} from '@angular/core';
|
|
import {StringWrapper, isBlank, isStringMap} from '../facade/lang';
|
|
import {NgLocalization, getPluralCategory} from '../localization';
|
|
import {InvalidPipeArgumentError} from './invalid_pipe_argument_error';
|
|
|
|
const _INTERPOLATION_REGEXP: RegExp = /#/g;
|
|
|
|
/**
|
|
* Maps a value to a string that pluralizes the value properly.
|
|
*
|
|
* ## Usage
|
|
*
|
|
* expression | i18nPlural:mapping
|
|
*
|
|
* where `expression` is a number and `mapping` is an object that mimics the ICU format,
|
|
* see http://userguide.icu-project.org/formatparse/messages
|
|
*
|
|
* ## Example
|
|
*
|
|
* ```
|
|
* @Component({
|
|
* selector: 'app',
|
|
* template: `
|
|
* <div>
|
|
* {{ messages.length | i18nPlural: messageMapping }}
|
|
* </div>
|
|
* `,
|
|
* // best practice is to define the locale at the application level
|
|
* providers: [{provide: LOCALE_ID, useValue: 'en_US'}]
|
|
* })
|
|
*
|
|
* class MyApp {
|
|
* messages: any[];
|
|
* messageMapping: {[k:string]: string} = {
|
|
* '=0': 'No messages.',
|
|
* '=1': 'One message.',
|
|
* 'other': '# messages.'
|
|
* }
|
|
* ...
|
|
* }
|
|
* ```
|
|
*
|
|
* @experimental
|
|
*/
|
|
@Pipe({name: 'i18nPlural', pure: true})
|
|
export class I18nPluralPipe implements PipeTransform {
|
|
constructor(private _localization: NgLocalization) {}
|
|
|
|
transform(value: number, pluralMap: {[count: string]: string}): string {
|
|
if (isBlank(value)) return '';
|
|
|
|
if (!isStringMap(pluralMap)) {
|
|
throw new InvalidPipeArgumentError(I18nPluralPipe, pluralMap);
|
|
}
|
|
|
|
const key = getPluralCategory(value, Object.keys(pluralMap), this._localization);
|
|
|
|
return StringWrapper.replaceAll(pluralMap[key], _INTERPOLATION_REGEXP, value.toString());
|
|
}
|
|
}
|