Next.js

Wink 元件是僅限瀏覽器的自訂元素 — CDN 腳本必須在客戶端載入。以下範例涵蓋 App Router（Next.js 13+）和舊版 Pages Router。

@wink/elements npm package 安裝並載入帶有 TypeScript 型別的 CDN 套件。

安裝

npm install @wink/elements

App Router (Next.js 13+)

建立一個客戶端元件，呼叫一次 load()，並在根佈局中渲染它：

'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="en">
      <body>
        <WinkLoader />
        {children}
      </body>
    </html>
  );
}

在任何 Client Component 中使用 Wink 元件：

'use client';

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

Pages Router

在 _app.tsx 中載入一次：

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

然後在任何頁面中使用 Wink 元件：

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

環境變數

加入 .env.local：

NEXT_PUBLIC_WINK_CLIENT_ID=your-client-id

NEXT_PUBLIC_ 前綴是必須的，以便將變數暴露給瀏覽器套件。

TypeScript 型別

新增宣告檔案，讓 TypeScript 能識別 JSX 中的自訂元素名稱 — 請參考 React integration 頁面取得完整的 wink-elements.d.ts 範例。