Next.js
Komponen Wink adalah elemen khusus hanya untuk pelayar — skrip CDN mesti dimuatkan di sisi klien. Corak di bawah merangkumi kedua-dua App Router (Next.js 13+) dan Pages Router warisan.
@wink/elements npm package Pasang dan muatkan bundel CDN dengan jenis TypeScript.
Pasang
Section titled “Pasang”npm install @wink/elementsApp Router (Next.js 13+)
Section titled “App Router (Next.js 13+)”Cipta komponen klien yang memanggil load() sekali dan render di dalam susun atur akar anda:
'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> );}Gunakan komponen Wink dalam mana-mana Client Component:
'use client';
export default function HotelsPage() { return ( <main> <wink-content-loader layout="HOTEL" id="YOUR_LAYOUT_ID" /> </main> );}Pages Router
Section titled “Pages Router”Muatkan sekali dalam _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} />;}Kemudian gunakan komponen Wink dalam mana-mana halaman:
export default function HotelsPage() { return <wink-content-loader layout="HOTEL" id="YOUR_LAYOUT_ID" />;}Pembolehubah persekitaran
Section titled “Pembolehubah persekitaran”Tambah ke .env.local:
NEXT_PUBLIC_WINK_CLIENT_ID=your-client-idAwalan NEXT_PUBLIC_ diperlukan untuk mendedahkan pembolehubah kepada bundel pelayar.
Jenis TypeScript
Section titled “Jenis TypeScript”Tambah fail deklarasi supaya TypeScript mengenali nama elemen khusus dalam JSX — lihat halaman integrasi React untuk petikan penuh wink-elements.d.ts.