/** * @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 { AfterContentInit, QueryList, TemplateRef, ViewContainerRef } from '@angular/core'; import { NgLocalization } from '../localization'; /** * `ngPlural` is an i18n directive that displays DOM sub-trees that match the switch expression * value, or failing that, DOM sub-trees that match the switch expression's pluralization category. * * To use this directive, you must provide an extension of `NgLocalization` that maps values to * category names. You then define a container element that sets the `[ngPlural]` attribute to a * switch expression. * - Inner elements defined with an `[ngPluralCase]` attribute will display based on their * expression. * - If `[ngPluralCase]` is set to a value starting with `=`, it will only display if the value * matches the switch expression exactly. * - Otherwise, the view will be treated as a "category match", and will only display if exact * value matches aren't found and the value maps to its category using the `getPluralCategory` * function provided. * * ```typescript * class MyLocalization extends NgLocalization { * getPluralCategory(value: any) { * if(value < 5) { * return 'few'; * } * } * } * * @Component({ * selector: 'app', * providers: [{provide: NgLocalization, useClass: MyLocalization}] * }) * @View({ * template: ` *

Value = {{value}}

* * *
* * * * *
* `, * directives: [NgPlural, NgPluralCase] * }) * export class App { * value = 'init'; * * inc() { * this.value = this.value === 'init' ? 0 : this.value + 1; * } * } * * ``` * @experimental */ export declare class NgPluralCase { value: string; constructor(value: string, template: TemplateRef, viewContainer: ViewContainerRef); } /** * @experimental */ export declare class NgPlural implements AfterContentInit { private _localization; private _switchValue; private _activeView; private _caseViews; cases: QueryList; constructor(_localization: NgLocalization); ngPlural: number; ngAfterContentInit(): void; }