Angular Academy · Lektion

Benutzerdefinierte Pipes erstellen

Erstellen Sie wiederverwendbare Transformations-Pipes.

Benutzerdefinierte Pipes erstellen ist eine kostenlose Angular Academy-Lektion auf CoddyKit. Dies ist Lektion 3 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.

Warum benutzerdefinierte Pipes?

Wenn integrierte Pipes nicht ausreichen, können Sie eine benutzerdefinierte Pipe erstellen, um wiederverwendbare Transformationslogik für Ihre Templates zu kapseln.

Der @Pipe-Dekorator

Eine Pipe ist eine mit @Pipe dekorierte Klasse. Die Eigenschaft name ist der Name, den Sie in Templates verwenden.

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

@Pipe({ name: "exclaim", standalone: true })
export class ExclaimPipe {}

PipeTransform implementieren

Eine Pipe-Klasse implementiert das Interface PipeTransform, das eine einzelne Methode transform voraussetzt.

import { Pipe, PipeTransform } from "@angular/core";

@Pipe({ name: "exclaim", standalone: true })
export class ExclaimPipe implements PipeTransform {
  transform(value: string): string {
    return value + "!";
  }
}

Die Methode transform

Der erste Parameter von transform ist der Wert, der durch die Pipe verarbeitet wird. Der zurückgegebene Wert wird als Ausgabe dargestellt.

transform(value: string): string {
  return value.trim();
}

Ihre Pipe verwenden

Importieren Sie die Pipe in eine Standalone-Komponente und verwenden Sie ihren Namen anschließend im Template genauso wie den einer integrierten Pipe.

@Component({
  selector: "app-demo",
  standalone: true,
  imports: [ExclaimPipe],
  template: "<p>{{ 'hi' | exclaim }}</p>"
})
export class DemoComponent {}
// renders: hi!

Argumente akzeptieren

Zusätzliche Parameter nach value werden zu Pipe-Argumenten. Aufrufer übergeben sie mit Doppelpunkten.

@Pipe({ name: "repeat", standalone: true })
export class RepeatPipe implements PipeTransform {
  transform(value: string, times: number): string {
    return value.repeat(times);
  }
}
// {{ "ab" | repeat:3 }} -> ababab

Standardwerte für Argumente

Vergeben Sie Standardwerte für Argumente, damit Aufrufer sie weglassen können. Dadurch bleibt Ihre Pipe flexibel.

transform(value: string, times: number = 2): string {
  return value.repeat(times);
}
// {{ "ab" | repeat }} -> abab

Null und Undefined verarbeiten

Prüfen Sie fehlende Eingaben immer ab. Geben Sie einen sinnvollen Ersatzwert zurück, wenn der Wert null oder undefined ist.

transform(value: string | null): string {
  if (value == null) return "";
  return value.toUpperCase();
}

Beispiel für eine Truncate-Pipe

Hier sehen Sie eine praktische Pipe, die langen Text kürzt und eine Ellipse anhängt.

@Pipe({ name: "truncate", standalone: true })
export class TruncatePipe implements PipeTransform {
  transform(value: string, limit: number = 20): string {
    if (!value) return "";
    return value.length > limit
      ? value.slice(0, limit) + "..."
      : value;
  }
}

Rückgabewert typisieren

Geben Sie den Rückgabetyp an, damit TypeScript und Ihre Templates typsicher bleiben. Eine Pipe kann jeden Typ zurückgeben, nicht nur Zeichenfolgen.

@Pipe({ name: "double", standalone: true })
export class DoublePipe implements PipeTransform {
  transform(value: number): number {
    return value * 2;
  }
}

In einem Modul registrieren (NgModule)

Wenn Sie anstelle von Standalone-Komponenten NgModules verwenden, deklarieren Sie die Pipe in declarations und exportieren Sie sie bei Bedarf.

@NgModule({
  declarations: [TruncatePipe],
  exports: [TruncatePipe]
})
export class SharedModule {}

Kurze Wissensprüfung

Testen Sie Ihr Verständnis von benutzerdefinierten Pipes.

Zusammenfassung

Sie haben eine benutzerdefinierte Pipe mit @Pipe und PipeTransform erstellt, Argumente mit Standardwerten akzeptiert, null abgefangen und die Pipe in Standalone-Komponenten oder NgModules registriert.

Als Nächstes lernen Sie den Unterschied zwischen reinen und unreinen Pipes kennen.

Häufig gestellte Fragen

Ist die Lektion „Benutzerdefinierte Pipes erstellen“ kostenlos?

Ja — der vollständige Text von „Benutzerdefinierte Pipes erstellen“ 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 „Benutzerdefinierte Pipes erstellen“?

Erstellen Sie wiederverwendbare Transformations-Pipes. 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 3 von 4.

Wie lange dauert die Lektion „Benutzerdefinierte Pipes erstellen“?

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