React
React 19+ toetab kohandatud elemente esmaklassiliselt. React 18 ja varasemad edastavad ainult stringi atribuute — turvalisuse tagamiseks eri versioonide vahel kasuta allolevat tüübistatud abimustrit.
@wink/elements npm pakett Paigalda ja laadi CDN pakett koos TypeScripti tüüpidega.
Paigalda
Section titled “Paigalda”npm install @wink/elementsLaadi üks kord rakenduse juures
Section titled “Laadi üks kord rakenduse juures”Kutsu load() oma tippkomponendis. See on idempotentne — ohutu kutsuda mitu korda.
import { useEffect } from 'react';import { load } from '@wink/elements';
export default function App() { useEffect(() => { load({ clientId: import.meta.env.VITE_WINK_CLIENT_ID }); }, []);
return <YourRoutes />;}Kasuta komponente JSX-is
Section titled “Kasuta komponente JSX-is”export default function HotelPage() { return ( <main> <wink-content-loader layout="HOTEL" id="YOUR_LAYOUT_ID" /> <wink-lookup /> </main> );}TypeScript — deklareeri JSX intrinsics
Section titled “TypeScript — deklareeri JSX intrinsics”React ei tunne kohandatud elementide nimesid vaikimisi. Lisa üks deklareerimisfail, et tüüpvigu vältida:
import type { WinkContentLoaderAttributes, WinkLookupAttributes, WinkSearchButtonAttributes, WinkAccountButtonAttributes, WinkItineraryButtonAttributes, WinkShoppingCartButtonAttributes, WinkAppLoaderAttributes,} from '@wink/elements';
declare module 'react' { namespace JSX { interface IntrinsicElements { 'wink-content-loader': WinkContentLoaderAttributes & React.HTMLAttributes<HTMLElement>; 'wink-lookup': WinkLookupAttributes & React.HTMLAttributes<HTMLElement>; 'wink-search-button': WinkSearchButtonAttributes & React.HTMLAttributes<HTMLElement>; 'wink-account-button': WinkAccountButtonAttributes & React.HTMLAttributes<HTMLElement>; 'wink-itinerary-button': WinkItineraryButtonAttributes & React.HTMLAttributes<HTMLElement>; 'wink-shopping-cart-button': WinkShoppingCartButtonAttributes & React.HTMLAttributes<HTMLElement>; 'wink-app-loader': WinkAppLoaderAttributes & React.HTMLAttributes<HTMLElement>; } }}Tüübistatud atribuutide edastamine (React 18 turvaline)
Section titled “Tüübistatud atribuutide edastamine (React 18 turvaline)”import type { WinkContentLoaderAttributes } from '@wink/elements';
const attrs: WinkContentLoaderAttributes = { layout: 'HOTEL', id: 'abc123', sort: 'POPULARITY',};
// Spread töötab React 19-s; React 18 puhul on kõik väärtused nagunii stringidexport default function HotelCard() { return <wink-content-loader layout={attrs.layout} id={attrs.id} sort={attrs.sort} />;}