Next.js

Wink-Komponenten sind browserexklusive Custom Elements — CDN-Skripte müssen clientseitig geladen werden. Die folgenden Muster decken sowohl den App Router (Next.js 13+) als auch den Legacy-Pages Router ab.

@wink/elements npm package Installieren und laden Sie das CDN-Bundle mit TypeScript-Typen.

Installation

npm install @wink/elements

App Router (Next.js 13+)

Erstellen Sie eine Client-Komponente, die load() einmal aufruft, und rendern Sie sie in Ihrem Root-Layout:

'use client';
import { useEffect } from 'react';
import { load } from '@wink/elements';

export function WinkLoader() {
  useEffect(() => {
    load({ clientId: process.env.NEXT_PUBLIC_WINK_CLIENT_ID! });
  }, []);
  return null;
}

import { WinkLoader } from '@/components/WinkLoader';

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="de">
      <body>
        <WinkLoader />
        {children}
      </body>
    </html>
  );
}

Verwenden Sie Wink-Komponenten in jeder Client-Komponente:

'use client';

export default function HotelsPage() {
  return (
    <main>
      <wink-content-loader layout="HOTEL" id="YOUR_LAYOUT_ID" />
    </main>
  );
}

Pages Router

Einmalig in _app.tsx laden:

import type { AppProps } from 'next/app';
import { useEffect } from 'react';
import { load } from '@wink/elements';

export default function App({ Component, pageProps }: AppProps) {
  useEffect(() => {
    load({ clientId: process.env.NEXT_PUBLIC_WINK_CLIENT_ID! });
  }, []);
  return <Component {...pageProps} />;
}

Dann Wink-Komponenten auf jeder Seite verwenden:

export default function HotelsPage() {
  return <wink-content-loader layout="HOTEL" id="YOUR_LAYOUT_ID" />;
}

Umgebungsvariablen

Fügen Sie .env.local hinzu:

NEXT_PUBLIC_WINK_CLIENT_ID=your-client-id

Das Präfix NEXT_PUBLIC_ ist erforderlich, um die Variable im Browser-Bundle verfügbar zu machen.

TypeScript-Typen

Fügen Sie eine Deklarationsdatei hinzu, damit TypeScript die Custom Element-Namen in JSX erkennt — siehe die React-Integrationsseite für den vollständigen wink-elements.d.ts-Ausschnitt.