آموزش Angular 2

آموزش Angular 2 – کار با Metadata

توضیح

Metadata، روشی برای پردازش کلاس هستش. در نظر داشته باشین که یک مؤلفه به نامِ MyComponent داریم که تا زمانی که به Angular بگیم که این یک مؤلفه ست، بعنوان کلاس در نظر گرفته میشه. می توانید از metadata در کلاس استفاده کنین تا به Angular بگین که MyComponent یک مؤلفه ست. metadata با استفاده از decorator به TypeScript متصل میشه.

مثال

مثال زیر طرز کار metadata در Angular 2 را شرح میده:

<!DOCTYPE html>
<html>
   <head>
      <title>Angular 2 Metadata</title>
      <script src="https://cdnjs.cloudflare.com/ajax/libs/es6-shim/0.33.3/es6-shim.min.js"></script>
      <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.20/system-polyfills.js"></script>
      <script src="https://code.angularjs.org/2.0.0-beta.6/angular2-polyfills.js"></script>
      <script src="https://code.angularjs.org/tools/system.js"></script>
      <script src="https://code.angularjs.org/tools/typescript.js"></script>
      <script src="https://code.angularjs.org/2.0.0-beta.6/Rx.js"></script>
      <script src="https://code.angularjs.org/2.0.0-beta.6/angular2.dev.js"></script>
      <script>
         System.config({
           transpiler: 'typescript',
           typescriptOptions: { emitDecoratorMetadata: true },
           packages: {'app': {defaultExtension: 'ts'}},
           map: { 'app': './angular2/src/app' }
         });
         System.import('app/metadata_main')
            .then(null, console.error.bind(console));
      </script>
   </head>
   <body>
      <my-app>Loading...</my-app>
   </body>
</html>

کد بالا شامل آپشن های پیکربندی زیرِه:

  • می توانید با استفاده از نسخه ی typescript، فایلِ index.html را پیکربندی کنین. SystemJS، قبل از اجرای برنامه، توسطِ آپشنِ transpiler، TypeScript را به جاوا اسکریپت ترجمه می کنه.
  •  اگه قبل از اجرای برنامه transpile را به جاوا اسکریپت ترجمه نکنین، اخطارها و خطاهای کامپایلر را که در مرورگر نهفته اند، مشاهده خواهید کرد.
  • زمانی که آپشنِ emitDecoratorMetadata، تنظیم میشه، TypeScript برای همه ی کلاس هایِ کد، metadata تولید می کنه. اگه این گزینه را تعیین نکنین، حجم زیادی metadataیِ بی استفاده، تولید میشه که بر اندازه فایل و فشرده سازیِ اپلیکیشن در زمان اجرای برنامه تأثیر میذاره.
  •  angular 2، مشمولِ (incudes) فایل های با پسوندِ .ts در پوشه ی app میشه.
  •  سپس angular 2، فایل مؤلفه ی اصلی را از پوشه ی app، بارگذاری می کنه. اگه فایل مؤلفه ی اصلی را پیدا نکنه، در کنسول، پیغام خطا نمایش میده.
  • وقتی Angular، در main.ts، تابعِ bootstrap را فراخوانی می کنه، این تابع مؤلفه های metadata را می خواند، سِلِکتورهای (selecrors) ‘app’ را پیدا می کنه، عنصرِ تگی به نام app را مستقر می کنه، و برنامه را میان این تگ ها بارگذاری می کنه.

برای اجرای کد، باید فایل typeScript (.ts) را در پوشه ی app ذخیره کنین.

metadata_main.ts

import {bootstrap} from "angular2/platform/browser"    //importing bootstrap function
import {MyTemplate} from "./metadata_app.component"    //importing component function

bootstrap(MyTemplate);

اکنون یک مؤلفه در فایلِ TypeScript (.ts) ایجاد می کنیم.

metadata_app.component.ts

import {Component} from "angular2/core";
import {ItemComponent} from './item-list.component';

@Component({
    selector: 'my-app',
    template: `<my-list></my-list>`,
    directives:[ItemComponent]
})
export class MyTemplate {}
  •  Component یک decorator است که برای ایجاد مؤلفه، از شیءِ configuration استفاده می کنه.
  •  selector، نمونه ای از مؤلفه ای را ایجاد می کنه که آن را در تگِ <my-app> از HTML پدر، پیدا کرده.
  •  دستورِ decorator، برای نمایشِ آرایه ای از مؤلفه ها (components) یا دستورات (directives) استفاده میشه.

فایلِ TypeScript (.ts) زیر، لیستی از آیتم ها را در خروجی نشان میده.

item-list.component.ts

import {Component} from "angular2/core";

@Component({
   selector:'my-list',
   template:`<h2>List of Fruits</h2>
   <ul>
      <li *ngFor="#myItem of itemList">{{myItem.name}}</li>
   </ul>
   `
})
export class ItemComponent{
   public itemList = [
      {name:"Apple"},
      {name:"Orange"},
      {name:"Grapes"},
   ];
}
  •  template نحوه ی نمایش مؤلفه را به Angular میگه.
  •  دستورِ *ngFor برای انداختن لیستِ آتم هایِ آرایه ای از شیءِ itemList، در حلقه (loop) به کار میره.

خروجی

بیاین مراحل زیر را برای دیدن طرز کار کدهای بالا انجام بدیم:

  •  فایلِ index.html را همان طور که در بخشِ محیط (enviroment) انجام دادیم، در پوشه ی app که حاوی فایل های .ts است، ذخیره کنین.
  •  پنجره ی ترمینال را باز کنین و دستورات زیر را وارد کنین:
npm start
  •  بعد از چند لحظه، باید زبانه ای (tab) در مرورگر باز بشه و بصورت زیر خروجی را نشان بده.

یا می توانید به روش دیگه ای این فایل را اجرا کنین:

  •  کدِ HTML با لا را در فایلی به نامِ angular2_metadata.html در پوشه ی ریشه ی سرور، ذخیره کنین.
  •  این فایلِ HTML را با http://localhost/angular2_metadata.html باز کنین تا خروجی را بصورت زیر ببینین.
در صورتی که سوال و یا نظری دارید، از بخش نظرات با ما در میان بگذارید.

خبـرنــامه

Newsletters

در خبــرنـامه سافت اسکیل عضو شویــد تا جدیدترین هـای سایت را بلافاصله در ایمیل خـود دریافت کنیـد

شما چه نظر و یا سوالی درباره این نوشته دارید؟

مبحث آموزشی

آموزش Angular 2

Learn Angular 2

پرســیدن سؤال جدید

سؤال های تخصصی خود را از ما بپرسید

دنبال کردن تلگرام کانال سافت اسکیل

https://telegram.me/softskill_ir

عملیات کاربران

خبـرنــامه

Newsletters

در خبــرنـامه سافت اسکیل عضو شویــد تا جدیدترین هـای سایت را بلافاصله در ایمیل خـود دریافت کنیـد

کلیک کنید و سوالات خود را از ما بپرسید
لطفا فرم سوال را پر کنید

سوال شما با موفقیت ثبت شد. برای اینکه بتوانیم به شما اطلاع رسانی کنیم، موارد زیر را وارد کنید:

لطفا چند لحظه منتظر بمانید ...