پایپ ها (|) (Pipes (|))

«پایپ (Pipe)» یعنی فیلترِ نمایش. مقدار را می گیرد و زیبا نمایش می دهد. علامت | بین مقدار و پایپ می آید.

پایپ چیست و چه می کند؟

پایپ مقدار را برای نمایش تبدیل می کند. مثلاً تاریخ را قالب بندی می کند. همچنین می تواند آرگومان بگیرد؛ مثل فرمت یا زبان.

نمونه کوتاه

{{ amount | currency:'USD' }}

مشاهده در ادیتور

نکته: می توانی چند پایپ را زنجیره کنی. خروجیِ اول، ورودیِ دوم می شود.

کی از پایپ ها استفاده کنیم؟

• برای تاریخ، عدد و متنِ تمیز.
• برای تبدیل های ساده و بدون اثر جانبی.
• برای بهبود خوانایی داخل قالب.

نمونه کامل

در این مثال از date، uppercase و percent استفاده می کنیم. یک بار هم زنجیره می زنیم.

import { bootstrapApplication } from '@angular/platform-browser';
import { Component } from '@angular/core';
import { CommonModule } from '@angular/common';

@Component({
  selector: 'app-root',
  standalone: true,
  imports: [CommonModule],
  template: `
    <h3>Built-in pipes</h3>
    <p>Today: {{ today | date:'yyyy-MM-dd' }}</p>
    <p>Name: {{ name | uppercase }}</p>
    <p>Chained: {{ ratio | percent:'1.0-2' | uppercase }}</p>
  `
})
export class App {
  today: Date = new Date();
  name: string = 'Ada Lovelace';
  ratio: number = 0.756;
}

bootstrapApplication(App);

مشاهده در ادیتور

گام های عملی

1. متغیر را در {{ }} بگذار.
2. پس از آن | و نام پایپ بنویس.
3. اگر نیاز داری، آرگومان پایپ را اضافه کن.

نکته ها و هشدارها

نکته: ترتیب در زنجیره مهم است؛ از چپ به راست اجرا می شود.

هشدار: منطقِ پیچیده را داخل کامپوننت نگه دار؛ نه داخل پایپ ها.

پیوندهای مرتبط

همچنین صفحه نام مستعار و بایندینگ ویژگی را ببین تا کنار پایپ ها بهتر کار کنند.

منبع W3Schools · اجرای زنده نمونه

جمع بندی سریع

• پایپ ها نمایش را تمیز می کنند.
• آرگومان هم می گیرند.
• می توانی زنجیره بسازی.
• منطق سنگین را جابه جا کن.