Qwik

Le modèle de résumabilité de Qwik signifie que le JavaScript s’exécute paresseusement — uniquement lorsque l’utilisateur interagit. Utilisez useVisibleTask$ pour exécuter du code qui doit s’exécuter dans le navigateur lorsque le composant devient visible.

@wink/elements npm package Installez et chargez le bundle CDN avec les types TypeScript.

Installation

npm install @wink/elements

Chargement avec useVisibleTask$

useVisibleTask$ est le hook du cycle de vie de Qwik pour le code exécuté uniquement dans le navigateur, de manière anticipée. Placez-le dans votre layout racine :

import { component$, useVisibleTask$ } from '@builder.io/qwik';
import { load } from '@wink/elements';

export default component$(() => {
  useVisibleTask$(() => {
    load({ clientId: import.meta.env.PUBLIC_WINK_CLIENT_ID });
  });

  return (
    <main>
      <Slot />
    </main>
  );
});

Par défaut, useVisibleTask$ s’exécute lorsque le composant est visible dans la fenêtre d’affichage. Pour un layout racine toujours visible, cela se déclenche immédiatement au chargement de la page — équivalent à onMount dans d’autres frameworks.

Passez { strategy: 'document-ready' } si vous souhaitez que le script se charge le plus tôt possible :

useVisibleTask$({ strategy: 'document-ready' }, () => {
  load({ clientId: import.meta.env.PUBLIC_WINK_CLIENT_ID });
});

Utilisation sur une page

import { component$ } from '@builder.io/qwik';

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

TypeScript — déclarer les intrinsics JSX

Qwik utilise son propre namespace JSX. Étendez-le dans un fichier de déclaration :

import type {
  WinkContentLoaderAttributes,
  WinkLookupAttributes,
  WinkSearchButtonAttributes,
  WinkAccountButtonAttributes,
  WinkItineraryButtonAttributes,
  WinkShoppingCartButtonAttributes,
  WinkAppLoaderAttributes,
} from '@wink/elements';

declare module '@builder.io/qwik' {
  namespace JSX {
    interface IntrinsicElements {
      'wink-content-loader': WinkContentLoaderAttributes;
      'wink-lookup': WinkLookupAttributes;
      'wink-search-button': WinkSearchButtonAttributes;
      'wink-account-button': WinkAccountButtonAttributes;
      'wink-itinerary-button': WinkItineraryButtonAttributes;
      'wink-shopping-cart-button': WinkShoppingCartButtonAttributes;
      'wink-app-loader': WinkAppLoaderAttributes;
    }
  }
}

Variables d’environnement

Qwik (basé sur Vite) expose les variables préfixées par PUBLIC_ au navigateur :

PUBLIC_WINK_CLIENT_ID=your-client-id