On this page
QueryList
class
An unmodifiable list of items that Angular keeps up to date when the state of the application changes.
class QueryList<T> {
  dirty: true
  changes: Observable<any>
  length: number
  first: T
  last: T
  map<U>(fn: (item: T, index: number, array: T[]) => U): U[]
  filter(fn: (item: T, index: number, array: T[]) => boolean): T[]
  find(fn: (item: T, index: number, array: T[]) => boolean): T | undefined
  reduce<U>(fn: (prevValue: U, curValue: T, curIndex: number, array: T[]) => U, init: U): U
  forEach(fn: (item: T, index: number, array: T[]) => void): void
  some(fn: (value: T, index: number, array: T[]) => boolean): boolean
  toArray(): T[]
  toString(): string
  reset(res: Array<T | any[]>): void
  notifyOnChanges(): void
  setDirty()
  destroy(): void
}
   Description
The type of object that ViewChildren, ContentChildren, and QueryList provide.
Implements an iterable interface, therefore it can be used in both ES6 javascript for (var i of items) loops as well as in Angular templates with *ngFor="let i of myList".
Changes can be observed by subscribing to the changes Observable.
NOTE: In the future this class will implement an Observable interface.
Properties
| Property | Description | 
|---|---|
dirty: true | 
       Read-only. | 
changes: Observable<any> | 
       Read-only. | 
length: number | 
       Read-only. | 
first: T | 
       Read-only. | 
last: T | 
       Read-only. | 
Methods
| 
         
          map() 
          | 
      ||
|---|---|---|
See Array.map  | 
      ||
  | 
      
| fn | Type:   | 
          
Returns
U[]
| 
         
          filter() 
          | 
      ||
|---|---|---|
See Array.filter  | 
      ||
  | 
      
| fn | Type:   | 
          
Returns
T[]
| 
         
          find() 
          | 
      ||
|---|---|---|
See Array.find  | 
      ||
  | 
      
| fn | Type:   | 
          
Returns
T | undefined
| 
         
          reduce() 
          | 
      ||||
|---|---|---|---|---|
See Array.reduce  | 
      ||||
  | 
      
| fn | Type:   | 
          
| init | Type:   | 
          
Returns
U
| 
         
          forEach() 
          | 
      ||
|---|---|---|
See Array.forEach  | 
      ||
  | 
      
| fn | Type:   | 
          
Returns
void
| 
         
          some() 
          | 
      ||
|---|---|---|
See Array.some  | 
      ||
  | 
      
| fn | Type:   | 
          
Returns
boolean
| 
         
          toArray() 
          | 
      
|---|
  | 
      
| 
         
          toString() 
          | 
      
|---|
  | 
      
| 
         
          reset() 
          | 
      ||
|---|---|---|
  | 
      
| res | Type:   | 
          
Returns
void
| 
         
          notifyOnChanges() 
          | 
      
|---|
  | 
      
| 
         
          setDirty() 
          | 
      
|---|
internal  | 
      
  | 
      
| 
         
          destroy() 
          | 
      
|---|
internal  | 
      
  | 
      
Usage notes
Example
@Component({...})
class Container {
  @ViewChildren(Item) items:QueryList<Item>;
}
  © 2010–2019 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
 https://v6.angular.io/api/core/QueryList