Angular

Os componentes Wink são eles mesmos Angular Elements — eles se integram naturalmente em aplicações Angular. A única configuração necessária é informar ao compilador Angular para permitir nomes de elementos desconhecidos.

@wink/elements npm package Instale e carregue o bundle CDN com tipos TypeScript.

Instalar

npm install @wink/elements

Bootstrap — carregar CDN uma vez

Chame load() antes de bootstrapApplication (ou dentro de APP_INITIALIZER):

src/main.ts

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);

Permitir nomes de elementos customizados

Adicione CUSTOM_ELEMENTS_SCHEMA a cada componente standalone (ou módulo) que renderize tags <wink-*>:

src/portal/hotels/hotels.component.ts

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';
}

Aplicações NgModule

Para apps baseados em NgModule, adicione CUSTOM_ELEMENTS_SCHEMA ao array schemas do decorador @NgModule em vez disso.

Bind de atributos

A sintaxe de template do Angular funciona diretamente com atributos string de elementos customizados:

<!-- Estático -->
<wink-content-loader layout="HOTEL" id="abc123" />

<!-- Bind dinâmico -->
<wink-content-loader [attr.layout]="layout" [attr.id]="layoutId" />

Use o bind [attr.name] quando o valor for dinâmico — o bind regular [property] do Angular mira propriedades do DOM, não atributos HTML, dos quais os elementos customizados dependem.

Variáveis de ambiente

Para projetos @angular/cli 16+, use environment.ts ou o prefixo NG_APP_* com @ngx-env/builder:

src/environments/environment.ts

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

src/main.ts

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

Tipos TypeScript

O pacote @wink/elements exporta interfaces tipadas para todos os atributos dos componentes:

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

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

Leitura adicional

• Referência de Web Components
• @wink/elements npm package