Angular Academy · Lektion

View-Abfragen mit viewChild

Fragen Sie untergeordnete Elemente als Signals ab.

View-Abfragen mit viewChild ist eine kostenlose Angular Academy-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Angular Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Angular Academy-Kurs umfasst insgesamt 4 Lektionen.

Die View abfragen

Komponenten benötigen häufig eine Referenz auf ein Element oder eine untergeordnete Komponente in ihrem Template. Modernes Angular stellt dafür die signalbasierte Abfragefunktion viewChild() bereit.

viewChild deklarieren

Rufen Sie viewChild() mit einem Template-Referenznamen oder einem Komponententyp auf. Das Ergebnis ist ein Signal.

import { Component, viewChild, ElementRef } from "@angular/core";

@Component({
  selector: "app-form",
  template: "<input #box>"
})
export class FormComponent {
  box = viewChild<ElementRef>("box");
}

Die Abfrage lesen

Wie alle Signale lesen Sie eine View-Abfrage, indem Sie sie aufrufen. Sie gibt das passende Element oder undefined zurück, bis die View bereit ist.

focus() {
  this.box()?.nativeElement.focus();
}

Eine untergeordnete Komponente abfragen

Übergeben Sie eine Komponentenklasse, um eine typisierte Referenz auf die Instanz einer untergeordneten Komponente zu erhalten.

import { viewChild } from "@angular/core";

child = viewChild(ChildComponent);

run() {
  this.child()?.doSomething();
}

Erforderliche View-Abfragen

Verwenden Sie viewChild.required(), wenn das abgefragte Element vorhanden sein muss. Das Signal ist dann nicht nullbar.

box = viewChild.required<ElementRef>("box");

focus() {
  this.box().nativeElement.focus(); // no optional chaining
}

Mehrere Elemente abfragen

viewChildren() gibt ein Signal zurück, das ein schreibgeschütztes Array aller Treffer enthält.

import { viewChildren } from "@angular/core";

items = viewChildren(ItemComponent);

count() {
  return this.items().length;
}

Wann Abfragen aufgelöst werden

Signalbasierte View-Abfragen werden aufgelöst, nachdem die View initialisiert wurde. Wenn Sie sie in einem effect lesen, stellen Sie sicher, dass Sie erst handeln, sobald sie verfügbar sind.

constructor() {
  effect(() => {
    const el = this.box();
    if (el) el.nativeElement.focus();
  });
}

viewChild im Vergleich zum ViewChild-Dekorator

Das Signal viewChild() ersetzt den klassischen @ViewChild-Dekorator, integriert sich in Signals und macht in vielen Fällen eine manuelle Abstimmung mit dem Lebenszyklus überflüssig.

// classic:
@ViewChild("box") box!: ElementRef;

// modern:
box = viewChild<ElementRef>("box");

Ein bestimmtes Token lesen

Mit der Option read können Sie ein anderes Token des gefundenen Elements abfragen, etwa eine Direktive oder ElementRef.

tooltip = viewChild("trigger", { read: TooltipDirective });

contentChild für Projektion

Für projizierte Inhalte statt für die eigene View der Komponente verwenden Sie die entsprechenden Abfragen contentChild() und contentChildren().

import { contentChild } from "@angular/core";

header = contentChild(HeaderComponent);

Die passende Abfrage auswählen

Verwenden Sie View-Abfragen für Ihr eigenes Template und Content-Abfragen für projizierte Inhalte. Wählen Sie die erforderliche Variante, wenn das Ziel vorhanden sein muss, und die Pluralvariante für Sammlungen.

Kurzer Test

Testen Sie Ihr Verständnis signalbasierter View-Abfragen.

Zusammenfassung

Das Signal viewChild() fragt Elemente und untergeordnete Komponenten in einer Komponenten-View ab. Verwenden Sie viewChild.required() für garantiert vorhandene Ziele, viewChildren() für Sammlungen, die Option read für bestimmte Tokens und contentChild() für projizierte Inhalte.

Häufig gestellte Fragen

Ist die Lektion „View-Abfragen mit viewChild“ kostenlos?

Ja — der vollständige Text von „View-Abfragen mit viewChild“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Angular Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Angular Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „View-Abfragen mit viewChild“?

Fragen Sie untergeordnete Elemente als Signals ab. Du übst Angular Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Angular Academy zu starten?

Keine Vorkenntnisse erforderlich. Angular Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.

Wie lange dauert die Lektion „View-Abfragen mit viewChild“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Angular Academy-Lektion Code schreiben und ausführen?

Ja. Jede Angular Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu Angular Academy