@angular/common

KeyValuePipe

pipe

Transforms Object or Map into an array of key value pairs.

  
    class KeyValuePipe implements PipeTransform {
}

Transforms Object or Map into an array of key value pairs.

The output array will be ordered by keys. By default the comparator will be by Unicode point value. You can optionally pass a compareFn if your keys are complex types.

Examples

This examples show how an Object or a Map can be iterated by ngFor with the use of this keyvalue pipe.

transform

7 overloads

@paraminputReadonlyMap<K, V>

@paramcompareFn(a: KeyValue<K, V>, b: KeyValue<K, V>) => number

@returnsKeyValue<K, V>[]

@paraminputRecord<K, V>

@paramcompareFn(a: KeyValue<string, V>, b: KeyValue<string, V>) => number

@returnsKeyValue<string, V>[]

@paraminputRecord<K, V> | ReadonlyMap<K, V>

@paramcompareFn(a: KeyValue<K, V>, b: KeyValue<K, V>) => number

@returnsKeyValue<K, V>[]

@paraminputnull

@paramcompareFn(a: KeyValue<unknown, unknown>, b: KeyValue<unknown, unknown>) => number

@returnsnull

@paraminputReadonlyMap<K, V>

@paramcompareFn(a: KeyValue<K, V>, b: KeyValue<K, V>) => number

@returnsKeyValue<K, V>[]

@paraminputRecord<K, V>

@paramcompareFn(a: KeyValue<string, V>, b: KeyValue<string, V>) => number

@returnsKeyValue<string, V>[]

@paraminputRecord<K, V> | ReadonlyMap<K, V>

@paramcompareFn(a: KeyValue<K, V>, b: KeyValue<K, V>) => number

@returnsKeyValue<K, V>[]