Angular

Wink bileşenleri kendileri Angular Elements’tir — Angular uygulamalarına doğal olarak entegre olurlar. Gerekli tek ayar, Angular derleyicisine bilinmeyen element isimlerine izin vermesini söylemektir.

@wink/elements npm paketi TypeScript tipleriyle CDN paketini yükleyin ve kurun.

Kurulum

npm install @wink/elements

Bootstrap — CDN’i bir kez yükleyin

bootstrapApplication çağrılmadan önce (veya APP_INITIALIZER içinde) load() fonksiyonunu çağırın:

import { bootstrapApplication } from '@angular/platform-browser';
import { AppComponent } from './portal/app.component';
import { load } from '@wink/elements';

load({ clientId: import.meta.env['NG_APP_WINK_CLIENT_ID'] });

bootstrapApplication(AppComponent).catch(console.error);

Özel element isimlerine izin verin

<wink-*> etiketlerini render eden her bağımsız bileşene (veya modüle) CUSTOM_ELEMENTS_SCHEMA ekleyin:

import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';

@Component({
  selector: 'app-hotels',
  standalone: true,
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <wink-content-loader layout="HOTEL" [id]="layoutId" />
    <wink-lookup />
  `,
})
export class HotelsComponent {
  layoutId = 'YOUR_LAYOUT_ID';
}

Öznitelik bağlama

Angular şablon sözdizimi, özel elementlerin string öznitelikleriyle doğrudan çalışır:

<!-- Statik -->
<wink-content-loader layout="HOTEL" id="abc123" />

<!-- Dinamik bağlama -->
<wink-content-loader [attr.layout]="layout" [attr.id]="layoutId" />

Değer dinamik olduğunda [attr.name] bağlamasını kullanın — Angular’ın normal [property] bağlaması DOM özelliklerine yöneliktir, HTML özniteliklerine değil; özel elementler ise HTML özniteliklerine dayanır.

Ortam değişkenleri

@angular/cli 16+ projeleri için environment.ts veya NG_APP_* önekini @ngx-env/builder ile kullanın:

export const environment = {
  winkClientId: 'YOUR_CLIENT_ID',
};

import { environment } from './environments/environment';
load({ clientId: environment.winkClientId });

TypeScript tipleri

@wink/elements paketi, tüm bileşen öznitelikleri için tipli arayüzler dışa aktarır:

import type { WinkContentLoaderAttributes, WinkLayout } from '@wink/elements';

const attrs: WinkContentLoaderAttributes = {
  layout: 'HOTEL' as WinkLayout,
  id: 'abc123',
};