创建自定义管道
构建可复用的转换管道。
创建自定义管道 是 CoddyKit 上的免费 Angular Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Angular Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Angular Academy 课程共包含 4 节课。
为什么需要自定义管道？
当内置管道无法满足需求时，您可以创建自定义管道，将可复用的转换逻辑封装起来，供模板使用。
@Pipe 装饰器
管道是一个使用 @Pipe 修饰的类。name 属性就是您在模板中使用的名称。
import { Pipe } from "@angular/core";
@Pipe({ name: "exclaim", standalone: true })
export class ExclaimPipe {}实现 PipeTransform
管道类会实现 PipeTransform 接口，该接口要求提供一个 transform 方法。
import { Pipe, PipeTransform } from "@angular/core";
@Pipe({ name: "exclaim", standalone: true })
export class ExclaimPipe implements PipeTransform {
transform(value: string): string {
return value + "!";
}
}transform 方法
transform 的第一个参数是传入管道的值。无论您返回什么，都会成为渲染后的输出。
transform(value: string): string {
return value.trim();
}使用您的管道
将管道导入独立组件，然后像使用内置管道一样，在模板中使用它的名称。
@Component({
selector: "app-demo",
standalone: true,
imports: [ExclaimPipe],
template: "<p>{{ 'hi' | exclaim }}</p>"
})
export class DemoComponent {}
// renders: hi!接受参数
value 后的额外参数会成为管道参数。调用方通过冒号传递这些参数。
@Pipe({ name: "repeat", standalone: true })
export class RepeatPipe implements PipeTransform {
transform(value: string, times: number): string {
return value.repeat(times);
}
}
// {{ "ab" | repeat:3 }} -> ababab参数的默认值
为参数提供默认值，这样调用方就可以省略它们。这能让您的管道更加灵活。
transform(value: string, times: number = 2): string {
return value.repeat(times);
}
// {{ "ab" | repeat }} -> abab处理 null 和 undefined
请始终防范缺失的输入。当值为 null 或 undefined 时，返回合理的备用结果。
transform(value: string | null): string {
if (value == null) return "";
return value.toUpperCase();
}截断管道示例
下面是一个实用的管道示例，它会缩短过长的文本并追加省略号。
@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;
}
}标注返回值类型
标注返回类型，让 TypeScript 和模板保持类型安全。管道可以返回任意类型，而不只是字符串。
@Pipe({ name: "double", standalone: true })
export class DoublePipe implements PipeTransform {
transform(value: number): number {
return value * 2;
}
}在模块中注册（NgModule）
如果您使用 NgModules 而不是独立组件，请在 declarations 中声明管道，并根据需要将其导出。
@NgModule({
declarations: [TruncatePipe],
exports: [TruncatePipe]
})
export class SharedModule {}快速检查
检查您对自定义管道的理解。
回顾
您使用 @Pipe 和 PipeTransform 构建了自定义管道，使用默认值接受参数，防范 null，并在独立组件或 NgModules 中注册了它。
接下来，您将学习纯管道和非纯管道的区别。
常见问题解答
「创建自定义管道」课时是免费的吗？
是的 — 「创建自定义管道」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Angular Academy 课程的其余内容，请升级到 CoddyKit PRO。 Angular Academy 课程共包含 4 节课。
「创建自定义管道」这节课中我会学到什么？
构建可复用的转换管道。 你通过在浏览器中直接运行的动手代码来练习 Angular Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Angular Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Angular Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「创建自定义管道」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Angular Academy 课中编写并运行代码吗？
能。每节 Angular Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。